Marlon
Marlon•2mo ago

Edit Transcript Name via API

When I trigger my Outbound Call Agent via an api call, the transcript gets stored as the users phone number. Is there a way to store it as something else? (ie their name)
No description
1 Reply
Tico | Voiceflow Assistant
Tico | Voiceflow Assistant•2mo ago
At the moment the /v1alpha1/phone-number/.../outbound endpoint has no field you can pass to override how the transcript is titled – Voiceflow will automatically label the new transcript with the number you supplied in "to". The only way to rename it today is with a follow-up call to the Transcripts API: 1. Wait until the call finishes (or poll) and fetch the transcript you just created 
GET  https://api.voiceflow.com/v2/transcripts/{PROJECT_ID}?sessionID=%2B15551234567
Authorization: Bearer <DM-API-KEY>
GET  https://api.voiceflow.com/v2/transcripts/{PROJECT_ID}?sessionID=%2B15551234567
Authorization: Bearer <DM-API-KEY>
The response will give you the transcriptID. 2. Patch the record and set the user.name (or any other metadata you need): 
PATCH https://api.voiceflow.com/v2/transcripts/{PROJECT_ID}/{TRANSCRIPT_ID}
Authorization: Bearer <DM-API-KEY>
Content-Type: application/json

{
  "data": {
    "user": {
      "name": "Jane Doe",
      "image": "https://…/avatar.png"   // optional
    }
  }
}
PATCH https://api.voiceflow.com/v2/transcripts/{PROJECT_ID}/{TRANSCRIPT_ID}
Authorization: Bearer <DM-API-KEY>
Content-Type: application/json

{
  "data": {
    "user": {
      "name": "Jane Doe",
      "image": "https://…/avatar.png"   // optional
    }
  }
}
That immediately updates the label you see in the Transcripts tab. At this time there is no way to set the name inline with the outbound-call request itself, so the above two-step approach (fetch → patch) is required if you want something other than the phone number to appear. Docs for reference: • Outbound Call API – https://docs.voiceflow.com/reference/outbound-calls • Update Transcript – https://developer.voiceflow.com/v2.0/reference/patch_transcripts

Did you find this page helpful?