equal-aqua•3mo ago
Creating a new transcript for each call
I'm having trouble understanding how to create a new transcript for each call from start to finish. Currently, all calls are being saved into one long transcript, with only "new session started" messages separating them.
What I need is for each call to generate its own separate transcript record. Could you please provide instructions on how to set this up correctly?
1 Reply
Why all calls are ending up in the same transcript
Voiceflow groups every turn that shares the same
• Create a random UUID or use the call/connection ID you get from your telephony provider.
• Use this value as the
2. Use the same value for the Transcripts API (if you are saving transcripts yourself)
• When the call finishes, call
✔️ Keep it constant only for the lifetime of that call
✔️ Save (or let the web-chat auto-save) the transcript with that same ID After switching to unique IDs you’ll see each call appear in the Transcripts tab as its own record instead of one long thread. Docs for reference:
• Transcripts: https://docs.voiceflow.com/docs/transcripts
•
• DM API userID/session guidance: https://developer.voiceflow.com/v2.0/docs/dialog-manager-api-overview
sessionID / userID into a single transcript. In your logs the line that says “new session started” only marks a new turn inside that same session – it does not create a brand-new transcript record.
If you always pass the same ID (for example the caller’s phone number) to the Dialog Manager API, Voiceflow will keep stitching every call from that phone number onto a single, never-ending transcript.
---
How to force a new transcript for every call
1. Generate a fresh, unique ID at the start of every call• Create a random UUID or use the call/connection ID you get from your telephony provider.
• Use this value as the
userID when you hit the DM /state/user/{userID}/interact endpoint.2. Use the same value for the Transcripts API (if you are saving transcripts yourself)
• When the call finishes, call
PUT /v2/transcripts and pass that same ID in the sessionID field. Voiceflow recognises that combination of projectID + sessionID as one conversation and stores it as a new transcript row.
3. Do not recycle IDs between calls – once the caller hangs up, discard the ID. The next call should start with a brand-new one.
That’s it: each new ID → one clean conversation state → one transcript.
---
One-line check-list
✔️ Generate new userID / sessionID per call✔️ Keep it constant only for the lifetime of that call
✔️ Save (or let the web-chat auto-save) the transcript with that same ID After switching to unique IDs you’ll see each call appear in the Transcripts tab as its own record instead of one long thread. Docs for reference:
• Transcripts: https://docs.voiceflow.com/docs/transcripts
•
PUT /transcripts endpoint: https://developer.voiceflow.com/v2.0/reference/put_transcripts• DM API userID/session guidance: https://developer.voiceflow.com/v2.0/docs/dialog-manager-api-overview