Open in
ఈవెంట్ల కేటలాగ్
ThunderPhone పంపే అన్ని వెబ్హుక్ ఈవెంట్ రకాలు.
ప్రతి వెబ్హుక్ బాడీలో type ఫీల్డ్ ఉంటుంది; దాని విలువ ఈ పేజీలోని ఈవెంట్
రకాల్లో ఒకటి. మీరు ఒక
ఎండ్పాయింట్కు సబ్స్క్రైబ్ అయినప్పుడు, events అర్రేలో మీరు కోరుకునే
ఈవెంట్ రకాలు ఉండాలి (లేదా అన్నింటికీ సబ్స్క్రైబ్ కావడానికి అది ఖాళీగా ఉండాలి —
ప్రతి-టర్న్ ఈవెంట్లు telephony.turn /
web.turn, అలాగే ప్రత్యక్ష పురోగతి ఈవెంట్
call.status_changed మినహా; ఇవి వాటిని స్పష్టంగా పేర్కొనే
ఎండ్పాయింట్లకు మాత్రమే డెలివర్ చేయబడతాయి).
ఈ ఈవెంట్లను రెండు డెలివరీ విధానాలు అందిస్తాయి:
- ఎండ్పాయింట్ డెలివరీలు ఎల్లప్పుడూ పునఃప్రయత్నాలతో కూడిన నాన్-బ్లాకింగ్ నోటిఫికేషన్లు: ఏదైనా 2xxతో ప్రతిస్పందించండి; డీడూప్లికేషన్ కోసం ఎన్వలప్లో
event_idఉంటుంది. - బ్లాకింగ్ ఎక్స్ఛేంజ్లు లెగసీ సింగిల్-URL వెబ్హుక్లో మాత్రమే అమలవుతాయి:
telephony.incoming/web.incomingకాన్ఫిగరేషన్ అభ్యర్థన (వెబ్హుక్-మోడ్ నంబర్లు: ఒక పునఃప్రయత్నంతో సహా 13 s; వెబ్హుక్-మోడ్ విడ్జెట్ కీలు: 10 s) మరియు వెబ్హుక్-మోడ్ టూల్ డిస్పాచ్. మీ ప్రతిస్పందన లైవ్ కాల్ను రూపొందిస్తుంది.
క్రింది ఉదాహరణ పేలోడ్లు ఎండ్పాయింట్ ఎన్వలప్ను దాని వైర్ క్రమంలో చూపిస్తాయి
(కీలు అక్షరక్రమంలో అమర్చబడ్డాయి: data, event_id, type); లెగసీ
డెలివరీలు event_id లేకుండా అదే dataను కలిగి ఉంటాయి.
కాల్ ఈవెంట్లు
telephony.incoming
ఇన్బౌండ్ కాల్ మీ ఫోన్ నంబర్లలో ఒకదానికి చేరినప్పుడు పంపబడుతుంది. ఎండ్పాయింట్ డెలివరీలు ఏజెంట్-కాన్ఫిగర్ చేసినా లేదా వెబ్హుక్-కాన్ఫిగర్ చేసినా ప్రతి ఇన్బౌండ్ కాల్కు పంపబడే ప్రతిస్పందన కోసం వేచి ఉండని నోటిఫికేషన్లు. కేటాయించిన ఏజెంట్ లేని నంబర్లు పాత వెబ్హుక్లో అదనంగా నిరోధించే కాన్ఫిగరేషన్ అభ్యర్థనను స్వీకరిస్తాయి — పూర్తి అభ్యర్థన / ప్రతిస్పందన స్కీమా కోసం telephony.incoming / web.incoming చూడండి.
{
"data": {
"call_id": 987654321,
"from_number": "+14155550199",
"to_number": "+15551234567"
},
"event_id": "3f6b2ad0-1c9e-4a57-9f2b-8f6f0f9d2f11",
"type": "telephony.incoming"
}| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
agent_id | పూర్ణాంకం | శూన్యం | కేటాయించబడి ఉంటే, కాల్ను నిర్వహించిన ఏజెంట్ |
agent_name | స్ట్రింగ్ | శూన్యం | కేటాయించబడి ఉంటే, కాల్ను నిర్వహించిన ఏజెంట్ |
returning_call | ఆబ్జెక్ట్ | గత 30 రోజుల్లో నంబర్ ఈ కాలర్కు కాల్ చేసినప్పుడు మాత్రమే ఉంటుంది: మునుపటి కాల్ యొక్క call_id, agent_id, started_at, మరియు outcome. తిరిగి కాల్లు చూడండి |
sip_headers | ఆబ్జెక్ట్ | X-* లేదా User-to-User SIP హెడర్లతో కాల్ వచ్చినప్పుడు మాత్రమే ఉంటుంది (SIP చిరునామాలు మరియు మాన్యువల్ SIP కనెక్షన్లు): చిన్న అక్షరాల్లో హెడర్ పేరు → విలువ. SIP హెడర్లు చూడండి |
telephony.complete
ఇన్బౌండ్ లేదా అవుట్బౌండ్ టెలిఫోనీ కాల్ ముగిసినప్పుడు పంపబడుతుంది. నిరోధించనిది. ట్రాన్స్క్రిప్ట్, అందుబాటులో ఉన్నప్పుడు రికార్డింగ్ URL, మరియు బిల్లింగ్ సారాంశాన్ని కలిగి ఉంటుంది. పేలోడ్ స్కీమా కోసం telephony.complete / web.complete చూడండి.
| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
agent_id | పూర్ణసంఖ్య | శూన్యం | కేటాయించబడినప్పుడు, కాల్ను నిర్వహించిన ఏజెంట్ |
agent_name | స్ట్రింగ్ | శూన్యం | కేటాయించబడినప్పుడు, కాల్ను నిర్వహించిన ఏజెంట్ |
telephony.tool
టెలిఫోనీ కాల్ ఒక ఫంక్షన్ టూల్ను పిలిచిన తర్వాత పంపబడుతుంది. నిరోధించని ఆడిట్ నోటిఫికేషన్ — ఈ ఈవెంట్ డెలివర్ అయ్యే సమయానికి టూల్ ఇప్పటికే అమలై ఉంటుంది; ఇది మీ స్వంత ఫంక్షన్ టూల్స్ మరియు అంతర్నిర్మిత send_sms టూల్ను కవర్ చేస్తుంది (ఇతర అంతర్నిర్మిత, నాలెడ్జ్-బేస్, యాప్-కనెక్షన్ లేదా MCP టూల్స్ను కాదు). send_sms కోసం arguments.to మరియు arguments.body రెండూ [REDACTED]గా ఉంటాయి. పూర్తి ట్రాన్స్క్రిప్ట్లు కూడా వాటిని దాచేస్తాయి; ప్రతిస్పందనలోని message_idను ఉపయోగించి సంస్థ-పరిధి గల SMS రిసోర్స్ నుండి కంటెంట్ మరియు గ్రహీతను పొందండి.
{
"data": {
"arguments": { "date": "2026-04-21" },
"call_id": 987654321,
"from_number": "+14155550199",
"response": {
"response": { "available_slots": ["9:00 AM", "2:00 PM"] },
"status": 200
},
"to_number": "+15551234567",
"tool_name": "search_appointments"
},
"event_id": "1f0a7c3e-52d4-4a0e-8f4b-b1a6a1c0d9e2",
"type": "telephony.tool"
}response అనేది అమలు చేసిన ఫలితం: విజయవంతమైనప్పుడు {"status": <http status>, "response": <your endpoint's JSON>}, లేదా విఫలమైనప్పుడు
{"status": <status>, "error": "<message>"}.
| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
agent_id | పూర్ణసంఖ్య | శూన్యం | కేటాయించబడినప్పుడు, కాల్ను నిర్వహించిన ఏజెంట్ |
agent_name | స్ట్రింగ్ | శూన్యం | కేటాయించబడినప్పుడు, కాల్ను నిర్వహించిన ఏజెంట్ |
telephony.turn
టెలిఫోనీ కాల్ పురోగతిలో ఉన్నప్పుడు, మాట్లాడిన భాగం ఉన్న ప్రతి టర్న్కు అది జరుగుతున్నప్పుడే ఒకసారి పంపబడుతుంది — ఏజెంట్ మాట్లాడిన పూర్తి స్పందనలు మరియు కాలర్ ట్రాన్స్క్రైబ్ చేసిన టర్న్లు. GET /v1/calls/{call_id}/transcriptను పోలింగ్ చేయడానికి బదులుగా సాధారణ వెబ్హుక్ల ద్వారా ప్రత్యక్ష సంభాషణను అనుసరించడానికి ఇది మిమ్మల్ని అనుమతిస్తుంది. నిరోధించనిది.
{
"data": {
"call_id": 987654321,
"entry_type": "completion",
"from_number": "+14155550199",
"position": 7,
"role": "assistant",
"start_ms": 15200,
"text": "How many employees does your company have?",
"to_number": "+15551234567"
},
"event_id": "8d3f5a2c-7b1e-4c9a-b6d0-2e4f6a8c0d1e",
"type": "telephony.turn"
}| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
agent_id | పూర్ణసంఖ్య | శూన్యం | కేటాయించబడినప్పుడు, కాల్ను నిర్వహించిన ఏజెంట్ |
agent_name | స్ట్రింగ్ | శూన్యం | కేటాయించబడినప్పుడు, కాల్ను నిర్వహించిన ఏజెంట్ |
position | పూర్ణసంఖ్య | కాల్ చరిత్రలో టర్న్ సూచిక — క్రమబద్ధీకరణకు స్థిరమైన గుర్తింపు |
role | స్ట్రింగ్ | assistant (ఏజెంట్ మాట) లేదా user (కాలర్ మాట) |
text | స్ట్రింగ్ | పంపే సమయంలో తెలిసిన టర్న్ ట్రాన్స్క్రిప్ట్ టెక్స్ట్ |
entry_type | స్ట్రింగ్ | మూల చరిత్ర ఎంట్రీ రకం: completion (ఏజెంట్), లేదా user_turn / span (కాలర్) |
start_ms, end_ms | పూర్ణసంఖ్య | కాల్ ప్రారంభం నుండి msలో ఆడియో ఆఫ్సెట్లు; పంపే సమయంలో ప్లేఅవుట్ టైమింగ్ ఇప్పటికే తెలిసినప్పుడే ఉంటాయి |
web.incoming
telephony.incomingకు వెబ్-చానల్ సమానమైనది; వెబ్ విడ్జెట్ సెషన్ లేదా బిల్డర్ మైక్ టెస్ట్ కాల్ ప్రారంభమైనప్పుడు పంపబడుతుంది. ఎండ్పాయింట్ డెలివరీలు ప్రతి వెబ్ సెషన్కు ప్రతిస్పందన కోసం వేచి ఉండని విధంగా ఉంటాయి. mode="webhook"లోని పబ్లిషబుల్ కీలు పాత వెబ్హుక్లో అదనంగా నిరోధించే కాన్ఫిగరేషన్ అభ్యర్థనను స్వీకరిస్తాయి — ఆ నిరోధించే అభ్యర్థనకు వేరే ఆకృతి ఉంటుంది (origin_domain, publishable_key_prefix; ఫోన్ నంబర్లు ఉండవు). telephony.incoming / web.incoming చూడండి.
{
"data": {
"call_id": 987654322,
"from_number": "web",
"origin_domain": "https://example.com",
"publishable_key_prefix": "pk_live_a1b2",
"to_number": "+15551234567"
},
"event_id": "9a2b4c6d-8e0f-4a1b-9c2d-3e4f5a6b7c8d",
"type": "web.incoming"
}from_number ఎల్లప్పుడూ పదశః "web"గానే ఉంటుంది. వెబ్హుక్-మోడ్ విడ్జెట్ సెషన్ల కోసం to_number ఖాళీగా ఉంటుంది (కాన్ఫిగరేషన్ తర్వాత సెషన్ ఏజెంట్ నంబర్ కేటాయించబడుతుంది); బిల్డర్ మైక్ టెస్ట్ కాల్ల కోసం origin_domain మరియు publishable_key_prefix ఖాళీగా ఉంటాయి.
| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
agent_id | పూర్ణసంఖ్య | శూన్యం | కేటాయించబడినప్పుడు, కాల్ను నిర్వహించిన ఏజెంట్ |
agent_name | స్ట్రింగ్ | శూన్యం | కేటాయించబడినప్పుడు, కాల్ను నిర్వహించిన ఏజెంట్ |
web.complete
telephony.completeకు వెబ్-చానల్ సమానమైనది; వెబ్ విడ్జెట్ కాల్లు (direction: "web") మరియు బిల్డర్ మైక్ టెస్ట్ కాల్లు (direction: "test")ను కవర్ చేస్తుంది. నిరోధించనిది. telephony.completeతో అదే పేలోడ్ ఆకృతి, అదనంగా origin_domainతో, from_numberను "web"గా సెట్ చేస్తుంది.
| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
agent_id | పూర్ణసంఖ్య | శూన్యం | కేటాయించబడినప్పుడు, కాల్ను నిర్వహించిన ఏజెంట్ |
agent_name | స్ట్రింగ్ | శూన్యం | కేటాయించబడినప్పుడు, కాల్ను నిర్వహించిన ఏజెంట్ |
web.tool
telephony.toolకు వెబ్-చానల్ సమానమైనది. dataలో from_number / to_numberకు బదులుగా origin_domain ఉంటుంది.
| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
agent_id | పూర్ణసంఖ్య | శూన్యం | కేటాయించబడినప్పుడు, కాల్ను నిర్వహించిన ఏజెంట్ |
agent_name | స్ట్రింగ్ | శూన్యం | కేటాయించబడినప్పుడు, కాల్ను నిర్వహించిన ఏజెంట్ |
web.turn
telephony.turnకు వెబ్-చానల్ సమానమైనది; వెబ్ విడ్జెట్ కాల్లు మరియు బిల్డర్ మైక్ టెస్ట్ కాల్లను కవర్ చేస్తుంది. అదే పేలోడ్ ఆకృతి, from_number / to_numberకు బదులుగా origin_domainతో ఉంటుంది. telephony.turnలాగే, దీనికి స్పష్టమైన సబ్స్క్రిప్షన్ అవసరం — ఇది ఖాళీ events అరే ద్వారా ఎప్పుడూ డెలివర్ కాదు.
| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
agent_id | పూర్ణసంఖ్య | శూన్యం | కేటాయించబడినప్పుడు, కాల్ను నిర్వహించిన ఏజెంట్ |
agent_name | స్ట్రింగ్ | శూన్యం | కేటాయించబడినప్పుడు, కాల్ను నిర్వహించిన ఏజెంట్ |
call.transfer_completed
ఒక కాల్ ట్రాన్స్ఫర్ యొక్క తుది ఫలితంతో ప్రతి కాల్కు ఒకసారి పంపబడుతుంది:
కోల్డ్ ట్రాన్స్ఫర్ లేదా ఏజెంట్ వైదొలిగిన తర్వాత వార్మ్ ట్రాన్స్ఫర్ మిగిల్చే వ్యక్తుల మధ్య
బ్రిడ్జ్. ఇది బ్లాకింగ్ కాదు మరియు ఎండ్పాయింట్లకే పంపబడుతుంది (లెగసీ
సింగిల్-URL వెబ్హుక్కు ఎప్పుడూ కాదు). కాల్ యొక్క telephony.complete తర్వాత ఇది వస్తుంది:
క్యారియర్ కాల్ బాధ్యతను స్వీకరించినప్పుడు లేదా ట్రాన్స్ఫర్ విఫలమైనప్పుడు, లేదా
ThunderPhone కాల్ను బ్రిడ్జ్ చేసినప్పుడు, బ్రిడ్జ్ ముగిసిన తర్వాత.
{
"data": {
"agent_id": 12,
"agent_name": "Front desk",
"bridge_kind": "cold_fallback",
"bridge_seconds": 255,
"bridge_total_cents": 5,
"call_id": 987654321,
"destination": "+15555550102",
"sip_status": 403,
"transfer_outcome": "bridged"
},
"event_id": "5b0f6c1e-9d2a-5e7b-8c4d-1a2b3c4d5e6f",
"type": "call.transfer_completed"
}| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
call_id | integer | ట్రాన్స్ఫర్ చేయబడిన కాల్ |
agent_id | integer | null | కేటాయించబడి ఉంటే, కాల్ను నిర్వహించిన ఏజెంట్ |
agent_name | string | null | కేటాయించబడి ఉంటే, కాల్ను నిర్వహించిన ఏజెంట్ |
transfer_outcome | string | refer_accepted: క్యారియర్ కాల్ బాధ్యతను స్వీకరించింది. bridged: క్యారియర్ కోల్డ్ ట్రాన్స్ఫర్ను తిరస్కరించినందున లేదా వార్మ్ ట్రాన్స్ఫర్లోని ఏజెంట్ వైదొలిగినందున, ThunderPhone కాలర్ను మరియు గమ్యస్థానాన్ని స్వయంగా కనెక్ట్ చేసి ఉంచింది. bridge_unanswered: క్యారియర్ కోల్డ్ ట్రాన్స్ఫర్ను తిరస్కరించింది మరియు ThunderPhone చేసిన స్వంత కాల్కు గమ్యస్థానం సమాధానం ఇవ్వలేదు. failed: ట్రాన్స్ఫర్ పూర్తికాలేదు మరియు కాల్ ముగిసింది |
destination | string | null | కాల్ ట్రాన్స్ఫర్ చేయబడిన నంబర్ |
sip_status | integer | null | క్యారియర్ కోల్డ్ ట్రాన్స్ఫర్ను తిరస్కరించినప్పుడు దాని SIP స్థితి: 403 (ఉదాహరణకు, కాల్ ట్రాన్స్ఫర్ లేని Twilio ట్రంక్), 405 లేదా 501. క్యారియర్ దానిని తిరస్కరించనప్పుడు null |
bridge_kind | string | null | bridgedకు మాత్రమే: cold_fallback (ThunderPhone కనెక్ట్ చేసిన తిరస్కరించబడిన కోల్డ్ ట్రాన్స్ఫర్) లేదా warm (ఏజెంట్ వెళ్లిపోయిన తర్వాత వార్మ్ ట్రాన్స్ఫర్లోని ఇద్దరు వ్యక్తులు) |
bridge_seconds | integer | null | bridgedకు మాత్రమే: ThunderPhone బిల్ చేసిన బ్రిడ్జ్ సమయం, సెకన్లలో |
bridge_total_cents | integer | null | bridgedకు మాత్రమే: ఏదైనా ఉచిత కాల్ క్రెడిట్ తర్వాత బ్రిడ్జ్కు అయిన ఖర్చు, USD సెంట్లలో; ఇది కాల్ యొక్క billing_total_cents నుండి వేరుగా బిల్ చేయబడుతుంది |
అదే విలువలు కాల్ ఆబ్జెక్ట్లో
transfer_outcome, transfer_destination, transfer_sip_status,
transfer_bridge_kind, transfer_bridge_seconds మరియు
transfer_bridge_total_centsగా ఉంటాయి. ఒక కాల్కు ప్రతి డెలివరీలో event_id ఒకటే
ఉంటుంది, కాబట్టి పునరావృత నివేదిక రెండవ ఈవెంట్ను ఎప్పుడూ సృష్టించదు.
call.billed
కొలవబడిన వినియోగం ఆధారంగా బిల్ చేయబడిన కాల్ కోసం పంపబడుతుంది: దాని ఛార్జీ ఖరారైనప్పుడు, కాల్ ముగిసిన కొన్ని నిమిషాల తర్వాత దాని వినియోగ వివరాలు అందినప్పుడు, అలాగే తర్వాత అందిన వినియోగం ఛార్జీని పెంచిన ప్రతిసారీ. కాల్ యొక్క
telephony.complete / web.complete ఈవెంట్లో
billing_pending: true మరియు null బిల్లింగ్ ఫీల్డ్లు ఉంటాయి. ఇది నిరోధించనిది,
మరియు ఎండ్పాయింట్లకు మాత్రమే పంపబడుతుంది (లెగసీ సింగిల్-URL వెబ్హుక్కు ఎప్పుడూ కాదు).
ముగిసినప్పుడు బిల్ చేయబడే కాల్ల బిల్లింగ్ పూర్తి ఈవెంట్లోనే ఉంటుంది
మరియు వాటికి call.billed ఉండదు.
క్రమం హామీ ఇవ్వబడదు: ఛార్జీ సాధారణంగా పూర్తి ఈవెంట్ కోసం వేచి ఉంటుంది,
కానీ call.billed దానికి ముందే రావచ్చు (పూర్తి ఈవెంట్ ఒక గంట ఆలస్యం కావడం,
లేదా డెలివరీలు వేర్వేరు సమయాల్లో మళ్లీ ప్రయత్నించబడటం), అలాగే రెండు
call.billed ఈవెంట్లు క్రమం తప్పి రావచ్చు. ప్రతి call_id కోసం అత్యధిక
billing_seq ఉన్న ఈవెంట్ను ఉంచండి.
{
"data": {
"adjustment_cents": null,
"agent_id": 12,
"agent_name": "Front desk",
"billable_minutes": 3.0,
"billing_seq": 1,
"billing_total_cents": 10,
"call_id": 987654321,
"reason": "settled"
},
"event_id": "7c1d2e3f-4a5b-5c6d-8e7f-9a0b1c2d3e4f",
"type": "call.billed"
}| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
call_id | పూర్ణసంఖ్య | బిల్ చేయబడిన కాల్ |
agent_id | పూర్ణసంఖ్య | శూన్యం | కేటాయించబడినప్పుడు, కాల్ను నిర్వహించిన ఏజెంట్ |
agent_name | స్ట్రింగ్ | శూన్యం | కేటాయించబడినప్పుడు, కాల్ను నిర్వహించిన ఏజెంట్ |
reason | స్ట్రింగ్ | settled: కాల్ ఛార్జీ. adjusted: ఛార్జీని పెంచిన తర్వాత అందిన వినియోగం (ఛార్జీ ఎప్పుడూ తగ్గించబడదు) |
billing_seq | పూర్ణసంఖ్య | ఛార్జీకి 1, ఆపై ప్రతి పెరుగుదలకు 2, 3, ... అందిన వాటిలో అత్యధికం కాల్ యొక్క ప్రస్తుత బిల్లింగ్ |
billable_minutes | సంఖ్య | బిల్ చేయబడిన నిమిషాలు, సమీప పావు నిమిషానికి రౌండ్ చేయబడతాయి |
billing_total_cents | పూర్ణసంఖ్య | ఉచిత కాల్ క్రెడిట్ తర్వాత, adjusted పెరుగుదలలతో సహా, ఇప్పటివరకు కాల్కు వసూలు చేసిన మొత్తం USD సెంట్లు |
adjustment_cents | పూర్ణసంఖ్య | శూన్యం | adjustedకు మాత్రమే: ఉచిత కాల్ క్రెడిట్ తర్వాత ఈ పెరుగుదల USD సెంట్లలో |
అదే మొత్తాలు కాల్ ఆబ్జెక్ట్లో
billable_minutes మరియు billing_total_centsగా ఉంటాయి. ఒక billing_seq యొక్క
ప్రతి డెలివరీలో event_id ఒకేలా ఉంటుంది, కాబట్టి పునరావృత నివేదిక ఎప్పుడూ
రెండవ ఈవెంట్ను సృష్టించదు.
call.status_changed
కాల్ కొనసాగుతున్నప్పుడు, అది కొత్త దశకు చేరుకున్న ప్రతిసారి పంపబడుతుంది: ThunderPhone డయల్ చేయడం ప్రారంభించినప్పుడు, వ్యక్తి లేదా వారి ఫోన్ సమాధానం ఇచ్చినప్పుడు, ఏజెంట్ వాయిస్మెయిల్ను చేరుకున్నప్పుడు లేదా ఏజెంట్ను హోల్డ్లో ఉంచి మళ్లీ హోల్డ్ నుండి తీసివేసినప్పుడు. కాల్ను అనుసరించే చాట్ థ్రెడ్లో "డయల్ చేస్తోంది…", "సమాధానం ఇచ్చారు", "హోల్డ్లో ఉంది" మరియు "4 నిమిషాల తర్వాత హోల్డ్ నుండి తీసివేశారు" వంటి వాటిని చూపడానికి దీన్ని ఉపయోగించండి. ఇది నిరోధించనిది మరియు ఎండ్పాయింట్లకు మాత్రమే అందించబడుతుంది (లెగసీ ఒకే-URL వెబ్హుక్కు ఎప్పుడూ కాదు).
{
"data": {
"agent_id": 12,
"agent_name": "Front desk",
"call_id": 987654321,
"direction": "outbound",
"hold_seconds": 240,
"occurred_at": "2026-11-07T17:04:12.418Z",
"status": "off_hold"
},
"event_id": "2f6a1c9e-3b7d-5e8f-9a0b-4c5d6e7f8a9b",
"type": "call.status_changed"
}| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
call_id | పూర్ణసంఖ్య | కాల్ |
agent_id | పూర్ణసంఖ్య | null | కేటాయించబడినప్పుడు కాల్ను నిర్వహించిన ఏజెంట్ |
agent_name | స్ట్రింగ్ | null | కేటాయించబడినప్పుడు కాల్ను నిర్వహించిన ఏజెంట్ |
direction | స్ట్రింగ్ | కాల్ ఆబ్జెక్ట్లో ఉన్నట్లుగా కాల్ దిశ |
status | స్ట్రింగ్ | కాల్ చేరుకున్న దశ; దిగువ పట్టికను చూడండి |
occurred_at | టైమ్స్టాంప్ | ఇది జరిగిన సమయం |
hold_seconds | పూర్ణసంఖ్య | null | off_holdకు మాత్రమే: హోల్డ్ ఎన్ని సెకన్లు కొనసాగిందో. ఇతర ప్రతి స్థితికి null |
status | ఇది ఎప్పుడు పంపబడుతుంది |
|---|---|
dialing | అవుట్బౌండ్ కాల్లు: ThunderPhone కాల్ను ప్రారంభిస్తోంది. కాల్ను తిరస్కరించగల ప్రతి తనిఖీ పూర్తయిన తర్వాత, డయల్ క్యారియర్కు వెళ్లే ముందు వెంటనే పంపబడుతుంది. డ్యాష్బోర్డ్ నుండి ప్రారంభించిన టెస్ట్ కాల్లు దీన్ని పంపవు |
answered | అవుట్బౌండ్ కాల్లు: కాల్కు సమాధానం ఇచ్చినట్లు క్యారియర్ నివేదించింది. వాయిస్మెయిల్ బాక్స్ లేదా కాల్ స్క్రీనర్ సమాధానం ఇచ్చినా అది కూడా లెక్కలోకి వస్తుంది, కాబట్టి తర్వాత voicemail రావచ్చు. కాల్ ముగింపు నివేదిక ద్వారా మాత్రమే ThunderPhone సమాధానం గురించి తెలుసుకున్నప్పుడు, కాల్ ముగుస్తున్నప్పుడు answered పంపబడుతుంది |
voicemail | అవుట్బౌండ్ కాల్లు: ఏజెంట్ వాయిస్మెయిల్ బాక్స్ను చేరి, ఏజెంట్ యొక్క voicemail_action చెప్పినట్లుగా సందేశాన్ని వదిలి వెళ్తోంది లేదా కాల్ను ముగిస్తోంది. మెయిల్బాక్స్ నిర్ధారించబడినప్పుడు మాత్రమే పంపబడుతుంది (దాని బీప్ లేదా సమాధానం లేకపోవడం ద్వారా), మొదటి అంచనాపై కాదు |
on_hold | ఏజెంట్ను హోల్డ్లో ఉంచారు మరియు అది నిశ్శబ్దంగా వేచి ఉంది (wait_on_hold టూల్) |
off_hold | ఒక వ్యక్తి మళ్లీ లైన్లోకి వచ్చారు మరియు ఏజెంట్ మళ్లీ మాట్లాడుతోంది. హోల్డ్ ఎంతసేపు కొనసాగిందో hold_seconds తెలియజేస్తుంది |
ప్రతి కాల్ ప్రతి స్థితిని గరిష్ఠంగా ఒక్కసారి పంపుతుంది, అయితే on_hold మరియు off_hold
మాత్రం ప్రతి హోల్డ్కు ఒక్కసారి పంపబడతాయి. హోల్డ్లో వేచి ఉండే ఒక సాధారణ అవుట్బౌండ్ కాల్
dialing, answered, on_hold, off_hold, ఆపై
ముగిసినప్పుడు telephony.complete పంపుతుంది.
రింగ్ అవుతున్నట్లు నివేదించబడదు: క్యారియర్ రింగ్ సిగ్నల్ ఇస్తుందా అనేది విశ్వసించలేనంతగా మారుతూ ఉంటుంది. ఏజెంట్ యొక్క prompt, ThunderPhone కాకుండా, వాయిస్మెయిల్బాక్స్లో ఏమి చేయాలో నిర్ణయించే కొద్ది voicemail_action: "prompt" కాల్లలో, voicemail స్థితి పంపబడదు; telephony.completeలోని answered_by మాత్రం ఇప్పటికీ voicemail అని సూచిస్తుంది. పేలోడ్లలో ట్రాన్స్క్రిప్ట్, ఫోన్ నంబర్లు లేదా వేరియబుల్లు ఉండవు కాబట్టి, రికార్డింగ్ ఆఫ్ చేసిన కాల్లకు కూడా call.status_changed పంపబడుతుంది.
SMS ఈవెంట్లు
SMS ఈవెంట్లు సంస్థ కనెక్ట్ చేసిన Twilio లేదా Telnyx ఖాతా ద్వారా పంపిన సందేశాలను వివరిస్తాయి. సందేశం బాడీని చేర్చరు మరియు toను గోప్యంగా ఉంచుతారు. కంటెంట్ లేదా గ్రహీత అవసరమైనప్పుడు, సంస్థ-పరిధి సందేశాన్ని
GET /v1/sms/{message_id} నుండి పొందండి. సందేశం ఆబ్జెక్ట్లో ఉన్నట్లుగా, source అనేది api, agent_tool, followup
లేదా pre_call (కాల్ చేయడానికి ముందు క్యాంపెయిన్ పంపే టెక్స్ట్) అవుతుంది.
ప్రతి SMS ఈవెంట్లో scheduled_send_id ఉంటుంది: టెక్స్ట్ పంపబడిన షెడ్యూల్ చేసిన పంపకం యొక్క id లేదా షెడ్యూల్ చేయని టెక్స్ట్కు null. షెడ్యూల్ చేసిన టెక్స్ట్లకు source
"scheduled" ఉంటుంది.
sms.sent
కస్టమర్ క్యారియర్ అవుట్బౌండ్ SMS అభ్యర్థనను అంగీకరించినప్పుడు పంపబడుతుంది. ఇది హ్యాండ్సెట్ డెలివరీ రసీదు కాదు.
{
"data": {
"accepted_at": "2026-09-19T15:42:10.113Z",
"agent_id": 12,
"call_id": 987654321,
"created_at": "2026-09-19T15:42:09.901Z",
"direction": "outbound",
"error_code": null,
"error_message": null,
"from_number": "+15551234567",
"id": "313a3117-827b-46e9-a01a-ac1493838724",
"provider": "twilio",
"provider_id": "SM0123456789abcdef0123456789abcdef",
"scheduled_send_id": null,
"segment_count": 1,
"source": "agent_tool",
"status": "accepted",
"to": "[REDACTED]"
},
"event_id": "0ae347b4-1716-45bb-9a0e-b52373586e37",
"type": "sms.sent"
}sms.failed
శాశ్వత క్యారియర్ తిరస్కరణ తర్వాత, తాత్కాలిక పునఃప్రయత్నాలు ముగిసిన తర్వాత, ఫలితం తుది స్థాయిలో తెలియనప్పుడు, లేదా Twilio ఆమోదించబడిన సందేశం బట్వాడా కాలేదని లేదా విఫలమైందని నివేదించినప్పుడు పంపబడుతుంది. చివరి సందర్భంలో సందేశం యొక్క sms.sent ఇప్పటికే పంపబడింది, మరియు status "accepted"గానే ఉంటుంది. error_code స్థిరమైన ThunderPhone కోడ్, మరియు error_message అందుబాటులో ఉన్నప్పుడు కస్టమర్ చేయాల్సిన చర్యను తెలియజేస్తుంది. status: "unknown" అంటే క్యారియర్ SMSను ఆమోదించి ఉండవచ్చు; ThunderPhone దానిని స్వయంచాలకంగా మళ్లీ పంపదు కాబట్టి క్యారియర్ లాగ్లో దాన్ని సరిచూసుకోండి.
sms.received
ఇన్బౌండ్ SMS మద్దతు కోసం రిజర్వ్ చేయబడింది. ప్రస్తుత విడుదలలో ఎటువంటి
sms.received ఈవెంట్లు విడుదల కావు. ఇన్బౌండ్ క్యారియర్ వెబ్హుక్ కాన్ఫిగరేషన్
మరియు సిగ్నేచర్ ధృవీకరణ విడిగా విడుదల అవుతాయి.
షెడ్యూల్ చేసిన ఈవెంట్లు
పంపబడని షెడ్యూల్ చేసిన పంపింపులు ఈ
ఈవెంట్లలో ఒకదాన్ని ట్రిగ్గర్ చేస్తాయి. పంపబడిన పంపింపు బదులుగా సాధారణ ఈవెంట్లను ట్రిగ్గర్ చేస్తుంది: టెక్స్ట్ కోసం scheduled_send_id సెట్ చేసిన
sms.* ఈవెంట్లు, కాల్ కోసం కాల్ ఈవెంట్లు, దాని telephony.completeలో
scheduled_send_idతో. రెండూ నాన్-బ్లాకింగ్. పంపింపులో ఏజెంట్ ఉన్నప్పుడు, ఆ ఏజెంట్కు సంబంధించిన
ఏజెంట్-స్కోప్డ్ ఎండ్పాయింట్లు కూడా వాటిని స్వీకరిస్తాయి.
పేలోడ్లో ఐడీలు, స్థితి, సమయాలు మాత్రమే ఉంటాయి: టెక్స్ట్ బాడీ లేదా కాల్
వేరియబుల్స్ లేదా కాంటెక్స్ట్ ఎప్పుడూ ఉండవు, అలాగే to రీడాక్ట్ చేయబడుతుంది. మిగిలిన వాటి కోసం
GET /v1/scheduled/{id}ను పొందండి.
scheduled.skipped
పంపింపును ఉద్దేశపూర్వకంగా పంపనప్పుడు పంపబడుతుంది. reason విలువ expired (expires_atకు ముందు
పంపడం సాధ్యపడలేదు), opted_out (పంపింపు సృష్టించిన తర్వాత జోడించిన దానితో సహా నంబర్
ఆప్ట్-అవుట్ జాబితాలో ఉంది), quiet_hours (గ్రహీత
సమయ మండలంలో ఉదయం 8 గంటల నుండి రాత్రి 9 గంటల మధ్య కాకుండా ఇది గడువుకు వచ్చింది),
sender_not_ready (టెక్స్ట్ నంబర్ ఇకపై పంపలేకపోతుంది) లేదా
outbound_tcpa_unconfirmed (సంస్థ యొక్క TCPA నిర్ధారణ నమోదు కావడానికి ముందే ఒక కాల్ గడువుకు వచ్చింది).
{
"data": {
"agent_id": null,
"created_at": "2026-11-01T18:02:11.204Z",
"detail": "The send could not go out before its expires_at, so it was not sent late.",
"expires_at": "2026-11-03T17:30:00Z",
"external_id": "appointment-4815",
"from_number": "+15551234567",
"id": "6f1c0b8e-3a52-4c1f-9a0b-2f4f7d8a91c3",
"reason": "expired",
"send_at": "2026-11-03T17:00:00Z",
"source": "api",
"status": "skipped",
"to": "[REDACTED]",
"type": "sms"
},
"event_id": "2b0f6c43-74c9-4d43-a1f4-0d6a2f8e51a7",
"type": "scheduled.skipped"
}scheduled.failed
ThunderPhone పంపడానికి ప్రయత్నించినా అది పంపబడనప్పుడు పంపబడుతుంది. reason అనేది
పంపడానికి సంబంధించిన లోపం: టెక్స్ట్ కోసం carrier_rejected వంటి ఒక SMS లోపం కోడ్,
లేదా బ్లాక్ చేయబడిన గమ్యస్థాన నియమం (premium_rate, ఉదాహరణకు) లేదా
agent_deleted వంటి కాల్ నిరాకరణ లేదా వైఫల్య కారణం. పేలోడ్లో scheduled.skippedకు ఉన్నట్లే
ఫీల్డ్లు ఉంటాయి.
| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
id | స్ట్రింగ్ | షెడ్యూల్ చేసిన పంపిణీ యొక్క id |
type | స్ట్రింగ్ | sms లేదా call |
status | స్ట్రింగ్ | skipped లేదా failed |
reason | స్ట్రింగ్ | ఎందుకు అనేది, పైన పేర్కొన్నట్లుగా; పంపిణీ యొక్క status_reasonకు సమానమైన విలువ |
detail | స్ట్రింగ్ | చదవగలిగే వివరణ |
source | స్ట్రింగ్ | పంపిణీని సృష్టించినది: api |
external_id | స్ట్రింగ్ | null | పంపిణీ కోసం మీ కీ, లేదా null |
from_number | స్ట్రింగ్ | పంపే నంబర్ |
to | స్ట్రింగ్ | ఎల్లప్పుడూ "[REDACTED]" |
agent_id | పూర్ణసంఖ్య | null | కాల్లు: ఏజెంట్; టెక్స్ట్లు: null |
send_at, expires_at, created_at | టైమ్స్టాంప్ | ISO 8601 |
వాయిస్ ఈవెంట్లు
కస్టమ్ వాయిస్ సృష్టి అసమకాలికం. ఈ నాన్-బ్లాకింగ్ ఈవెంట్లు క్లోన్ వివరాల ఎండ్పాయింట్ను పోలింగ్ చేయడానికి బదులుగా, అంతిమ ఫలితానికి ప్రతిస్పందించడానికి మిమ్మల్ని అనుమతిస్తాయి.
voice.ready మరియు voice.failedలు events: [] ఉన్న సంస్థ-వ్యాప్త
ఎండ్పాయింట్కు మాత్రమే డెలివర్ చేయబడతాయి. వాటిని స్పష్టమైన ఈవెంట్ ఫిల్టర్లుగా
ఎంచుకోలేరు.
voice.ready
కస్టమ్ వాయిస్ ప్రాసెసింగ్ పూర్తయ్యి, ఏజెంట్కు కేటాయించగలిగినప్పుడు పంపబడుతుంది.
{
"data": {
"voice": {
"created_at": "2026-07-30T14:12:08.317Z",
"display_name": "Support voice",
"failure_reason": "",
"gender": "female",
"id": "cv_2f6f90b0e9a34ee8b39be7d1",
"language": "en",
"name": "custom:cv_2f6f90b0e9a34ee8b39be7d1",
"status": "ready",
"updated_at": "2026-07-30T14:13:31.605Z"
}
},
"event_id": "2d5f0a61-e9b5-4a3c-b684-29d7d9e4b214",
"type": "voice.ready"
}voice.failed
కస్టమ్ వాయిస్ ప్రాసెసింగ్ శాశ్వత వైఫల్యానికి చేరుకున్నప్పుడు పంపబడుతుంది.
{
"data": {
"reason": "audio sample could not be processed",
"voice": {
"created_at": "2026-07-30T14:12:08.317Z",
"display_name": "Support voice",
"failure_reason": "audio sample could not be processed",
"gender": "female",
"id": "cv_2f6f90b0e9a34ee8b39be7d1",
"language": "en",
"name": "custom:cv_2f6f90b0e9a34ee8b39be7d1",
"status": "failed",
"updated_at": "2026-07-30T14:13:31.605Z"
}
},
"event_id": "3493e985-1a75-4f77-a10a-e74af440cd31",
"type": "voice.failed"
}| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
voice.id | స్ట్రింగ్ | కస్టమ్ వాయిస్ పబ్లిక్ ఐడి |
voice.name | స్ట్రింగ్ | custom:<public_id> రూపంలోని ఏజెంట్ వాయిస్ విలువ |
voice.display_name | స్ట్రింగ్ | సంస్థకు కనిపించే వాయిస్ పేరు |
voice.language | స్ట్రింగ్ | క్లోన్ యొక్క ఏకైక భాషా కోడ్ |
voice.gender | స్ట్రింగ్ | male, female, లేదా ఖాళీ స్ట్రింగ్ |
voice.status | స్ట్రింగ్ | voice.ready కోసం ready; voice.failed కోసం failed |
voice.failure_reason | స్ట్రింగ్ | విజయవంతమైనప్పుడు ఖాళీ; వైఫల్యమైనప్పుడు ప్రాసెసింగ్ వైఫల్య వివరాలు |
voice.created_at, voice.updated_at | టైమ్స్టాంప్ | ISO 8601 టైమ్స్టాంప్లు |
reason | స్ట్రింగ్ | వైఫల్య వివరాలు; voice.failedలో మాత్రమే ఉంటుంది |
నాణ్యత ఈవెంట్లు
call.graded
కాల్కు సంబంధించిన AI గ్రేడింగ్ రన్ పూర్తయినప్పుడల్లా పంపబడుతుంది. బ్లాకింగ్ కాదు.
{
"data": {
"call_id": 987654321,
"grade": {
"call_outcome": "success",
"created_at": "2026-04-20T18:25:11.002Z",
"detected_issues": [],
"graded_at": "2026-04-20T18:25:11.002Z",
"grader_model": "heuristic-v1",
"id": 5512,
"score": 92,
"status": "completed",
"summary": "Caller asked about their policy and got a full answer…"
},
"report": null
},
"event_id": "7c1d2e3f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
"type": "call.graded"
}| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
agent_id | integer | null | కేటాయించబడినప్పుడు కాల్ను నిర్వహించిన ఏజెంట్ |
agent_name | string | null | కేటాయించబడినప్పుడు కాల్ను నిర్వహించిన ఏజెంట్ |
grade.id | integer | గ్రేడ్ ఐడి |
grade.score | integer | null | 0–100 |
grade.call_outcome | string | success, failure, unknown, లేదా no_conversation |
grade.summary | string | ఒక పేరాగ్రాఫ్ సారాంశం |
grade.detected_issues | array | గ్రేడర్ గుర్తించిన సమస్య స్ట్రింగ్లు |
grade.status | string | ఎల్లప్పుడూ completed — పూర్తైన రన్లు మాత్రమే పంపుతాయి |
grade.grader_model | string | ఫలితాన్ని రూపొందించిన గ్రేడర్: శీఘ్ర తాత్కాలిక గ్రేడ్ కోసం heuristic-v1 (లేదా మరొక ThunderPhone నియమాధారిత గ్రేడర్), పూర్తి గ్రేడ్ కోసం thunderphone-grader. ఇది ThunderPhone లేబుల్, AI మోడల్ పేరు కాదు |
grade.graded_at, grade.created_at | timestamp | |
report | object | null | కస్టమర్కు కనిపించే కాల్ నివేదిక: ఫలిత లేబుల్, శ్రద్ధ అవసరం ఫ్లాగ్ మరియు కారణం, కాలర్, ఒక-లైన్ సారాంశం, కాలర్ అనుభవం. ప్రారంభ హ్యూరిస్టిక్ గ్రేడ్లో ఇది null లేదా ఫీల్డ్లు ప్లేస్హోల్డర్లుగా ఉన్న pending నివేదికగా ఉంటుంది; పూర్తి గ్రేడ్ ఈవెంట్ పూర్తయిన దానిని కలిగి ఉంటుంది |
call.data_extracted
POST /v1/calls/{call_id}/extract
ద్వారా telephony.complete / web.complete తర్వాత ఆలస్యమైన రీట్రై లేదా మాన్యువల్ రీ-రన్తో సహా,
నిర్మిత డేటా ఎక్స్ట్రాక్షన్ విజయవంతంగా పూర్తయినప్పుడల్లా పంపబడుతుంది.
బ్లాకింగ్ కాదు.
బ్లాకింగ్ ఎక్స్ట్రాక్షన్ మోడ్లో, పూర్తి ఈవెంట్ సాధారణంగా 75-సెకన్ల
ఎక్స్ట్రాక్షన్ బడ్జెట్ కంటే ఎక్కువ వేచి ఉండదు. ఎక్స్ట్రాక్షన్ వర్కర్ ప్రాసెస్
పోయినట్లయితే, ప్రొడక్షన్ ఫైనలైజేషన్ డ్రెయిన్ (ప్రతి ఐదు నిమిషాలకు) మరో
ఎక్స్ట్రాక్షన్ ప్రయత్నాన్ని ప్రారంభించే ముందు blocking_deadline_at దాటిపోయిన
పూర్తిని విడుదల చేస్తుంది. తర్వాతి విజయం ఈ ఈవెంట్గా విడిగా అందించబడుతుంది.
{
"data": {
"call_id": 987654321,
"agent_id": 12,
"agent_name": "Acme intake",
"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..."
},
"extracted_at": "2026-04-20T18:25:11.002Z",
"model": "thunderphone-extractor",
"summary": "Alex Morgan called to book a follow-up visit and confirmed Thursday, April 23."
},
"event_id": "4d79ef1d-c2b1-4ed6-85b8-8326bd2895ef",
"type": "call.data_extracted"
}| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
agent_id | పూర్ణసంఖ్య | null | ఏజెంట్ కేటాయించబడినప్పుడు, కాల్ను నిర్వహించిన ఏజెంట్ |
agent_name | స్ట్రింగ్ | null | ఏజెంట్ కేటాయించబడినప్పుడు, కాల్ను నిర్వహించిన ఏజెంట్ |
summary | స్ట్రింగ్ | null | ఏజెంట్లో కాల్ సారాంశాన్ని రూపొందించు ప్రారంభించబడి ఉన్నప్పుడు పూర్తయిన కాల్ సారాంశం, కాబట్టి ఆలస్యమైన ఎక్స్ట్రాక్షన్ ఈవెంట్ కూడా పూర్తయ్యే సమయ పరిమితిని దాటిన సారాంశాన్ని అందిస్తుంది; ఇతర సందర్భాల్లో null. సారాంశం ఉన్నప్పటికీ ఎక్స్ట్రాక్షన్ ఫీల్డ్లు లేని ఏజెంట్లు ఈ ఈవెంట్ను ఎప్పుడూ పంపవు: ఆలస్యమైన సారాంశాన్ని GET /v1/calls/{call_id} నుండి చదవండి |
extracted_data.status | స్ట్రింగ్ | ఈ ఈవెంట్కు ఎల్లప్పుడూ completed |
extracted_data.fields | ఆబ్జెక్ట్ | కాన్ఫిగర్ చేసిన ఎక్స్ట్రాక్షన్ ఫీల్డ్ కీల ద్వారా సూచిక చేయబడిన విలువలు; అందుబాటులో లేని విలువలు null |
extracted_data.evidence | ఆబ్జెక్ట్ | ఎక్స్ట్రాక్షన్ ఫీల్డ్ ద్వారా సూచిక చేయబడిన సాక్ష్యం. null కాని విలువలో ఖచ్చితమైన నిర్మాణాత్మకంగా తనిఖీ చేసిన కోట్ ఉంటుంది (గరిష్ఠంగా 1,000 అక్షరాలు), speaker_role (caller లేదా agent), మరియు turn_index; మోడల్ తిరిగి ఇచ్చిన పొడవైన కోట్లు కుదించబడకుండా తిరస్కరించబడతాయి, అలాగే దాని ఫీల్డ్ null అయినప్పుడల్లా సాక్ష్యం null అవుతుంది |
extracted_data.verification | స్ట్రింగ్ | ప్రతి అభ్యర్థి ఫీల్డ్కు స్వతంత్ర సాక్ష్య తనిఖీ ఖచ్చితంగా ఒక చెల్లుబాటు అయ్యే తీర్పును తిరిగి ఇచ్చినప్పుడు మాత్రమే verified. తనిఖీ విఫలమైనప్పుడు, సమయం ముగిసినప్పుడు, తగిన బడ్జెట్ లేనప్పుడు లేదా తప్పుగా రూపొందిన లేదా పాక్షిక అవుట్పుట్ను తిరిగి ఇచ్చినప్పుడు unavailable అని అర్థం. పూర్తిగా అందుబాటులో లేని తనిఖీ కస్టమర్ సమీక్ష కోసం నిర్మాణాత్మకంగా ఆధారపడిన విలువలను భద్రపరుస్తుంది. పాక్షిక అవుట్పుట్ కోసం, చెల్లుబాటు అయ్యే తీర్పులు వర్తింపజేయబడతాయి మరియు ఖచ్చితంగా ఒక చెల్లుబాటు అయ్యే తీర్పు లేని ప్రతి అభ్యర్థి విలువను null చేస్తారు |
extracted_data.field_reasons | ఆబ్జెక్ట్ | నిర్మాణాత్మక ఆధారం లేదా స్వతంత్ర వెరిఫైయర్ ద్వారా null చేసిన ఫీల్డ్ల ద్వారా సూచిక చేయబడిన కారణాలు |
extracted_data.schema_version | స్ట్రింగ్ | ఈ ఎక్స్ట్రాక్షన్ కోసం ఉపయోగించిన ఖచ్చితమైన ఫీల్డ్ స్కీమా హ్యాష్ |
extracted_at | టైమ్స్టాంప్ | ISO 8601 పూర్తయ్యే సమయం |
model | స్ట్రింగ్ | ఎల్లప్పుడూ thunderphone-extractor: ఎక్స్ట్రాక్షన్ మోడల్కు ThunderPhone లేబుల్, AI మోడల్ పేరు కాదు |
campaign.completed
క్యాంపెయిన్ running నుంచి completed కు మారినప్పుడు ఒకసారి పంపబడుతుంది, దాని
షెడ్యూల్ ముగిసినా లేదా అన్ని కాంటాక్ట్లు టెర్మినల్ స్థితులకు చేరుకున్నా సరే.
రన్నర్ రీట్రైలు మరో ఈవెంట్ను పంపవు. ఈ సంస్థ-స్థాయి జీవితచక్ర ఈవెంట్
సంస్థ-స్కోప్ ఎండ్పాయింట్లకు మాత్రమే అందించబడుతుంది, ఏజెంట్-స్కోప్
ఎండ్పాయింట్లకు కాదు. బ్లాకింగ్ కాదు.
{
"data": {
"campaign_id": "3f6b2c9e-2a0d-4c63-b6d6-a708dc98f403",
"name": "May win-back",
"agent_id": 12,
"status": "completed",
"started_at": "2026-04-20T17:00:00Z",
"completed_at": "2026-04-20T18:25:11Z",
"counts": {
"contacts_total": 150,
"completed": 121,
"failed": 11,
"no_answer": 18,
"skipped": 4,
"remaining": 0
}
},
"event_id": "8d8f52ce-6b46-423f-9dde-cea0b91ec135",
"type": "campaign.completed"
}నాలుగు ఫలితాల కౌంట్లు పరస్పరం వేర్వేరుగా ఉంటాయి మరియు వాటి మొత్తం contacts_totalకు సమానం:
completed విజయవంతమైన కాంటాక్ట్లను కలిగి ఉంటుంది; no_answer తుది ఫలితం సమాధానం లేకపోవడం అయిన ముగిసిన విఫలమైన/ప్రయత్నాలు పూర్తయిన కాంటాక్ట్లను కలిగి ఉంటుంది; failed ఇతర అన్ని ముగిసిన విఫలమైన/ప్రయత్నాలు పూర్తయిన కాంటాక్ట్లను కలిగి ఉంటుంది; మరియు remaining పెండింగ్లో ఉన్న, షెడ్యూల్ చేసిన లేదా ప్రస్తుతం కాల్ చేస్తున్న కాంటాక్ట్లను కలిగి ఉంటుంది. మళ్లీ ప్రయత్నం కోసం వేచి ఉన్న కాంటాక్ట్, దాని ఇటీవలి ప్రయత్నంలో సమాధానం రాకపోయినా, remainingగానే ఉంటుంది. ఒక్కసారి మాత్రమే తీసే పూర్తి స్నాప్షాట్కు ముందు కొనసాగుతున్న కాల్లు సరిచేయబడతాయి. started_at కాన్ఫిగర్ చేసిన క్యాంపెయిన్ ప్రారంభ సమయం లేదా ప్రారంభ సమయాన్ని కాన్ఫిగర్ చేయనప్పుడు క్యాంపెయిన్ సృష్టించిన సమయం. skipped ఐదవ విభాగం కాదు: కాల్ చేయకుండా నంబర్-టైప్ ఫిల్టర్ ముగించిన failedలోని కాంటాక్ట్లను ఇది లెక్కిస్తుంది.
issue.reported
సమస్య నివేదిక సృష్టించబడినప్పుడు పంపబడుతుంది —
డ్యాష్బోర్డ్ నుంచి వినియోగదారు సమర్పించినా (source: "user") లేదా కాల్ గ్రేడింగ్
ద్వారా స్వయంచాలకంగా సృష్టించబడినా (source: "system"). బ్లాకింగ్ కాదు.
{
"data": {
"call_id": 987654321,
"issue_report": {
"created_at": "2026-04-20T18:25:11.002Z",
"description": "Five-second silence before responding to the main question.",
"id": 4321,
"severity": "warning",
"source": "system",
"status": "open",
"title": "Agent paused too long"
}
},
"event_id": "5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b",
"type": "issue.reported"
}| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
agent_id | integer | null | ఏజెంట్ కేటాయించబడినట్లయితే, కాల్ను నిర్వహించిన ఏజెంట్ |
agent_name | string | null | ఏజెంట్ కేటాయించబడినట్లయితే, కాల్ను నిర్వహించిన ఏజెంట్ |
issue_report.severity | string | critical, warning, లేదా info |
issue_report.status | string | open లేదా resolved |
issue_report.source | string | user (డ్యాష్బోర్డ్ నుంచి సమర్పించబడింది) లేదా system (గ్రేడింగ్ ద్వారా సృష్టించబడింది) |
issue.escalated
సిబ్బంది సమీక్ష కోసం సమస్య నమూనాను ThunderPhoneకు పంపినప్పుడు పంపబడుతుంది: ThunderPhoneకు నివేదించండి తర్వాత లేదా Fix with AI కస్టమర్-వైపు పరిష్కారాన్ని నిర్ధారించలేక సమస్యను స్వయంచాలకంగా రూట్ చేసినప్పుడు. సంస్థ-వ్యాప్తంగా ఉండే ఎండ్పాయింట్లు మాత్రమే ఈ ఈవెంట్ను స్వీకరిస్తాయి.
{
"data": {
"automatic": false,
"cluster_id": "7ac2844c-2df0-4fa8-a560-7378da649e19",
"escalation_id": "ec99f52b-c8c0-41dd-a4f2-dd8a07b10894",
"status": "open"
},
"event_id": "d8f8f420-7a42-45ba-bcf1-b747f9bbecda",
"type": "issue.escalated"
}| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
automatic | boolean | స్వయంచాలక ఎస్కలేషన్కు true; మాన్యువల్ ఎస్కలేషన్కు false |
cluster_id | UUID | ఎస్కలేట్ చేసిన సమస్య నమూనా |
escalation_id | UUID | ఎస్కలేషన్ రికార్డ్ |
status | string | ఈవెంట్ పంపబడినప్పుడు open |
ఇది నోటిఫికేషన్ మాత్రమే, సాక్ష్య బండిల్ కాదు. సమస్య నమూనాతో దీన్ని అనుసంధానించడానికి
cluster_id ఉపయోగించండి. ThunderPhoneకు నివేదించండి చూడండి.
టెస్ట్ కాల్ ఈవెంట్లు
test-call.completed
ఒక
టెస్ట్-కాల్ రన్
completed లేదా failed అనే అంతిమ స్థితికి చేరుకున్నప్పుడు పంపబడుతుంది. ఇందులో ప్రారంభంలోనే విఫలమై, ఎప్పుడూ కాల్ను సృష్టించని రన్లు కూడా ఉంటాయి. నాన్-బ్లాకింగ్. బ్యాచ్ CI రన్లను మీ చాట్/నోటిఫికేషన్ సిస్టమ్లతో అనుసంధానించడానికి ఉపయోగకరం.
{
"data": {
"test_call_run": {
"call_id": 987654321,
"completed_at": "2026-04-20T18:25:04.822Z",
"error_message": "",
"id": 7110,
"status": "completed",
"target_id": 12,
"target_type": "agent"
}
},
"event_id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
"type": "test-call.completed"
}| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
agent_id | integer | null | కేటాయించబడి ఉంటే, కాల్ను నిర్వహించిన ఏజెంట్ |
agent_name | string | null | కేటాయించబడి ఉంటే, కాల్ను నిర్వహించిన ఏజెంట్ |
test_call_run.target_type | string | agent లేదా phone_number |
test_call_run.target_id | integer | target_typeకు సరిపోలేలా, రన్ లక్ష్యంగా పెట్టుకున్న ఏజెంట్ id లేదా ఫోన్-నంబర్ id |
test_call_run.status | string | completed లేదా failed |
test_call_run.call_id | integer | null | కాల్ ప్రారంభించడానికి ముందు రన్ విఫలమైతే null |
test_call_run.error_message | string | విజయవంతమైనప్పుడు ఖాళీగా ఉంటుంది |
అలర్ట్ ఈవెంట్లు
alert.triggered
డెవలపర్ వెబ్హుక్లకు పంపండి ఛానెల్ ప్రారంభించబడిన ఒక అలర్ట్ నియమం దాని థ్రెషోల్డ్ను దాటినప్పుడు పంపబడుతుంది. నాన్-బ్లాకింగ్. ఒక నియమం ఒకసారి ట్రిగ్గర్ అయి, తర్వాత దాని కూల్డౌన్ను పాటిస్తుంది కాబట్టి, నిరంతర ఉల్లంఘన ప్రతి కూల్డౌన్ విండోకు ఒక ఈవెంట్ను ఉత్పత్తి చేస్తుంది.
{
"data": {
"comparator": "lt",
"event_id": "b8e6a1d4-2c3f-4a5b-9c8d-7e6f5a4b3c2d",
"fired_at": "2026-04-20T18:00:00+00:00",
"metric": "success_rate",
"metric_value": 71.4,
"rule_id": "d2c3b4a5-6f7e-4d8c-9b0a-1c2d3e4f5a6b",
"rule_name": "Success rate below 80%",
"threshold": 80.0,
"window_hours": 24
},
"event_id": "4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f7a",
"type": "alert.triggered"
}| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
event_id (dataలో) | UUID | అలర్ట్ ట్రిగ్గర్ అయిన id — ఎన్వలప్ డెలివరీ event_idకు భిన్నమైనది |
rule_id, rule_name | UUID, string | ట్రిగ్గర్ అయిన నియమం |
metric | string | success_rate, failure_rate, avg_score, call_volume, లేదా suite_regression |
comparator | string | lt, lte, gt, లేదా gte |
metric_value | number | నియమం ట్రిగ్గర్ అయినప్పుడు విండోలోని మెట్రిక్ విలువ |
threshold | number | కాన్ఫిగర్ చేసిన థ్రెషోల్డ్ |
window_hours | integer | ముగింపు మూల్యాంకన విండో |
fired_at | timestamp |
నియమాలు, మెట్రిక్లు, కూల్డౌన్లు, అలాగే ఇమెయిల్ / Slack ఛానెల్లను సృష్టించడానికి అలర్ట్ల గైడ్ చూడండి.
ఫోన్ నంబర్ ఈవెంట్లు
phone_number.spam_risk_changed
స్పామ్-లేబుల్ పర్యవేక్షణ (చెల్లింపు యాడ్-ఆన్; సపోర్ట్ ద్వారా అభ్యర్థనపై) పర్యవేక్షణలో ఉన్న నంబర్ స్పామ్ రిస్క్ medium లేదా highకి పెరిగినట్లు గుర్తించినప్పుడు పంపబడుతుంది (low నుంచి, ఇంకా రీడింగ్ లేని స్థితి నుంచి, లేదా medium నుంచి highకి). బ్లాకింగ్ కాదు. ఫ్లాగ్ చేయబడి అలాగే ఉన్న నంబర్కు మళ్లీ పంపబడదు; lowకి తిరిగి వచ్చి, తర్వాత మళ్లీ ఫ్లాగ్ చేయబడితే పంపబడుతుంది.
ఈ ఈవెంట్కు ఏజెంట్ సందర్భం ఉండదు కాబట్టి, సంస్థ-వ్యాప్త ఎండ్పాయింట్లు మాత్రమే దీన్ని స్వీకరిస్తాయి.
సంస్థ యజమానులు మరియు అడ్మిన్లకు కూడా ఇమెయిల్ అందుతుంది.
{
"data": {
"checked_at": "2026-10-21T14:41:07+00:00",
"phone_number": "+13125550100",
"phone_number_id": 412,
"previous_spam_risk": "low",
"scores": {
"connection": 31,
"engagement": 40,
"maturity": 82,
"sentiment": 22
},
"spam_category": "Telemarketer",
"spam_risk": "high"
},
"event_id": "6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f",
"type": "phone_number.spam_risk_changed"
}| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
phone_number | స్ట్రింగ్ | E.164లో ఉన్న నంబర్ |
phone_number_id | ఇంటిజర్ | నల్ | ఫోన్ నంబర్లులో దీని ఐడి |
spam_risk | స్ట్రింగ్ | medium లేదా high |
previous_spam_risk | స్ట్రింగ్ | నల్ | చివరి రీడింగ్లోని రిస్క్; మొదటి రీడింగ్కు ముందు null |
spam_category | స్ట్రింగ్ | నల్ | క్యారియర్లు చూపగల లేబుల్, ఉదాహరణకు Telemarketer లేదా Survey. దీన్ని ఫ్రీ టెక్స్ట్గా పరిగణించండి |
scores | ఆబ్జెక్ట్ | ఒక్కోదానికి 0 నుంచి 100 వరకు, లేదా తగిన కాల్ వాల్యూం వచ్చే వరకు null: maturity (నంబర్ ఎంతకాలంగా స్థిరంగా ఉంది), connection (ప్రజలు సమాధానం ఇస్తారా), engagement (వారు కాల్లో కొనసాగుతారా), sentiment (వారు దాన్ని బ్లాక్ చేస్తారా లేదా రిపోర్ట్ చేస్తారా) |
checked_at | టైమ్స్టాంప్ | ThunderPhone ఫలితాన్ని చదివిన సమయం |
మైగ్రేషన్ ఈవెంట్లు
migration.call.complete
POST /v1/migrations/{id}/calls ద్వారా ప్రారంభించిన కాల్ను ఏ ప్లాట్ఫారమ్ నిర్వహించినా, అది ముగిసినప్పుడు పంపబడుతుంది. ఇది బ్లాకింగ్ కాదు. కాల్ ముగిసిన తర్వాత సుమారు 5 నిమిషాల వరకు ఆలస్యంగా అందవచ్చు. dataలో
telephony.completeలోని ప్రతి ఫీల్డ్తో పాటు migration బ్లాక్ ఉంటుంది. ThunderPhone ప్రారంభించిన కాల్ కూడా అదే call_idతో సాధారణంగా telephony.completeను పంపుతుంది. ఇతర ప్లాట్ఫారమ్ నిర్వహించిన కాల్కు answered_by విలువ nullగా ఉంటుంది. ఇతర ప్లాట్ఫారమ్లోని కాల్ 2
గంటల తర్వాత కూడా ముగియకపోయినా, లేదా దాని మైగ్రేషన్ ముందుగా పూర్తయినా లేదా దాని కీని కోల్పోయినా, అది
status: "unknown"తో మరియు ట్రాన్స్క్రిప్ట్ లేకుండా పంపబడుతుంది.
{
"data": {
"agent_id": 42,
"agent_name": "Front desk",
"answered_by": null,
"billable_minutes": null,
"billing_total_cents": null,
"call_id": null,
"direction": "outbound",
"duration_seconds": 94,
"end_reason": "user_hangup",
"end_time": "2026-10-06T17:01:34+00:00",
"extracted_data": null,
"from_number": "+15551234567",
"migration": {
"arm": "vendor",
"id": "5f0c2a9e-7b1d-4c3e-8a6f-2d9e1b4c7a30",
"metadata": {
"lead_id": "8812"
},
"routing_id": "9b2f8c1e-4d3a-4f6b-8e2d-1a7c5b9e0f34",
"vendor": "retell",
"vendor_call_id": "call_6a1f0e",
"vendor_cost_usd": "0.1240"
},
"product": "",
"recording_mode": "vendor",
"recording_url": "https://…",
"start_time": "2026-10-06T17:00:00+00:00",
"status": "completed",
"summary": "The callee booked a table for two on Thursday.",
"thunderphone_retained_call_content": true,
"to_number": "+14155552671",
"transcripts": [
{
"content": "Hi Ada, this is Rosa's calling about your booking.",
"role": "agent"
},
{
"content": "Yes, Thursday works.",
"role": "user"
}
],
"transfer_number": null,
"unresolved_variables": [],
"variables": {
"first_name": "Ada"
},
"voice": ""
},
"event_id": "7c1e2f3a-4b5c-4d6e-8f7a-9b0c1d2e3f4a",
"type": "migration.call.complete"
}| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
migration.id | UUID | మైగ్రేషన్ |
migration.routing_id | UUID | మీరు కాల్ చేసినప్పుడు తిరిగి వచ్చిన రూట్ చేసిన కాల్ |
migration.arm | string | ours (ThunderPhone కాల్ చేసింది) లేదా vendor (ఇతర ప్లాట్ఫారమ్ చేసింది) |
migration.vendor | string | retell, vapi, elevenlabs, లేదా bland |
migration.vendor_call_id | string | null | ఇతర ప్లాట్ఫారమ్ కాల్ ఐడి; oursకు null |
migration.metadata | object | కాల్ చేసినప్పుడు మీరు పంపిన metadata |
migration.vendor_cost_usd | string | null | ఇతర ప్లాట్ఫారమ్ నివేదించిన కాల్ ఖర్చు, అది నివేదించినప్పుడు |
call_id | integer | null | ThunderPhone కాల్ ఐడి; vendorకు null |
status | string | vendor కోసం: కాల్ స్వీకరించిన వ్యక్తి మాట్లాడినప్పుడు completed, మాట్లాడనప్పుడు failed, పైన వివరించినట్లుగా unknown. ours కోసం: telephony.completeలో ఉన్నట్లుగా |
vendor కాల్కు ThunderPhone వద్ద బిల్లింగ్ లేదా ఎక్స్ట్రాక్షన్ డేటా ఉండదు:
billable_minutes, billing_total_cents, మరియు extracted_data విలువలు null,
product మరియు voice ఖాళీగా ఉంటాయి, recording_mode విలువ vendorగా ఉంటుంది, మరియు
recording_url అనేది ఇతర ప్లాట్ఫారమ్ లింక్ను అందించినప్పుడు దాని లింక్గా ఉంటుంది.
migration.rollback
మైగ్రేషన్ యొక్క క్రమానుగత మార్పిడి స్వయంచాలకంగా ప్రతి కాల్ను తిరిగి ఇతర ప్లాట్ఫామ్కు మళ్లించినప్పుడు పంపబడుతుంది: 15 నిమిషాల్లో 3 కాల్లు ThunderPhoneకు కనెక్ట్ కావడంలో విఫలమైనప్పుడు, ThunderPhoneకు పంపిన 2 కాల్లు ఏజెంట్ సమాధానం ఇవ్వకముందే ముగిసినప్పుడు, లేదా ThunderPhone టాస్క్ ఫలిత రేటు ఇతర ప్లాట్ఫామ్ కంటే కాన్ఫిగర్ చేసిన వ్యత్యాసాన్ని మించి తగ్గినప్పుడు. బ్లాక్ చేయనిది, ప్రతి రోల్బ్యాక్కు ఒకసారి. దీని తర్వాత, ThunderPhone వాటా 0% అవుతుంది మరియు ఎవరైనా ఏజెంట్ యొక్క మైగ్రేషన్ ట్యాబ్లో దాన్ని పునఃప్రారంభించే వరకు మైగ్రేషన్ పాజ్లో ఉంటుంది. పేలోడ్లో ఫోన్ నంబర్లు, ట్రాన్స్క్రిప్ట్లు లేదా కాల్ IDలు ఉండవు.
{
"data": {
"agent_id": 42,
"agent_name": "Front desk",
"dropped": 0,
"migration_id": "5f0c2a9e-7b1d-4c3e-8a6f-2d9e1b4c7a30",
"ours": {
"graded": 20,
"success_rate": 0.8
},
"ours_failed": 3,
"ours_percent": 0,
"previous_percent": 25,
"reason": "ours_failed_burst",
"rolled_back_at": "2026-10-10T12:05:00+00:00",
"step": 1,
"theirs": {
"graded": 20,
"success_rate": 0.8
},
"vendor": "retell"
},
"event_id": "3d1f6b2a-8c4e-5a7b-9d0e-2f1a3b4c5d6e",
"type": "migration.rollback"
}| ఫీల్డ్ | రకం | వివరణ |
|---|---|---|
migration_id | UUID | మైగ్రేషన్ |
vendor | స్ట్రింగ్ | retell, vapi, elevenlabs, లేదా bland |
reason | స్ట్రింగ్ | ours_failed_burst (15 నిమిషాల్లో 3 విఫల కనెక్షన్లు), dropped_calls (30 నిమిషాల్లో ఏజెంట్ సమాధానం ఇవ్వకముందే ముగిసిన 2 కాల్లు), లేదా rate_gap (ప్రతి వైపున కనీసం rollback_min_calls గ్రేడ్ చేసిన కాల్లపై టాస్క్ ఫలిత రేటు వ్యత్యాసం) |
previous_percent | పూర్ణాంకం | రోల్బ్యాక్కు ముందు ThunderPhone కాల్ల వాటా |
ours_percent | పూర్ణాంకం | ఎల్లప్పుడూ 0 |
step | పూర్ణాంకం | null | అది ఉన్న షెడ్యూల్ దశ (0-ఆధారితం) |
ours / theirs | ఆబ్జెక్ట్ | null | ప్రస్తుత దశలో గ్రేడ్ చేసిన కాల్లు మరియు వాటి విజయ రేటు; దశలో కాల్లు చాలా తక్కువగా ఉన్నప్పుడు theirs గత 30 రోజులది కావచ్చు. ఏవీ లేనప్పుడు null |
ours_failed | పూర్ణాంకం | గత 15 నిమిషాల్లో లెక్కించిన విఫల కనెక్షన్లు |
dropped | పూర్ణాంకం | గత 30 నిమిషాల్లో డ్రాప్ అయినవిగా లెక్కించిన కాల్లు |
rolled_back_at | టైమ్స్టాంప్ |
సంబంధితవి
మీరు ప్రతిస్పందించాల్సిన బ్లాకింగ్ ఇన్బౌండ్-కాల్ పేలోడ్.
కాల్ తర్వాత ట్రాన్స్క్రిప్ట్ మరియు మెట్రిక్లు.
ఈ ఈవెంట్లలోని ఒక ఉపసమితికి URLను సబ్స్క్రైబ్ చేయండి.
telephony.tool / web.tool ఈవెంట్లు ఎలా రూపొందించబడతాయి.