इव्हेंट्स कॅटलॉग

ThunderPhone उत्सर्जित करत असलेले सर्व webhook इव्हेंट प्रकार.

प्रत्येक वेबहुक बॉडीमध्ये 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#

इनबाउंड कॉल तुमच्या फोन नंबरपैकी एका नंबरवर पोहोचल्यावर पाठवला जातो. एन्डपॉइंट डिलिव्हरी प्रत्येक इनबाउंड कॉलसाठी फायर-अँड-फॉरगेट सूचना म्हणून पाठवल्या जातात, नंबर एजंट-कॉन्फिगर केलेला असो किंवा webhook-कॉन्फिगर केलेला असो. नियुक्त एजंट नसलेल्या नंबरना लेगसी webhook वर अतिरिक्त ब्लॉकिंग कॉन्फिगरेशन विनंती मिळते — संपूर्ण विनंती / प्रतिसाद स्कीमासाठी 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#

टेलिफोनी कॉल सुरू असताना, प्रत्येक भाषणयुक्त टर्नसाठी तो घडत असतानाच पाठवला जातो — एजंटची बोललेली पूर्ण उत्तरे आणि कॉलरचे ट्रान्स्क्राइब केलेले टर्न. पोलिंग करण्याऐवजी साध्या webhooks वरून तुम्हाला थेट संभाषणाचे अनुसरण करता येते 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" मधील पब्लिशेबल कींना लेगसी 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" असतो. webhook-मोड विजेट सत्रांसाठी 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 चॅनेल तयार करण्यासाठी अलर्ट्स मार्गदर्शक पहा.

संबंधित#