ThunderPhone v3 లైవ్‌లోకి వచ్చింది.మీరే ప్రారంభించవచ్చు—నిమిషానికి 2¢ నుంచి.ప్రకటనను చదవండి

Webhooks

ఈవెంట్ల కేటలాగ్

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_idintegerట్రాన్స్‌ఫర్ చేయబడిన కాల్
agent_idinteger | nullకేటాయించబడి ఉంటే, కాల్‌ను నిర్వహించిన ఏజెంట్
agent_namestring | nullకేటాయించబడి ఉంటే, కాల్‌ను నిర్వహించిన ఏజెంట్
transfer_outcomestringrefer_accepted: క్యారియర్ కాల్ బాధ్యతను స్వీకరించింది. bridged: క్యారియర్ కోల్డ్ ట్రాన్స్‌ఫర్‌ను తిరస్కరించినందున లేదా వార్మ్ ట్రాన్స్‌ఫర్‌లోని ఏజెంట్ వైదొలిగినందున, ThunderPhone కాలర్‌ను మరియు గమ్యస్థానాన్ని స్వయంగా కనెక్ట్ చేసి ఉంచింది. bridge_unanswered: క్యారియర్ కోల్డ్ ట్రాన్స్‌ఫర్‌ను తిరస్కరించింది మరియు ThunderPhone చేసిన స్వంత కాల్‌కు గమ్యస్థానం సమాధానం ఇవ్వలేదు. failed: ట్రాన్స్‌ఫర్ పూర్తికాలేదు మరియు కాల్ ముగిసింది
destinationstring | nullకాల్ ట్రాన్స్‌ఫర్ చేయబడిన నంబర్
sip_statusinteger | nullక్యారియర్ కోల్డ్ ట్రాన్స్‌ఫర్‌ను తిరస్కరించినప్పుడు దాని SIP స్థితి: 403 (ఉదాహరణకు, కాల్ ట్రాన్స్‌ఫర్ లేని Twilio ట్రంక్), 405 లేదా 501. క్యారియర్ దానిని తిరస్కరించనప్పుడు null
bridge_kindstring | nullbridgedకు మాత్రమే: cold_fallback (ThunderPhone కనెక్ట్ చేసిన తిరస్కరించబడిన కోల్డ్ ట్రాన్స్‌ఫర్) లేదా warm (ఏజెంట్ వెళ్లిపోయిన తర్వాత వార్మ్ ట్రాన్స్‌ఫర్‌లోని ఇద్దరు వ్యక్తులు)
bridge_secondsinteger | nullbridgedకు మాత్రమే: ThunderPhone బిల్ చేసిన బ్రిడ్జ్ సమయం, సెకన్లలో
bridge_total_centsinteger | nullbridgedకు మాత్రమే: ఏదైనా ఉచిత కాల్ క్రెడిట్ తర్వాత బ్రిడ్జ్‌కు అయిన ఖర్చు, 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పూర్ణసంఖ్య | nulloff_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_idinteger | nullకేటాయించబడినప్పుడు కాల్‌ను నిర్వహించిన ఏజెంట్
agent_namestring | nullకేటాయించబడినప్పుడు కాల్‌ను నిర్వహించిన ఏజెంట్
grade.idintegerగ్రేడ్ ఐడి
grade.scoreinteger | null0–100
grade.call_outcomestringsuccess, failure, unknown, లేదా no_conversation
grade.summarystringఒక పేరాగ్రాఫ్ సారాంశం
grade.detected_issuesarrayగ్రేడర్ గుర్తించిన సమస్య స్ట్రింగ్‌లు
grade.statusstringఎల్లప్పుడూ completed — పూర్తైన రన్‌లు మాత్రమే పంపుతాయి
grade.grader_modelstringఫలితాన్ని రూపొందించిన గ్రేడర్: శీఘ్ర తాత్కాలిక గ్రేడ్ కోసం heuristic-v1 (లేదా మరొక ThunderPhone నియమాధారిత గ్రేడర్), పూర్తి గ్రేడ్ కోసం thunderphone-grader. ఇది ThunderPhone లేబుల్, AI మోడల్ పేరు కాదు
grade.graded_at, grade.created_attimestamp
reportobject | 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_idinteger | nullఏజెంట్ కేటాయించబడినట్లయితే, కాల్‌ను నిర్వహించిన ఏజెంట్
agent_namestring | nullఏజెంట్ కేటాయించబడినట్లయితే, కాల్‌ను నిర్వహించిన ఏజెంట్
issue_report.severitystringcritical, warning, లేదా info
issue_report.statusstringopen లేదా resolved
issue_report.sourcestringuser (డ్యాష్‌బోర్డ్ నుంచి సమర్పించబడింది) లేదా 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"
}
ఫీల్డ్రకంవివరణ
automaticbooleanస్వయంచాలక ఎస్కలేషన్‌కు true; మాన్యువల్ ఎస్కలేషన్‌కు false
cluster_idUUIDఎస్కలేట్ చేసిన సమస్య నమూనా
escalation_idUUIDఎస్కలేషన్ రికార్డ్
statusstringఈవెంట్ పంపబడినప్పుడు 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_idinteger | nullకేటాయించబడి ఉంటే, కాల్‌ను నిర్వహించిన ఏజెంట్
agent_namestring | nullకేటాయించబడి ఉంటే, కాల్‌ను నిర్వహించిన ఏజెంట్
test_call_run.target_typestringagent లేదా phone_number
test_call_run.target_idintegertarget_typeకు సరిపోలేలా, రన్ లక్ష్యంగా పెట్టుకున్న ఏజెంట్ id లేదా ఫోన్-నంబర్ id
test_call_run.statusstringcompleted లేదా failed
test_call_run.call_idinteger | nullకాల్ ప్రారంభించడానికి ముందు రన్ విఫలమైతే null
test_call_run.error_messagestringవిజయవంతమైనప్పుడు ఖాళీగా ఉంటుంది

