Open in
telephony.complete / web.complete
ਕਾਲ ਸਮਾਪਤ ਹੋਣ
ਹਰ ਕਾਲ ਸਮਾਪਤ ਹੋਣ ਤੋਂ ਬਾਅਦ ਇੱਕ completion ਇਵੈਂਟ ਟ੍ਰਿਗਰ ਹੁੰਦਾ ਹੈ — ਇਨਬਾਊਂਡ ਟੈਲੀਫੋਨੀ, ਆਉਟਬਾਊਂਡ ਟੈਲੀਫੋਨੀ, ਵੈੱਬ ਕਾਲ, ਜਾਂ ਟੈਸਟ ਕਾਲ (ਬਿਲਡਰ ਮਾਈਕ ਸੈਸ਼ਨ)। ਇਹ ਨਾਨ-ਬਲਾਕਿੰਗ ਹੈ: ਕਿਸੇ ਵੀ 2xx ਨਾਲ ਜਵਾਬ ਦਿਓ।
ਇਵੈਂਟ ਦੋਵਾਂ ਮਾਰਗਾਂ ਰਾਹੀਂ ਡਿਲਿਵਰ ਕੀਤਾ ਜਾਂਦਾ ਹੈ:
- Webhook ਐਂਡਪੌਇੰਟ ਨੂੰ
telephony.complete(ਫੋਨ ਕਾਲਾਂ) ਜਾਂweb.complete(ਵੈੱਬ ਕਾਲਾਂ ਅਤੇ ਬਿਲਡਰ ਮਾਈਕ ਟੈਸਟ ਕਾਲਾਂ) ਹੇਠਾਂ ਦਰਜ ਸਥਿਰ payload ਦੇ ਨਾਲ, ਹਰੇਕ ਡਿਲਿਵਰੀ ਲਈ ਇੱਕevent_id, 30 ਸਕਿੰਟ ਦਾ timeout, ਅਤੇ 24 ਘੰਟਿਆਂ ਤੱਕ ਦੀਆਂ ਮੁੜ ਕੋਸ਼ਿਸ਼ਾਂ ਪ੍ਰਾਪਤ ਹੁੰਦੀਆਂ ਹਨ। - ਪੁਰਾਣਾ ਸਿੰਗਲ-URL webhook ਨੂੰ ਇੱਕ ਸਮਕਾਲੀ ਕੋਸ਼ਿਸ਼ (10 ਸਕਿੰਟ timeout, ਕੋਈ ਮੁੜ ਕੋਸ਼ਿਸ਼ ਨਹੀਂ) ਕੁਝ ਵੱਖਰੇ payload ਨਾਲ ਪ੍ਰਾਪਤ ਹੁੰਦੀ ਹੈ — ਵੇਖੋ ਪੁਰਾਣੇ payload ਦੇ ਫਰਕ।
ਬੇਨਤੀ ਪੇਲੋਡ (ਐਂਡਪੌਇੰਟ ਡਿਲਿਵਰੀਆਂ)
{
"data": {
"billable_minutes": 1.25,
"billing_total_cents": 8,
"call_id": 987654321,
"direction": "inbound",
"duration_seconds": 54,
"end_reason": "user_hangup",
"end_time": "2026-04-20T18:25:04.822Z",
"extracted_data": {
"status": "completed",
"fields": {
"customer_name": "Alex Morgan",
"appointment_date": "2026-04-23"
},
"evidence": {
"customer_name": {
"quote": "My name is Alex Morgan",
"speaker_role": "caller",
"turn_index": 4
},
"appointment_date": {
"quote": "April 23 works for me",
"speaker_role": "caller",
"turn_index": 7
}
},
"verification": "verified",
"field_reasons": {},
"schema_version": "92850758e231a3c95a..."
},
"from_number": "+14155550199",
"product": "spark",
"recording_stopped_at": null,
"recording_stopped_reason": null,
"recording_url": "https://storage.example.com/…",
"start_time": "2026-04-20T18:24:10.113Z",
"status": "completed",
"summary": "Alex Morgan called to book a follow-up visit and confirmed Thursday, April 23. The agent read the appointment back and Alex asked for a reminder text the day before.",
"to_number": "+15551234567",
"transcripts": [ /* see Transcript format */ ],
"transfer_number": null,
"unresolved_variables": ["campaign_owner"],
"variables": {"campaign_name": "Spring renewals"},
"voice": "john"
},
"event_id": "6a7b8c9d-0e1f-4a2b-8c3d-4e5f6a7b8c9d",
"type": "telephony.complete"
}| ਫੀਲਡ | ਕਿਸਮ | ਵੇਰਵਾ |
|---|---|---|
call_id | ਪੂਰਨ ਅੰਕ | ਇਸ ਕਾਲ ਲਈ ਹਰ ਇਵੈਂਟ ਵਿੱਚ ਸਥਿਰ ਰਹਿੰਦਾ ਹੈ |
agent_id | ਪੂਰਨ ਅੰਕ | ਨਲ | ਕਾਲ ਸੰਭਾਲਣ ਵਾਲਾ ਏਜੰਟ, ਜਦੋਂ ਕੋਈ ਨਿਰਧਾਰਤ ਕੀਤਾ ਗਿਆ ਹੋਵੇ |
agent_name | ਸਟਰਿੰਗ | ਨਲ | ਕਾਲ ਸੰਭਾਲਣ ਵਾਲਾ ਏਜੰਟ, ਜਦੋਂ ਕੋਈ ਨਿਰਧਾਰਤ ਕੀਤਾ ਗਿਆ ਹੋਵੇ |
direction | ਸਟਰਿੰਗ | inbound, outbound, web, test। ਇਤਿਹਾਸਕ ਪੇਲੋਡਾਂ ਵਿੱਚ ਪੁਰਾਣੇ mic ਜਾਂ widget ਮੁੱਲ ਹੋ ਸਕਦੇ ਹਨ |
from_number, to_number | ਸਟਰਿੰਗ | E.164। ਵੈੱਬ ਕਾਲਾਂ ਅਤੇ ਟੈਸਟ ਕਾਲਾਂ ਲਈ from_number ਦਾ ਸ਼ਾਬਦਿਕ ਮੁੱਲ "web" ਹੁੰਦਾ ਹੈ |
origin_domain | ਸਟਰਿੰਗ | ਸਿਰਫ਼ ਵੈੱਬ/ਟੈਸਟ ਲਈ — ਉਹ ਪੰਨਾ ਸਰੋਤ ਜਿਸ ਨੇ ਵਿਜਿਟ ਹੋਸਟ ਕੀਤਾ ਸੀ (ਮਾਈਕ ਸੈਸ਼ਨਾਂ ਲਈ ਖਾਲੀ) |
start_time, end_time | ਟਾਈਮਸਟੈਂਪ | ISO 8601 UTC |
duration_seconds | ਪੂਰਨ ਅੰਕ | ਨਲ | ਸ਼ੁਰੂਆਤ/ਅੰਤ ਤੋਂ ਲਿਆ ਗਿਆ |
status | ਸਟਰਿੰਗ | completed ਜਾਂ failed |
end_reason | ਸਟਰਿੰਗ | ਹੇਠਾਂ ਦਿੱਤੀ ਸਾਰਣੀ ਵੇਖੋ |
answered_by | ਸਟਰਿੰਗ | ਨਲ | ਸਿਰਫ਼ ਆਊਟਬਾਊਂਡ ਫ਼ੋਨ ਕਾਲਾਂ ਲਈ (ਹੋਰਥਾਂ ਮੌਜੂਦ ਨਹੀਂ): ਕਿਸ ਨੇ ਜਵਾਬ ਦਿੱਤਾ, human, voicemail, screener (ਕਾਲ ਸਕ੍ਰੀਨਿੰਗ ਸਹਾਇਕ), ivr (ਫ਼ੋਨ ਮੀਨੂ) ਜਾਂ unknown। ਜਦੋਂ ਕਿਸੇ ਨੇ ਜਵਾਬ ਨਾ ਦਿੱਤਾ ਹੋਵੇ ਤਾਂ null, ਅਤੇ ਜਿਸ ਪਲੇਟਫ਼ਾਰਮ ਤੋਂ ਤੁਸੀਂ ਤਬਦੀਲੀ ਕਰ ਰਹੇ ਹੋ ਉਸ ਦੁਆਰਾ ਸੰਭਾਲੀਆਂ ਆਊਟਬਾਊਂਡ ਕਾਲਾਂ ਲਈ migration.call.complete ਇਵੈਂਟਾਂ ਵਿੱਚ ਹਮੇਸ਼ਾ null। ਕਾਲ ਆਬਜੈਕਟ ਵਰਗੇ ਹੀ ਮੁੱਲ |
product, voice | ਸਟਰਿੰਗ | ਕਾਲ ਦੇ ਸਮੇਂ ਲਾਗੂ ਏਜੰਟ ਕੌਂਫਿਗਰੇਸ਼ਨ |
variables | ਆਬਜੈਕਟ | ਕਾਲ ਸ਼ੁਰੂ ਹੋਣ ਵੇਲੇ ਲਏ ਗਏ ਇਨਪੁੱਟ ਵੇਰੀਏਬਲਾਂ ਦੇ ਸਨੈਪਸ਼ਾਟ |
unresolved_variables | ਐਰੇ | ਕਾਲ ਕੌਂਫਿਗਰੇਸ਼ਨ ਦੁਆਰਾ ਹਵਾਲਾ ਦਿੱਤੇ, ਪਰ ਕਾਲ ਸ਼ੁਰੂ ਹੋਣ ਵੇਲੇ ਨਾ ਦਿੱਤੇ ਗਏ ਵੇਰੀਏਬਲ ਨਾਮ |
transfer_number | ਸਟਰਿੰਗ | ਨਲ | ਕਾਲ ਟ੍ਰਾਂਸਫ਼ਰ ਹੋਣ 'ਤੇ ਸੈੱਟ ਹੁੰਦਾ ਹੈ |
scheduled_send_id | ਸਟਰਿੰਗ | ਸਿਰਫ਼ ਨਿਰਧਾਰਤ ਭੇਜਣ ਦੁਆਰਾ ਕੀਤੀ ਗਈ ਕਾਲ ਵਿੱਚ: ਉਸ ਭੇਜਣ ਦੀ id। ਹਰ ਹੋਰ ਕਾਲ ਵਿੱਚ ਮੌਜੂਦ ਨਹੀਂ |
recording_url | ਸਟਰਿੰਗ | ਨਲ | ਮਿਆਦ ਪੁੱਗਣ ਵਾਲਾ ਸਾਈਨ ਕੀਤਾ URL; ਤੁਰੰਤ ਡਾਊਨਲੋਡ ਕਰੋ। ਜਦੋਂ ਕੋਈ ਰਿਕਾਰਡਿੰਗ ਆਰਟੀਫੈਕਟ ਉਪਲਬਧ ਨਾ ਹੋਵੇ ਤਾਂ null |
recording_stopped_at | ਟਾਈਮਸਟੈਂਪ | ਨਲ | ਜਦੋਂ ਕਾਲ ਖਤਮ ਹੋਣ ਤੋਂ ਪਹਿਲਾਂ ਰਿਕਾਰਡਿੰਗ ਰੋਕੀ ਗਈ ਹੋਵੇ; ਇਸ ਪਲ ਤੋਂ ਬਾਅਦ ਦੀ ਕੋਈ ਵੀ ਚੀਜ਼ ਰਿਕਾਰਡਿੰਗ ਵਿੱਚ ਨਹੀਂ ਹੁੰਦੀ। ਜਦੋਂ ਰਿਕਾਰਡਿੰਗ ਕਾਲ ਦੇ ਅੰਤ ਤੱਕ ਚੱਲੀ ਹੋਵੇ ਜਾਂ ਕਾਲ ਰਿਕਾਰਡ ਨਾ ਕੀਤੀ ਗਈ ਹੋਵੇ ਤਾਂ null |
recording_stopped_reason | ਸਟਰਿੰਗ | ਨਲ | ਰਿਕਾਰਡਿੰਗ ਜਲਦੀ ਕਿਉਂ ਰੁਕੀ। warm_transfer: ਮੰਜ਼ਿਲ ਨੂੰ ਵਾਰਮ ਟ੍ਰਾਂਸਫ਼ਰ ਕਾਲ ਕਰਨ ਤੋਂ ਠੀਕ ਪਹਿਲਾਂ ਇਹ ਰੁਕ ਜਾਂਦੀ ਹੈ, ਅਤੇ ਟ੍ਰਾਂਸਫ਼ਰ ਅਸਫਲ ਹੋਣ ਤੇ ਕਾਲਰ ਦੇ ਏਜੰਟ ਕੋਲ ਵਾਪਸ ਆਉਣ ਉੱਤੇ ਵੀ ਬੰਦ ਰਹਿੰਦੀ ਹੈ। ਹੋਰ ਮੁੱਲਾਂ ਨੂੰ ਜਾਣਕਾਰੀ ਲਈ ਸਮਝੋ; ਹੋਰ ਜੋੜੇ ਜਾ ਸਕਦੇ ਹਨ। ਜਦੋਂ recording_stopped_at null ਹੋਵੇ ਤਾਂ null |
billable_minutes | ਨੰਬਰ | ਬਿਲ ਕੀਤੇ ਮਿੰਟ, ਸਭ ਤੋਂ ਨੇੜਲੇ ਚੌਥਾਈ ਮਿੰਟ ਤੱਕ ਗੋਲ ਕੀਤੇ ਗਏ (15-ਸਕਿੰਟ ਵਾਧੇ, ਘੱਟੋ-ਘੱਟ 0.25)। ਸਿੱਧੀਆਂ ਵੌਇਸਮੇਲ ਕਾਲਾਂ ਵੀ ਇੱਥੇ ਆਪਣੇ ਅਸਲ ਮੀਟਰ ਕੀਤੇ ਮਿੰਟ ਦੱਸਦੀਆਂ ਹਨ, ਪਰ ਚਾਰਜ ਯੋਜਨਾ ਦਰ 'ਤੇ ਇੱਕ ਮਿੰਟ ਤੱਕ ਸੀਮਿਤ ਹੁੰਦਾ ਹੈ। |
billing_total_cents | ਪੂਰਨ ਅੰਕ | ਨਲ | USD ਸੈਂਟ। ਜਦੋਂ billing_pending true ਹੋਵੇ ਤਾਂ null |
billing_pending | ਬੂਲੀਅਨ | ਸਿਰਫ਼ ਉਸ ਮੀਟਰ ਕੀਤੀ ਕਾਲ ਵਿੱਚ true ਵਜੋਂ ਮੌਜੂਦ ਹੁੰਦਾ ਹੈ ਜਿਸਦਾ ਚਾਰਜ ਹਾਲੇ ਨਿਪਟਿਆ ਨਹੀਂ: ਮੀਟਰ ਕੀਤੀ ਕਾਲ ਦਾ ਚਾਰਜ ਇਸਦੇ ਖਤਮ ਹੋਣ ਤੋਂ ਕੁਝ ਮਿੰਟ ਬਾਅਦ, ਇਸਦੀ ਵਰਤੋਂ ਆ ਜਾਣ ਉੱਤੇ ਲੱਗਦਾ ਹੈ, ਇਸ ਲਈ ਇੱਥੇ billable_minutes ਅਤੇ billing_total_cents null ਹੁੰਦੇ ਹਨ ਅਤੇ ਚਾਰਜ call.billed ਵਿੱਚ ਆਉਂਦਾ ਹੈ। ਹਰ ਹੋਰ ਕਾਲ ਵਿੱਚ ਮੌਜੂਦ ਨਹੀਂ |
transcripts | ਐਰੇ | ਹਰ ਵਾਰੀ ਦੀ ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ ਐਂਟਰੀ; ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ ਉਪਲਬਧ ਨਾ ਹੋਣ 'ਤੇ ਖਾਲੀ ਹੋ ਸਕਦੀ ਹੈ |
summary | ਸਟਰਿੰਗ | ਨਲ | ਸਧਾਰਨ ਭਾਸ਼ਾ ਵਿੱਚ ਕਾਲ ਤੋਂ ਬਾਅਦ ਦਾ ਸੰਖੇਪ (ਗੱਦ ਦੇ ਦੋ ਤੋਂ ਚਾਰ ਵਾਕ, ਵੱਧ ਤੋਂ ਵੱਧ 2,000 ਅੱਖਰ, ਏਜੰਟ ਦੀ summary_language ਵਿੱਚ ਲਿਖਿਆ ਗਿਆ, ਨਹੀਂ ਤਾਂ ਸੰਸਥਾ ਦੀ ਸੰਖੇਪ ਭਾਸ਼ਾ ਵਿੱਚ, ਨਹੀਂ ਤਾਂ ਕਾਲ ਦੀ ਭਾਸ਼ਾ ਵਿੱਚ: ਏਜੰਟ ਦੀ ਮੁੱਖ ਭਾਸ਼ਾ, ਜਦ ਤੱਕ ਕਾਲ ਨੇ ਇਸਨੂੰ ਓਵਰਰਾਈਡ ਨਾ ਕੀਤਾ ਹੋਵੇ) ਜਦੋਂ ਏਜੰਟ ਬਿਲਡਰ ਵਿੱਚ ਕਾਲ ਸੰਖੇਪ ਬਣਾਓ ਨੂੰ ਇਕੱਠਾ ਕਰਨ ਲਈ ਡਾਟਾ ਹੇਠ ਚਾਲੂ ਕੀਤਾ ਗਿਆ ਹੋਵੇ (ਏਜੰਟ ਉੱਤੇ call_summary_enabled) ਅਤੇ ਬਣਾਉਣਾ ਸਫਲ ਰਿਹਾ ਹੋਵੇ; ਨਹੀਂ ਤਾਂ null, ਜਿਸ ਵਿੱਚ ਸੰਖੇਪ ਕਰਨ ਲਈ ਬਹੁਤ ਛੋਟੀਆਂ ਕਾਲਾਂ, ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ ਤੋਂ ਬਿਨਾਂ ਕਾਲਾਂ, ਅਤੇ ਰਿਕਾਰਡਿੰਗ ਬੰਦ ਵਾਲੇ ਏਜੰਟ ਸ਼ਾਮਲ ਹਨ। ਸੰਖੇਪ ਐਕਸਟ੍ਰੈਕਸ਼ਨ ਵਾਲੇ ਉਸੇ ਕਾਲ-ਬਾਅਦ ਕਦਮ ਵਿੱਚ ਬਣਦਾ ਹੈ, ਇਸ ਲਈ ਕਾਲ-ਮੁਕੰਮਲ ਵੈੱਬਹੁੱਕ ਭੇਜਣ ਤੋਂ ਪਹਿਲਾਂ ਐਕਸਟ੍ਰੈਕਟ ਕੀਤਾ ਡਾਟਾ ਉਡੀਕੋ ਸੈਟਿੰਗ (extraction_blocks_completion) ਇਹ ਨਿਰਧਾਰਤ ਕਰਦੀ ਹੈ ਕਿ ਇਹ ਇਵੈਂਟ ਇਸਦੀ ਉਡੀਕ ਕਰਦਾ ਹੈ ਜਾਂ ਨਹੀਂ: ਉਡੀਕ ਮੋਡ ਵਿੱਚ, ਇਹ ਇਵੈਂਟ ਭੇਜਣ ਤੋਂ ਪਹਿਲਾਂ ਸੰਖੇਪ ਤਿਆਰ ਹੁੰਦਾ ਹੈ (ਸੰਖੇਪ ਨੂੰ ਕਦਮ ਦੇ 75-ਸਕਿੰਟ ਬਜਟ ਵਿੱਚ ਵੱਧ ਤੋਂ ਵੱਧ 30 ਸਕਿੰਟ ਮਿਲਦੇ ਹਨ); ਜਦੋਂ ਇਵੈਂਟ ਉਡੀਕ ਨਹੀਂ ਕਰਦਾ (never, ਜਾਂ except_transfers ਹੇਠ ਟ੍ਰਾਂਸਫ਼ਰ ਜਾਂ ਤੁਹਾਡੇ ਸੰਪਰਕ ਕੇਂਦਰ ਵੱਲ ਵਾਪਸੀ), ਇਹ ਫੀਲਡ null ਹੁੰਦੀ ਹੈ ਅਤੇ ਸੰਖੇਪ call.data_extracted ਵਿੱਚ ਦੁਬਾਰਾ ਨਹੀਂ ਭੇਜਿਆ ਜਾਂਦਾ, ਇਸ ਲਈ ਇਸਨੂੰ ਬਾਅਦ ਵਿੱਚ ਕਾਲ ਆਬਜੈਕਟ ਉੱਤੇ summary ਤੋਂ ਪੜ੍ਹੋ। ਡੈਸ਼ਬੋਰਡ ਵਿੱਚ ਕਾਲ ਪੰਨੇ ਉੱਤੇ ਵੀ ਉਪਲਬਧ |
extracted_data | ਆਬਜੈਕਟ | ਨਲ | status, fields, evidence, verification, field_reasons, ਅਤੇ schema_version ਨਾਲ ਸੰਰਚਿਤ ਐਕਸਟ੍ਰੈਕਸ਼ਨ ਨਤੀਜਾ। ਹਰੇਕ ਗੈਰ-ਨਲ ਫੀਲਡ ਵਿੱਚ ਇਸਦਾ ਸਹੀ ਢਾਂਚਾਗਤ ਤੌਰ 'ਤੇ ਜਾਂਚਿਆ ਗਿਆ ਹਵਾਲਾ (ਵੱਧ ਤੋਂ ਵੱਧ 1,000 ਅੱਖਰ), ਨਾਲ ਹੀ ਇਸਦੀ ਬੋਲਣ ਵਾਲੇ ਦੀ ਭੂਮਿਕਾ ਅਤੇ ਵਾਰੀ ਸੂਚਕਾਂਕ ਹੁੰਦਾ ਹੈ; ਮਾਡਲ ਦੁਆਰਾ ਵਾਪਸ ਕੀਤੇ ਲੰਮੇ ਹਵਾਲਿਆਂ ਨੂੰ ਕੱਟਣ ਦੀ ਬਜਾਏ ਰੱਦ ਕਰ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ। ਜਦੋਂ ਫੀਲਡ null ਹੋਵੇ ਤਾਂ ਸਬੂਤ null ਹੁੰਦਾ ਹੈ। verified ਦਾ ਅਰਥ ਹੈ ਕਿ ਹਰੇਕ ਉਮੀਦਵਾਰ ਨੂੰ ਬਿਲਕੁਲ ਇੱਕ ਵੈਧ ਸੁਤੰਤਰ ਫ਼ੈਸਲਾ ਮਿਲਿਆ। unavailable ਵਿੱਚ ਗਲਤ ਬਣਿਆ ਜਾਂ ਅਧੂਰਾ ਤਸਦੀਕਕਾਰ ਆਉਟਪੁੱਟ ਵੀ ਸ਼ਾਮਲ ਹੈ; ਵੈਧ ਅੰਸ਼ਕ ਫ਼ੈਸਲੇ ਫਿਰ ਵੀ ਲਾਗੂ ਹੁੰਦੇ ਹਨ, ਜਦਕਿ ਇੱਕ ਵੀ ਵੈਧ ਫ਼ੈਸਲੇ ਤੋਂ ਬਿਨਾਂ ਉਮੀਦਵਾਰਾਂ ਨੂੰ ਨਲ ਕੀਤਾ ਜਾਂਦਾ ਹੈ। status completed, failed, exhausted, skipped, ਜਾਂ skipped_recording_disabled ਹੁੰਦਾ ਹੈ; ਜਦੋਂ ਏਜੰਟ ਕੋਲ ਕੋਈ ਐਕਸਟ੍ਰੈਕਸ਼ਨ ਫੀਲਡ ਨਾ ਹੋਵੇ ਤਾਂ null |
steps_trace | ਐਰੇ | ਸਿਰਫ਼ ਉਹਨਾਂ ਕਾਲਾਂ ਵਿੱਚ ਜਿਨ੍ਹਾਂ ਦੇ ਏਜੰਟ ਕੋਲ ਕਦਮ ਜਾਂ ਹੈਂਡਆਫ਼ ਹਨ। ਉਹ ਕ੍ਰਮ ਜਿਸ ਵਿੱਚ ਕਾਲ ਇਨ੍ਹਾਂ ਵਿਚੋਂ ਗੁਜ਼ਰੀ: ਹਰੇਕ ਐਂਟਰੀ ਵਿੱਚ t_ms (ਕਾਲ ਸ਼ੁਰੂ ਹੋਣ ਤੋਂ ਮਿਲੀਸਕਿੰਟ), agent (ਏਜੰਟ ਦੀ ਕੁੰਜੀ, a ਅਤੇ ਇਸਦੀ ID), step (ਕਦਮ ਦੀ ID, ਜਾਂ ਬਿਨਾਂ ਕਦਮਾਂ ਵਾਲੇ ਏਜੰਟ ਨੂੰ ਹੈਂਡਆਫ਼ ਉੱਤੇ null) ਅਤੇ via (start, model, condition, on_enter ਜਾਂ handoff) ਹੁੰਦੇ ਹਨ। ਸਿਰਫ਼ ID ਅਤੇ ਸਮੇਂ ਰੱਖਦਾ ਹੈ, ਇਸ ਲਈ ਰਿਕਾਰਡਿੰਗ ਬੰਦ ਹੋਣ 'ਤੇ ਵੀ ਰੱਖਿਆ ਜਾਂਦਾ ਹੈ |
collected_values | ਆਬਜੈਕਟ | ਸਿਰਫ਼ ਉਹਨਾਂ ਕਾਲਾਂ ਵਿੱਚ ਜਿਨ੍ਹਾਂ ਦੇ ਏਜੰਟ ਕੋਲ ਕਦਮ ਜਾਂ ਹੈਂਡਆਫ਼ ਹਨ। ਏਜੰਟ ਦੁਆਰਾ ਆਪਣੇ ਕਦਮਾਂ ਵਿੱਚ ਇਕੱਠੇ ਕੀਤੇ ਮੁੱਲ, ਇਕੱਠਾ ਕਰਨ ਵਾਲੀ ਫੀਲਡ ਦੇ ਨਾਮ ਅਨੁਸਾਰ ਕੁੰਜੀਬੱਧ, ਅਤੇ ਹਰੇਕ ਕਦਮ ਦੇ on_enter_tool ਨਤੀਜੇ ਲਈ <tool>_result। ਜਦੋਂ ਕਾਲ ਦੀ ਸਮੱਗਰੀ ਰੱਖੀ ਨਹੀਂ ਜਾਂਦੀ ਤਾਂ ਛੱਡ ਦਿੱਤਾ ਜਾਂਦਾ ਹੈ (ਰਿਕਾਰਡਿੰਗ ਬੰਦ) |
ਸਮਾਪਤੀ ਦੇ ਕਾਰਨ
| ਮੁੱਲ | ਅਰਥ |
|---|---|
user_hangup | ਰਿਮੋਟ ਪਾਰਟੀ ਨੇ ਪਹਿਲਾਂ ਕਾਲ ਕੱਟੀ |
ai_hangup | AI ਨੇ ਜਾਣਬੁੱਝ ਕੇ ਕਾਲ ਖਤਮ ਕੀਤੀ |
ai_transfer | AI ਨੇ ਕਾਲ ਟ੍ਰਾਂਸਫਰ ਕੀਤੀ; transfer_number ਸੈੱਟ ਹੈ |
ai_warm_transfer | AI ਨੇ ਵਾਰਮ (ਅਟੈਂਡਡ) ਟ੍ਰਾਂਸਫਰ ਪੂਰਾ ਕੀਤਾ |
returned_to_platform | AI ਨੇ ਕਾਲ ਨੂੰ ਤੁਹਾਡੇ ਸੰਪਰਕ ਕੇਂਦਰ ਵਿੱਚ ਵਾਪਸ ਭੇਜਿਆ: ਇਸ ਨੇ ਕਾਲ ਕੱਟ ਦਿੱਤੀ, ਅਤੇ ਜੇ ਕੋਈ ਹੋਣ ਤਾਂ ਵਾਪਸੀ ਐਂਟਰੀ ਦੇ ਹੈਡਰ SIP BYE ਵਿੱਚ ਸ਼ਾਮਲ ਕੀਤੇ |
voicemail_hangup | ਵੌਇਸਮੇਲ ਦਾ ਪਤਾ ਲੱਗਿਆ ਅਤੇ ਤੁਹਾਡੀ voicemail_action ਅਨੁਸਾਰ ਕਾਲ ਖਤਮ ਹੋ ਗਈ |
max_duration | ਕਾਲ ਅਧਿਕਤਮ ਮਿਆਦ ਸੀਮਾ ਤੱਕ ਪਹੁੰਚ ਗਈ: ਏਜੰਟ ਦੀ ਜਾਂ ਕਾਲ ਦੀ ਆਪਣੀ ਸੀਮਾ, ਜਾਂ 6-ਘੰਟੇ ਦੀ ਪਲੇਟਫਾਰਮ ਸੀਮਾ। ਸਮਾਂ-ਸੀਮਾ ਚੇਤਾਵਨੀ ਤੋਂ ਬਾਅਦ AI ਜਾਂ ਕਾਲਰ ਵੱਲੋਂ ਖਤਮ ਕੀਤੀ ਕਾਲ ai_hangup ਜਾਂ user_hangup ਹੀ ਰੱਖਦੀ ਹੈ |
superseded | ਸੈਸ਼ਨ ਨੂੰ ਨਵੇਂ ਸੈਸ਼ਨ ਨਾਲ ਬਦਲ ਦਿੱਤਾ ਗਿਆ |
inbound_config_webhook_failed | webhook ਮੋਡ ਵਿੱਚ ਕਿਸੇ ਨੰਬਰ ਲਈ ਇਨਬਾਊਂਡ ਕਾਲ: ਕੰਫਿਗਰੇਸ਼ਨ webhook ਨੇ ਵਰਤਣਯੋਗ ਕੰਫਿਗਰੇਸ਼ਨ ਵਾਪਸ ਨਹੀਂ ਕੀਤੀ, ਇਸ ਲਈ ਏਜੰਟ ਦੇ ਜਵਾਬ ਦੇਣ ਤੋਂ ਪਹਿਲਾਂ ਕਾਲ ਖਤਮ ਕਰ ਦਿੱਤੀ ਗਈ। status failed ਹੈ ਅਤੇ ਕਾਲ ਲਈ ਬਿਲ ਨਹੀਂ ਕੀਤਾ ਜਾਂਦਾ |
outbound_queue_timeout | ਇੱਕ ਕਤਾਰਬੱਧ ਕਾਲ ਡਾਇਲ ਕਰਨ ਲਈ ਥਾਂ ਮਿਲਣ ਬਿਨਾਂ 10 ਮਿੰਟ ਉਡੀਕਦੀ ਰਹੀ। status failed ਹੈ, ਕੁਝ ਵੀ ਡਾਇਲ ਨਹੀਂ ਕੀਤਾ ਗਿਆ, ਅਤੇ ਕਾਲ ਲਈ ਬਿਲ ਨਹੀਂ ਕੀਤਾ ਜਾਂਦਾ |
outbound_queue_canceled | ਤੁਸੀਂ ਇੱਕ ਕਤਾਰਬੱਧ ਕਾਲ ਨੂੰ ਡਾਇਲ ਹੋਣ ਤੋਂ ਪਹਿਲਾਂ ਰੱਦ ਕਰ ਦਿੱਤਾ। status failed ਹੈ ਅਤੇ ਕਾਲ ਲਈ ਬਿਲ ਨਹੀਂ ਕੀਤਾ ਜਾਂਦਾ |
unknown | ਖਤਮ ਹੋਣ ਦਾ ਕਾਰਨ ਨਿਰਧਾਰਤ ਨਹੀਂ ਕੀਤਾ ਜਾ ਸਕਿਆ |
ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ ਫਾਰਮੈਟ
transcripts ਵਿੱਚ ਹਰ ਐਂਟਰੀ ਇੱਕ ਗੱਲਬਾਤੀ ਵਾਰੀ ਹੈ। ਭੂਮਿਕਾਵਾਂ
user (ਕਾਲਰ ਦੀ ਬੋਲੀ), model (ਏਜੰਟ ਦੀ ਬੋਲੀ ਅਤੇ ਟੂਲ ਕਾਲਾਂ),
tool (ਟੂਲ ਦੇ ਨਤੀਜੇ), ਅਤੇ system (ਭਾਸ਼ਾ ਬਦਲਣ ਵਰਗੀਆਂ ਕਾਲ ਘਟਨਾਵਾਂ)
ਹਨ।
[
{
"role": "user",
"content_type": "text/plain",
"content": "Hi, I'm calling about my appointment.",
"start_ms": 1200,
"end_ms": 4100,
"audio_url": "https://storage.example.com/…"
},
{
"role": "model",
"content_type": "text/plain",
"content": "Sure, what date works best?",
"start_ms": 4200,
"end_ms": 6100
},
{
"role": "model",
"content_type": "application/json",
"content": {
"tool_call": "search_appointments",
"arguments": { "date": "2026-04-21" }
}
},
{
"role": "tool",
"content_type": "application/json",
"content": {
"tool_name": "search_appointments",
"response": { "available_slots": ["9:00 AM", "2:00 PM"] }
}
}
]| ਫੀਲਡ | ਕਿਸਮ | ਵੇਰਵਾ |
|---|---|---|
role | ਸਟ੍ਰਿੰਗ | user, model, tool, ਜਾਂ system |
content_type | ਸਟ੍ਰਿੰਗ | ਬੋਲੀ ਲਈ text/plain; ਟੂਲ ਕਾਲਾਂ, ਟੂਲ ਨਤੀਜਿਆਂ ਅਤੇ ਸਿਸਟਮ ਘਟਨਾਵਾਂ ਲਈ application/json |
content | ਸਟ੍ਰਿੰਗ | ਆਬਜੈਕਟ | ਬੋਲੀ ਦਾ ਟੈਕਸਟ, ਜਾਂ ਉੱਪਰ ਦਿਖਾਇਆ ਗਿਆ ਸੰਰਚਿਤ ਆਬਜੈਕਟ। ਟੂਲ ਕਾਲਾਂ: {"tool_call": name, "arguments": {…}}। ਟੂਲ ਨਤੀਜੇ: {"tool_name": name, "response": {…}} |
start_ms, end_ms | ਇੰਟੀਜਰ | ਕਾਲ ਸ਼ੁਰੂ ਹੋਣ ਤੋਂ ਔਫਸੈੱਟ, ms। ਜਦੋਂ ਆਡੀਓ ਟਾਈਮਿੰਗ ਪਤਾ ਹੋਵੇ ਤਾਂ ਮੌਜੂਦ ਹੁੰਦੇ ਹਨ |
ttfa_ms | ਇੰਟੀਜਰ | ਮਾਪੇ ਜਾਣ 'ਤੇ model ਵਾਰੀ ਲਈ ਪਹਿਲੇ ਆਡੀਓ ਤੱਕ ਦਾ ਸਮਾਂ |
audio_url, audio_urls | ਸਟ੍ਰਿੰਗ / ਐਰੇ | ਵਾਰੀ ਦੇ ਆਡੀਓ ਲਈ ਮਿਆਦ-ਸਮਾਪਤ ਹੋਣ ਵਾਲੇ ਸਾਇਨ ਕੀਤੇ URL, ਜਦੋਂ ਹਰ ਵਾਰੀ ਵੱਖਰੇ ਤੌਰ 'ਤੇ ਰਿਕਾਰਡ ਕੀਤਾ ਗਿਆ ਹੋਵੇ |
ਪੂਰੀ ਤਰ੍ਹਾਂ ਸੰਰਚਿਤ ਵਾਰੀ ਇਤਿਹਾਸ ਲਈ (ਰੁਕਾਵਟ ਮਾਰਕਰਾਂ,
ack-prompts, ਅਤੇ ਕੱਚੀਆਂ ਸਥਿਤੀਆਂ ਸਮੇਤ), ਵਰਤੋ
GET /v1/calls/{call_id}/history।
ਪੁਰਾਣੇ ਪੇਲੋਡ ਦੇ ਅੰਤਰ
ਪੁਰਾਣਾ ਸਿੰਗਲ-URL webhook ਐਨਵਲਪ
{"type": "telephony.complete" | "web.complete", "data": {…}} ਹੈ, ਜਿਸ ਵਿੱਚ
ਕੋਈ event_id ਨਹੀਂ ਹੁੰਦਾ, ਅਤੇ ਇਸਦਾ data ਐਂਡਪੌਇੰਟ ਪੇਲੋਡ ਤੋਂ ਵੱਖਰਾ ਹੁੰਦਾ ਹੈ:
ਪੁਰਾਣੇ ਸਮਾਪਤੀ ਪੇਲੋਡ ਵਿੱਚ agent_id ਅਤੇ agent_name ਵੀ ਹੁੰਦੇ ਹਨ।
- ਵਾਰੀ ਐਰੇ
transcriptsਦੀ ਬਜਾਏhistoryਹੇਠ ਹੁੰਦਾ ਹੈ (ਉੱਪਰ ਦਿੱਤੇ ਵਾਂਗ ਹੀ ਵਾਰੀ ਸਕੀਮਾ)। - ਫੀਲਡ ਸੈੱਟ ਕਾਲ-ਸਮਾਪਤੀ ਦੀ ਕੱਚੀ ਰਿਪੋਰਟ ਹੈ ਅਤੇ ਇਸ ਵਿੱਚ ਉੱਪਰਲੀ ਟੇਬਲ ਤੋਂ ਇਲਾਵਾ ਵਾਧੂ ਅੰਦਰੂਨੀ ਫੀਲਡ ਸ਼ਾਮਲ ਹੋ ਸਕਦੇ ਹਨ — ਅਣਜਾਣ ਫੀਲਡਾਂ ਨੂੰ ਜਾਣਕਾਰੀ ਲਈ ਸਮਝੋ।
- ਵੈੱਬ ਕਾਲਾਂ (
direction: "web") ਵਿੱਚfrom_number/to_numberਨਹੀਂ ਹੁੰਦੇ ਅਤੇorigin_domainਜੋੜਿਆ ਜਾਂਦਾ ਹੈ। - Builder ਮਾਈਕ ਟੈਸਟ ਕਾਲਾਂ ਪੁਰਾਣੇ ਪਾਥ ਉੱਤੇ
telephony.completeਵਜੋਂ ਰਿਪੋਰਟ ਹੁੰਦੀਆਂ ਹਨ (ਐਂਡਪੌਇੰਟ ਸਿਸਟਮ ਉਨ੍ਹਾਂ ਨੂੰweb.completeਨਾਲ ਮੈਪ ਕਰਦਾ ਹੈ)। - ਟ੍ਰਾਂਸਫ਼ਰ ਤਾਲਮੇਲ: ਜਦੋਂ ਕਾਲ ਟ੍ਰਾਂਸਫ਼ਰ ਵਿੱਚ ਖਤਮ ਹੁੰਦੀ ਹੈ, ਪੁਰਾਣੇ webhook ਨੂੰ ਸਮਕਾਲੀ ਤੌਰ 'ਤੇ ਕਾਲ ਕੀਤਾ ਜਾਂਦਾ ਹੈ ਅਤੇ ਇਹ ਇਹ ਸੰਕੇਤ ਦੇਣ ਲਈ
{"transfer_ready": false}ਜਵਾਬ ਦੇ ਸਕਦਾ ਹੈ ਕਿ ਹੈਂਡਆਫ਼ ਟਾਰਗੇਟ ਤਿਆਰ ਨਹੀਂ ਹੈ। ਕੋਈ ਵੀ ਹੋਰ ਜਵਾਬ (ਜਾਂ ਕੋਈ ਪੁਰਾਣਾ webhook ਨਾ ਹੋਣਾ) ਟ੍ਰਾਂਸਫ਼ਰ ਨੂੰ ਅੱਗੇ ਵਧਣ ਦਿੰਦਾ ਹੈ। ਇਸ ਲਈ ਐਂਡਪੌਇੰਟ ਡਿਲਿਵਰੀਆਂ ਨਾਲ ਕਦੇ ਸਲਾਹ ਨਹੀਂ ਕੀਤੀ ਜਾਂਦੀ।
ਉਦਾਹਰਨ ਹੈਂਡਲਰ
import hashlib
import hmac
import json
import os
from fastapi import FastAPI, HTTPException, Request
app = FastAPI()
SECRET = os.environ["THUNDERPHONE_WEBHOOK_SECRET"]
def verify(body: bytes, signature: str) -> bool:
expected = hmac.new(SECRET.encode(), body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, signature or "")
@app.post("/thunderphone-webhook")
async def webhook(request: Request):
body = await request.body()
if not verify(body, request.headers.get("X-ThunderPhone-Signature", "")):
raise HTTPException(status_code=401)
event = json.loads(body)
if event["type"] in ("telephony.complete", "web.complete"):
data = event["data"]
# Endpoint deliveries use "transcripts"; the legacy webhook uses "history".
turns = data.get("transcripts") or data.get("history") or []
await persist_call_record(
call_id=data["call_id"],
turns=turns,
recording_url=data.get("recording_url"),
)
if data["end_reason"] in ("ai_transfer", "ai_warm_transfer"):
await notify_team(data.get("transfer_number"), data["call_id"])
return {"ok": True}import crypto from "node:crypto";
import express from "express";
const app = express();
const SECRET = process.env.THUNDERPHONE_WEBHOOK_SECRET;
function verify(body, signature) {
const expected = crypto.createHmac("sha256", SECRET).update(body).digest("hex");
return signature &&
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
}
app.post(
"/thunderphone-webhook",
express.raw({ type: "application/json" }),
async (req, res) => {
if (!verify(req.body, req.header("X-ThunderPhone-Signature"))) {
return res.sendStatus(401);
}
const event = JSON.parse(req.body.toString("utf8"));
if (["telephony.complete", "web.complete"].includes(event.type)) {
const data = event.data;
// Endpoint deliveries use "transcripts"; the legacy webhook uses "history".
const turns = data.transcripts ?? data.history ?? [];
await persistCallRecord({ ...data, turns });
if (["ai_transfer", "ai_warm_transfer"].includes(data.end_reason)) {
await notifyTeam(data.transfer_number, data.call_id);
}
}
res.json({ ok: true });
},
);ਆਮ ਵਰਤੋਂ ਦੇ ਮਾਮਲੇ
ਹਰ ਕਾਲ ਦਾ ਟ੍ਰਾਂਸਕ੍ਰਿਪਟ + ਰਿਕਾਰਡਿੰਗ URL ਆਪਣੇ ਗਾਹਕ ਰਿਕਾਰਡਾਂ ਦੇ ਨਾਲ ਸਟੋਰ ਕਰੋ।
ਟਾਪਿਕ ਮਾਡਲਿੰਗ, CSAT ਸਿਗਨਲ ਐਕਸਟ੍ਰੈਕਸ਼ਨ, ਜਾਂ ਟ੍ਰਾਂਸਫ਼ਰ-ਰੇਟ ਮਾਨੀਟਰਿੰਗ ਲਈ ਟ੍ਰਾਂਸਕ੍ਰਿਪਟਾਂ ਨੂੰ ਪਾਈਪਲਾਈਨ ਵਿੱਚ ਸਟ੍ਰੀਮ ਕਰੋ।
ਮਨੁੱਖੀ ਸਮੀਖਿਆ ਲਈ ਕਾਲਾਂ ਨੂੰ QA ਟੂਲ ਵਿੱਚ ਖੋਲ੍ਹੋ, ਜਾਂ ਉਹਨਾਂ ਨੂੰ ਆਪਣੇ ਮੁਲਾਂਕਣ ਮਾਡਲ ਰਾਹੀਂ ਚਲਾਓ।
ਟ੍ਰਾਂਸਫ਼ਰ / ਅਸਫਲਤਾ ਹੋਣ 'ਤੇ ਕਿਸੇ ਮਨੁੱਖੀ ਟੀਮ ਮੈਂਬਰ ਨੂੰ ਸੂਚਿਤ ਕਰੋ।