Skip to content

docs: add guide for email address reading in voice agents#1024

Merged
adhamvapi merged 2 commits intomainfrom
tasker/DEVREL-621-email-address-reading-docs
Apr 21, 2026
Merged

docs: add guide for email address reading in voice agents#1024
adhamvapi merged 2 commits intomainfrom
tasker/DEVREL-621-email-address-reading-docs

Conversation

@adhamvapi
Copy link
Copy Markdown
Contributor

Description

  • Add new documentation page fern/assistants/email-address-reading.mdx that explains how to configure AI voice agents to collect, read back, and confirm email addresses clearly
  • Add navigation entry in docs.yml under Assistants > Conversation behavior (after "Pronunciation dictionaries")
  • Reference Vapi's built-in formatEmails voice formatting step that already handles TTS-level character replacement
  • Provide multiple copy-pasteable system prompt snippets for: collecting emails, confirming/reading back emails, letter-by-letter spelling, and handling common domains
  • Include a complete production-ready example prompt for an appointment booking agent
  • Cover complementary features: pronunciation dictionaries for domain names, custom keywords for transcription accuracy
  • Add best practices and common issues sections using AccordionGroup components

Resolves DEVREL-621

Testing Steps

  • Run the app locally using fern docs dev or navigate to preview deployment
  • Ensure that the changed pages and code snippets work
  • Verify the new page appears in sidebar under Assistants > Conversation behavior > Email address reading
  • Verify all internal links work: voice formatting plan, pronunciation dictionaries, custom keywords, prompting guide
  • fern check passes with 0 errors (5 pre-existing warnings unrelated to this change)

Adds a comprehensive guide covering how to configure voice agents to
collect, read back, and confirm email addresses clearly. Includes
copy-pasteable system prompt examples, references to Vapi's built-in
formatEmails voice formatter, and best practices for the full
collection-and-confirmation conversation flow.

Resolves DEVREL-621.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown
Contributor

Expand the email address reading guide with a technical API
configuration section covering:
- Full 14-step voice formatting pipeline table showing where
  formatEmails (step 8) fits
- FormatPlan TypeScript type definition
- Code examples (JSON, TypeScript SDK, Python SDK) for enabling
  specific formatters, disabling email formatting selectively,
  and disabling all formatting
- Note on formattersEnabled introduction date (2025-02-20)
- Updated overview to describe three solution layers (built-in
  formatting, API configuration, prompt engineering)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown
Contributor

@adhamvapi adhamvapi merged commit c673640 into main Apr 21, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant