trxgames
12/15/2025, 12:54 AMAI Evy
12/15/2025, 12:54 AMAI Evy
12/15/2025, 12:54 AMversion query parameter: [(2) ]()
version
integer
Optional version of the API to use for this request. Default to latest version.
You can also retrieve all versions of your agent using the Get Agent Versions endpoint to identify which version to target. [(3) ]()AI Evy
12/15/2025, 12:54 AMAI Evy
12/15/2025, 12:54 AMtrxgames
12/15/2025, 1:22 AMAI Evy
12/15/2025, 1:22 AMAI Evy
12/15/2025, 1:23 AMcall_analyzed event:
Step 1: Set the Webhook URL
You have two options for registering your webhook: [(1) ]()
- Account level webhook — Set up through the system settings' webhooks tab for events related to any agent under your account
- Agent level webhook — Set up through the dashboard's agent detail page (note: if set, account level webhooks will not be triggered for that agent)
You can also set the webhook URL via API using the webhook_url parameter when creating or updating an agent: [(2) ]() , [(3) ]()
javascript
webhook_url: "<https://xxxx-xxxx.ngrok-free.app/webhook%22>
[(2) ]()
Step 2: Receiving the call_analyzed Event
Once your webhook is registered, Retell automatically sends events including call_analyzed to your endpoint. Your server should handle it like this: [(1) ]()
javascript
app.post("/webhook", (req: Request, res: Response) => {
const {event, call} = req.body;
switch (event) {
case "call_started":
console.log("Call started event received", call.call_id) ;
break;
case "call_ended":
console.log("Call ended event received", call.call_id) ;
break;
case "call_analyzed":
console.log("Call analyzed event received", call.call_id) ;
break;
default:
console.log("Received an unknown event:", event) ;
}
// Acknowledge the receipt of the event
res.status(204) .send() ;
}) ;AI Evy
12/15/2025, 1:23 AMtrxgames
12/15/2025, 1:23 AMAI Evy
12/15/2025, 1:23 AMtrxgames
12/15/2025, 1:44 AMAI Evy
12/15/2025, 1:44 AMAI Evy
12/15/2025, 1:44 AMAI Evy
12/15/2025, 1:44 AMAI Evy
12/15/2025, 1:44 AMtranscript — Full transcription of the call as a string
- transcript_object — Transcript as a list of utterances with timestamps and word-level details
Example response fields:
json
"transcript": "Agent: hi how are you doing?\nUser: Doing pretty well. How are you?\nAgent: That's great to hear!...",
"transcript_object": [
{
"role": "agent",
"content": "hi how are you doing?",
"words": [
{
"word": "hi",
"start": 0.7,
"end": 1.3
}
]
}
]
To retrieve the full transcript:
javascript
import Retell from 'retell-sdk';
const client = new Retell({
apiKey: 'YOUR_RETELL_API_KEY',
}) ;
const callResponse = await client.call.retrieve('YOUR_CALL_ID') ;
console.log(callResponse.transcript) ;
console.log(callResponse.transcript_object) ;
You can also access the recording_url field to download the full call recording.trxgames
12/15/2025, 3:51 AMAI Evy
12/15/2025, 3:51 AMAI Evy
12/15/2025, 3:51 AMcall_analyzed for Full Data
For lead capture, use the call_analyzed event—it includes the call_analysis object with call summary, sentiment, and any custom analysis data you've configured.
Step 4: In Make
1. Create a Webhook trigger module to receive the Retell payload
2. Filter for call_analyzed events (or call_ended if you don't need analysis)
3. Map the fields (from_number, transcript, call_analysis, etc.) to your Airtable columns
4. Use an Airtable - Create Record module to insert the lead
Key fields for lead capture: from_number (caller's phone) , transcript, call_analysis.call_summary, and any custom_analysis_data you've defined. , [(2) ]()
---
I don't have specific Make.com step-by-step instructions in the sources. For Make-specific configuration, refer to Make's documentation on webhook triggers and Airtable modules.AI Evy
12/15/2025, 3:51 AMAI Evy
12/15/2025, 3:51 AMcall_started | Triggered when a new call begins |
| call_ended | Triggered when a call completes, transfers, or encounters an error |
| call_analyzed | Triggered when call analysis is complete (includes full transcript and analysis) |
Step 2: Webhook Payload
The webhook will POST a payload to your Make endpoint containing the event type and call object:
json
{
"event": "call_ended",
"call": {
"call_type": "phone_call",
"from_number": "+12137771234",
"to_number": "+12137771235",
"direction": "inbound",
"call_id": "Jabr9TXYYJHfvl6Syypi88rdAHYHmcq6",
"agent_id": "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD",
"call_status": "registered",
"metadata": {},
"retell_llm_dynamic_variables": {
"customer_name": "John Doe"
},
"start_timestamp": 1714608475945,
"end_timestamp": 1714608491736,
"disconnection_reason": "user_hangup",
"transcript": "..."
}
}AI Evy
12/15/2025, 3:51 AMtrxgames
12/16/2025, 3:23 PMAI Evy
12/16/2025, 3:23 PMAI Evy
12/16/2025, 3:24 PMAI Evy
12/16/2025, 3:24 PMAI Evy
12/16/2025, 3:24 PM