అలర్ట్ ఈవెంట్‌లు

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_nameUUID, stringట్రిగ్గర్ అయిన నియమం
metricstringsuccess_rate, failure_rate, avg_score, call_volume, లేదా suite_regression
comparatorstringlt, lte, gt, లేదా gte
metric_valuenumberనియమం ట్రిగ్గర్ అయినప్పుడు విండోలోని మెట్రిక్ విలువ
thresholdnumberకాన్ఫిగర్ చేసిన థ్రెషోల్డ్
window_hoursintegerముగింపు మూల్యాంకన విండో
fired_attimestamp

నియమాలు, మెట్రిక్‌లు, కూల్‌డౌన్‌లు, అలాగే ఇమెయిల్ / 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.idUUIDమైగ్రేషన్
migration.routing_idUUIDమీరు కాల్ చేసినప్పుడు తిరిగి వచ్చిన రూట్ చేసిన కాల్
migration.armstringours (ThunderPhone కాల్ చేసింది) లేదా vendor (ఇతర ప్లాట్‌ఫారమ్ చేసింది)
migration.vendorstringretell, vapi, elevenlabs, లేదా bland
migration.vendor_call_idstring | nullఇతర ప్లాట్‌ఫారమ్ కాల్ ఐడి; oursకు null
migration.metadataobjectకాల్ చేసినప్పుడు మీరు పంపిన metadata
migration.vendor_cost_usdstring | nullఇతర ప్లాట్‌ఫారమ్ నివేదించిన కాల్ ఖర్చు, అది నివేదించినప్పుడు
call_idinteger | nullThunderPhone కాల్ ఐడి; vendorకు null
statusstringvendor కోసం: కాల్ స్వీకరించిన వ్యక్తి మాట్లాడినప్పుడు 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_idUUIDమైగ్రేషన్
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టైమ్‌స్టాంప్

సంబంధితవి