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

ThunderPhone పంపే అన్ని వెబ్‌హుక్ ఈవెంట్ రకాలు.

ప్రతి వెబ్‌హుక్ బాడీలో ఈ పేజీలోని ఈవెంట్ రకాలలో ఒకదాని విలువ ఉండే type ఫీల్డ్ ఉంటుంది. మీరు ఒక ఎండ్‌పాయింట్కు సబ్‌స్క్రైబ్ చేసినప్పుడు, events అరేలో మీకు కావలసిన ఈవెంట్ రకాలు ఉండాలి (లేదా అన్నింటికీ సబ్‌స్క్రైబ్ కావడానికి అది ఖాళీగా ఉండాలి — కానీ ప్రతి-టర్న్ ఈవెంట్‌లు telephony.turn / web.turn మినహా; వీటిని స్పష్టంగా పేర్కొన్న ఎండ్‌పాయింట్‌లకే పంపుతారు).

ఈ ఈవెంట్‌లను రెండు డెలివరీ విధానాలు అందిస్తాయి:

• ఎండ్‌పాయింట్ డెలివరీలు ఎల్లప్పుడూ మళ్లీ ప్రయత్నాలతో కూడిన బ్లాకింగ్ కాని నోటిఫికేషన్‌లు: ఏదైనా 2xxతో ప్రతిస్పందించండి; డీడూప్లికేట్ చేయడానికి ఎన్వలప్‌లో event_id ఉంటుంది.
• బ్లాకింగ్ ఎక్స్చేంజ్‌లు కేవలం లెగసీ సింగిల్-URL వెబ్‌హుక్లోనే నడుస్తాయి: telephony.incoming / web.incoming కాన్ఫిగరేషన్ అభ్యర్థన (వెబ్‌హుక్-మోడ్ నంబర్‌లు మరియు విడ్జెట్ కీలు, 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"
}

telephony.complete#

ఇన్‌బౌండ్ లేదా అవుట్‌బౌండ్ టెలిఫోనీ కాల్ ముగిసినప్పుడు పంపబడుతుంది. నాన్-బ్లాకింగ్. ట్రాన్స్‌క్రిప్ట్, అందుబాటులో ఉన్నప్పుడు రికార్డింగ్ URL మరియు బిల్లింగ్ సారాంశాన్ని కలిగి ఉంటుంది. పేలోడ్ స్కీమా కోసం telephony.complete / web.complete చూడండి.

telephony.tool#

టెలిఫోనీ కాల్ ఒక ఫంక్షన్ టూల్ను ఇన్‌వోక్ చేసిన తర్వాత పంపబడుతుంది. నాన్-బ్లాకింగ్ ఆడిట్ నోటిఫికేషన్ — ఈ ఈవెంట్ డెలివర్ అయ్యే సమయానికి టూల్ ఇప్పటికే అమలై ఉంటుంది; ఇది మీ స్వంత ఫంక్షన్ టూల్‌లను మాత్రమే కవర్ చేస్తుంది (అంతర్నిర్మిత, నాలెడ్జ్-బేస్, యాప్-కనెక్షన్ లేదా MCP టూల్‌లు కాదు).

{
  "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>"}.

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"
}

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 ఖాళీగా ఉంటాయి.

web.complete#

telephony.complete యొక్క వెబ్-చానల్ సమానమైనది; వెబ్ విడ్జెట్ కాల్‌లు (direction: "web") మరియు బిల్డర్ మైక్ టెస్ట్ కాల్‌లను (direction: "test") కవర్ చేస్తుంది. నాన్-బ్లాకింగ్. telephony.complete మాదిరిగానే పేలోడ్ ఆకృతి ఉంటుంది, అదనంగా origin_domain ఉంటుంది మరియు from_number విలువ "web"గా సెట్ చేయబడుతుంది.

web.tool#

telephony.tool యొక్క వెబ్-చానల్ సమానమైనది. dataలో from_number / to_numberకు బదులుగా origin_domain ఉంటుంది.

web.turn#

