Skip to content

docs(web): document assistant.speechStarted live caption usage#1030

Merged
dhruva-reddy merged 1 commit intomainfrom
dr/docs-sdk-web-assistant-speech-started
Apr 22, 2026
Merged

docs(web): document assistant.speechStarted live caption usage#1030
dhruva-reddy merged 1 commit intomainfrom
dr/docs-sdk-web-assistant-speech-started

Conversation

@dhruva-reddy
Copy link
Copy Markdown
Contributor

@dhruva-reddy dhruva-reddy commented Apr 22, 2026

Description

  • Adds a new ### Live captions and word-level timing section to fern/quickstart/web.mdx, slotted between the Web SDK installation tabs and ### Voice widget implementation so it's discoverable in the natural client-side flow.
  • Originally targeted fern/sdk/web.mdx, but that page is redirected away (/sdk/web → /quickstart/web per docs.yml line 1058) and is effectively orphaned. Moved the content to the canonical destination so customers can actually find it.
  • Shows how to opt in via clientMessages and consume the event in a vapi.on("message", ...) handler with concrete code that branches on timing?.type.
  • Includes a <Warning> callout explaining the cadence/granularity differences between providers so customers don't pick the wrong one for their UI:
    • ElevenLabs (word-alignment) — true per-word playback cadence
    • Minimax (word-progress) — segment-sized jumps near segment end
    • All others — text-only events tied to audio playback
  • Notes that force-say always emits text-only and that barge-in stops emission for the interrupted turn.
  • Cross-links to the new Minimax provider page and the canonical Server events → Assistant Speech Started reference.
  • Stacked on PR #1028 (adds the events anchor) and PR #1029 (adds the Minimax page) — the cross-references in this PR resolve once the stack is merged.

Testing Steps

  • Verified /sdk/web redirects to /quickstart/web per docs.yml redirect rule, confirming the original target page was not user-reachable
  • Verified both cross-reference links target paths/anchors created in the downstack PRs
  • Verified the new <Warning> block uses the same component pattern as existing warnings on this page
  • Reviewer: spot-check the Fern preview build to confirm the new section renders correctly between "Installation and setup" and "Voice widget implementation"

Copy link
Copy Markdown
Contributor Author

dhruva-reddy commented Apr 22, 2026

@github-actions
Copy link
Copy Markdown
Contributor

@dhruva-reddy dhruva-reddy force-pushed the dr/docs-sdk-web-assistant-speech-started branch from e254dd0 to e55a4f5 Compare April 22, 2026 22:00
@dhruva-reddy dhruva-reddy changed the title docs(sdk-web): document assistant.speechStarted live caption usage docs(web): document assistant.speechStarted live caption usage Apr 22, 2026
@github-actions
Copy link
Copy Markdown
Contributor

@dhruva-reddy dhruva-reddy force-pushed the dr/docs-providers-minimax branch from 5470773 to e91e0fc Compare April 22, 2026 22:34
@dhruva-reddy dhruva-reddy force-pushed the dr/docs-sdk-web-assistant-speech-started branch from e55a4f5 to 5205875 Compare April 22, 2026 22:35
@dhruva-reddy dhruva-reddy changed the base branch from dr/docs-providers-minimax to graphite-base/1030 April 22, 2026 22:37
@dhruva-reddy dhruva-reddy force-pushed the dr/docs-sdk-web-assistant-speech-started branch from 5205875 to 5b679b5 Compare April 22, 2026 22:37
@graphite-app graphite-app Bot changed the base branch from graphite-base/1030 to main April 22, 2026 22:37
@dhruva-reddy dhruva-reddy merged commit bfbea96 into main Apr 22, 2026
11 of 13 checks passed
Copy link
Copy Markdown
Contributor Author

Merge activity

@github-actions
Copy link
Copy Markdown
Contributor

@github-actions
Copy link
Copy Markdown
Contributor

@github-actions
Copy link
Copy Markdown
Contributor

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants