इवेंट्स कैटलॉग

हर वेबहुक बॉडी में एक type फ़ील्ड होता है, जिसका मान इस पेज पर दिए गए इवेंट प्रकारों में से एक होता है। जब आप किसी एंडपॉइंट को सब्सक्राइब करते हैं, तो events ऐरे में वे इवेंट प्रकार होने चाहिए जिन्हें आप चाहते हैं (या सभी को सब्सक्राइब करने के लिए इसे खाली रखें)। इन इवेंट्स को दो डिलीवरी स्टाइल में भेजा जाता है:

एंडपॉइंट डिलीवरी हमेशा रीट्राई के साथ नॉन-ब्लॉकिंग नोटिफिकेशन होती हैं: कोई भी 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>"}।

`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" पर सेट किया जाता है।

लेगसी सिंगल-URL वेबहुक पर, बिल्डर माइक टेस्ट कॉल ऐतिहासिक रूप से telephony.complete के रूप में रिपोर्ट होती हैं — वहाँ केवल direction: "web" कॉल ही web.complete टाइप का उपयोग करती हैं। एंडपॉइंट सिस्टम वेब और टेस्ट, दोनों कॉल को web.* पर मैप करता है। ऐतिहासिक पेलोड में लेगसी direction वैल्यू widget या mic हो सकती हैं।

`web.tool`

telephony.tool का वेब-चैनल समकक्ष। data में from_number / to_number के बजाय origin_domain होता है।

वॉइस इवेंट्स

कस्टम वॉइस निर्माण असिंक्रोनस है। ये नॉन-ब्लॉकिंग इवेंट्स आपको क्लोन विवरण एंडपॉइंट को पोल करने के बजाय अंतिम परिणाम पर प्रतिक्रिया देने देते हैं।

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

फ़ील्ड	टाइप	विवरण
`grade.id`	इंटीजर	ग्रेड आईडी
`grade.score`	इंटीजर \| null	0–100
`grade.call_outcome`	स्ट्रिंग	`success`, `failure`, `unknown`, या `no_conversation`
`grade.summary`	स्ट्रिंग	एक-पैराग्राफ सारांश
`grade.detected_issues`	ऐरे	ग्रेडर द्वारा पाए गए समस्या स्ट्रिंग
`grade.status`	स्ट्रिंग	हमेशा `completed` — केवल पूर्ण रन ही भेजे जाते हैं
`grade.grader_model`	स्ट्रिंग	किस ग्रेडर ने परिणाम तैयार किया (जैसे, `heuristic-v1`)
`grade.graded_at`, `grade.created_at`	टाइमस्टैम्प

किसी कॉल को एक से अधिक बार ग्रेड किया जा सकता है — तेज़ हीयूरिस्टिक ग्रेड के बाद अक्सर रिकॉर्डिंग उपलब्ध होने पर पूर्ण मॉडल ग्रेड आता है, और मैन्युअल रीग्रेड भी संभव हैं। प्रत्येक पूर्ण रन अपना call.graded इवेंट भेजता है; नवीनतम graded_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_report.severity`	स्ट्रिंग	`critical`, `warning`, या `info`
`issue_report.status`	स्ट्रिंग	`open` या `resolved`
`issue_report.source`	स्ट्रिंग	`user` (डैशबोर्ड से दर्ज) या `system` (ग्रेडिंग द्वारा बनाई गई)

किसी कॉल को रीग्रेड करने पर उसकी सिस्टम-जनरेटेड इश्यू रिपोर्ट फिर से बनाई जाती हैं, जिससे दोबारा बनाई गई रिपोर्ट के लिए issue.reported फिर से भेजा जाता है। यदि आप प्रत्येक मूल समस्या के लिए केवल एक नोटिफिकेशन चाहते हैं, तो call_id + title पर डिडुप करें।

टेस्ट कॉल इवेंट

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

फ़ील्ड	टाइप	विवरण
`test_call_run.target_type`	स्ट्रिंग	`agent` या `phone_number`
`test_call_run.target_id`	इंटीजर	रन द्वारा लक्षित एजेंट आईडी या फ़ोन-नंबर आईडी, जो `target_type` से मेल खाती है
`test_call_run.status`	स्ट्रिंग	`completed` या `failed`
`test_call_run.call_id`	इंटीजर \| null	`null`, जब कॉल किए जाने से पहले रन विफल हो गया हो
`test_call_run.error_message`	स्ट्रिंग	सफलता पर खाली

अलर्ट इवेंट्स

`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	अलर्ट के ट्रिगर होने की आईडी — एनवेलप की डिलीवरी `event_id` से अलग
`rule_id`, `rule_name`	UUID, स्ट्रिंग	ट्रिगर होने वाला नियम
`metric`	स्ट्रिंग	`success_rate`, `failure_rate`, `avg_score`, `call_volume`, या `suite_regression`
`comparator`	स्ट्रिंग	`lt`, `lte`, `gt`, या `gte`
`metric_value`	संख्या	नियम ट्रिगर होने पर विंडो में मेट्रिक का मान
`threshold`	संख्या	कॉन्फ़िगर की गई थ्रेशोल्ड
`window_hours`	पूर्णांक	पिछली मूल्यांकन विंडो
`fired_at`	टाइमस्टैम्प

नियम, मेट्रिक, कूलडाउन, और ईमेल / Slack चैनल बनाने के लिए अलर्ट्स गाइड देखें।

telephony.incoming / web.incoming

ब्लॉकिंग इनबाउंड-कॉल पेलोड, जिसका आपको जवाब देना होगा।

telephony.complete / web.complete

कॉल के बाद का ट्रांसक्रिप्ट और मेट्रिक्स।

वेबहुक एंडपॉइंट्स

इन इवेंट्स के किसी सबसेट के लिए किसी URL को सब्सक्राइब करें।

फंक्शन टूल्स

telephony.tool / web.tool इवेंट्स कैसे जनरेट होते हैं।

Webhooks

Function Tools

इवेंट्स कैटलॉग

कॉल इवेंट्स

`telephony.incoming`

`telephony.complete`

`telephony.tool`

`web.incoming`

`web.complete`

`web.tool`

वॉइस इवेंट्स

`voice.ready`

`voice.failed`

गुणवत्ता इवेंट

`call.graded`

`issue.reported`

टेस्ट कॉल इवेंट

`test-call.completed`

अलर्ट इवेंट्स

`alert.triggered`

संबंधित

telephony.incoming / web.incoming

telephony.complete / web.complete

वेबहुक एंडपॉइंट्स

फंक्शन टूल्स

​कॉल इवेंट्स

​telephony.incoming

​telephony.complete

​telephony.tool

​web.incoming

​web.complete

​web.tool

​वॉइस इवेंट्स

​voice.ready

​voice.failed

​गुणवत्ता इवेंट

​call.graded

​issue.reported

​टेस्ट कॉल इवेंट

​test-call.completed

​अलर्ट इवेंट्स

​alert.triggered

​संबंधित

telephony.incoming / web.incoming

telephony.complete / web.complete

वेबहुक एंडपॉइंट्स

फंक्शन टूल्स

कॉल इवेंट्स

`telephony.incoming`

`telephony.complete`

`telephony.tool`

`web.incoming`

`web.complete`

`web.tool`

वॉइस इवेंट्स

`voice.ready`

`voice.failed`

गुणवत्ता इवेंट

`call.graded`

`issue.reported`

टेस्ट कॉल इवेंट

`test-call.completed`

अलर्ट इवेंट्स

`alert.triggered`

संबंधित