telephony.turn యొక్క వెబ్-చానల్ సమానమైనది; వెబ్ విడ్జెట్ కాల్‌లు మరియు బిల్డర్ మైక్ టెస్ట్ కాల్‌లను కవర్ చేస్తుంది. from_number / to_numberకు బదులుగా origin_domainతో, పేలోడ్ ఆకృతి ఒకేలా ఉంటుంది. telephony.turn మాదిరిగానే, దీనికి స్పష్టమైన సబ్‌స్క్రిప్షన్ అవసరం — ఖాళీ events అరే ద్వారా ఇది ఎప్పుడూ డెలివర్ చేయబడదు.

వాయిస్ ఈవెంట్‌లు#

అనుకూల వాయిస్ సృష్టి అసమకాలికంగా జరుగుతుంది. ఈ నిరోధించని ఈవెంట్‌లు మీరు పోలింగ్ చేయడానికి బదులుగా తుది ఫలితానికి ప్రతిస్పందించడానికి అనుమతిస్తాయి క్లోన్ వివరాల ఎండ్‌పాయింట్.

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"
}

నాణ్యత ఈవెంట్‌లు#

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…"
    }
  },
  "event_id": "7c1d2e3f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
  "type": "call.graded"
}

call.data_extracted#

telephony.complete / web.complete తర్వాత ఆలస్యమైన రీట్రై లేదా POST /v1/calls/{call_id}/extract ద్వారా మాన్యువల్ రీ-రన్‌తో సహా, స్ట్రక్చర్డ్ డేటా ఎక్స్‌ట్రాక్షన్ విజయవంతంగా పూర్తయినప్పుడల్లా పంపబడుతుంది. నాన్-బ్లాకింగ్.

బ్లాకింగ్ ఎక్స్‌ట్రాక్షన్ మోడ్‌లో, పూర్తయ్యే ఈవెంట్ సాధారణంగా 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": "gemini-2.5-flash"
  },
  "event_id": "4d79ef1d-c2b1-4ed6-85b8-8326bd2895ef",
  "type": "call.data_extracted"
}

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,
      "remaining": 0
    }
  },
  "event_id": "8d8f52ce-6b46-423f-9dde-cea0b91ec135",
  "type": "campaign.completed"
}

నాలుగు ఫలితాల కౌంట్‌లు పరస్పరం వేర్వేరు మరియు వాటి మొత్తం contacts_totalకు సమానం: completedలో విజయవంతమైన కాంటాక్ట్‌లు ఉంటాయి; no_answerలో తుది ఫలితం జవాబు లేకపోవడం అయిన టెర్మినల్ విఫలమైన/ఎగ్జాస్ట్ అయిన కాంటాక్ట్‌లు ఉంటాయి; failedలో మిగతా అన్ని టెర్మినల్ విఫలమైన/ఎగ్జాస్ట్ అయిన కాంటాక్ట్‌లు ఉంటాయి; మరియు remainingలో పెండింగ్, షెడ్యూల్ చేసిన లేదా ప్రస్తుతం కాల్ చేస్తున్న కాంటాక్ట్‌లు ఉంటాయి. రీట్రై కోసం వేచి ఉన్న కాంటాక్ట్‌కు ఇటీవలి ప్రయత్నంలో జవాబు లేకపోయినా అది remainingగానే ఉంటుంది. ఒక్కసారి మాత్రమే తీసే పూర్తి స్నాప్‌షాట్‌కు ముందు ప్రోగ్రెస్‌లో ఉన్న కాల్‌లు సరిచేయబడతాయి. started_at అనేది కాన్ఫిగర్ చేసిన క్యాంపెయిన్ ప్రారంభం లేదా ప్రారంభం కాన్ఫిగర్ చేయనప్పుడు క్యాంపెయిన్ సృష్టించిన సమయం.

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"
}

issue.escalated#

సిబ్బంది సమీక్ష కోసం సమస్య నమూనాను ThunderPhoneకు పంపినప్పుడు పంపబడుతుంది: ThunderPhoneకు నివేదించండి తర్వాత లేదా 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"
}

ఇది నోటిఫికేషన్ మాత్రమే, ఆధారాల బండిల్ కాదు. సమస్య నమూనాతో దీనిని అనుసంధానించడానికి 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"
}

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

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"
}

నియమాలు, మెట్రిక్‌లు, కూల్‌డౌన్‌లు, అలాగే ఇమెయిల్ / Slack ఛానెల్‌లను సృష్టించడం కోసం అలర్ట్‌ల గైడ్ చూడండి.

సంబంధితవి#