Skip to content

Document speaker names on call transcript turns - #675

Open
AAnkudovich wants to merge 1 commit into
mainfrom
AAnkudovich/call-transcript-speaker-names
Open

AAnkudovich wants to merge 1 commit into
mainfrom
AAnkudovich/call-transcript-speaker-names

Conversation

@AAnkudovich

Copy link
Copy Markdown
Contributor

Why?

Call transcript turns now carry an optional speaker name, so readers can tell who was talking instead of decoding labels like Teammate 1 and User. While documenting that, I found the transcript endpoint described as a plain-text file download — it has always returned JSON, so the reference was simply wrong.

How?

Adds a shared schema for a transcript turn, used by both endpoints that return transcripts, and corrects the documented response type on the transcript endpoint.

Notes for reviewers

The name is optional on purpose. It is left out when the speaker cannot be resolved or has no name — a contact whose record was scrambled by a deletion request is the main case — so the description tells clients to fall back to the diarization label.

Only the documented response type changes for the transcript endpoint; the endpoint's actual behaviour is unchanged and always returned a JSON array.

Generated with Claude Code

Adds the optional speaker_name field to transcript turns and corrects the
call transcript response type, which has always been a JSON array rather
than a plain-text attachment.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

This branch has not been deployed

No deployments
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.

1 participant