ThunderPhone v3 आता लाइव्ह आहे.स्वतःच सुरू करा—2¢/मिनिटपासून.घोषणा वाचा

Webhooks

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

ThunderPhone पाठवणारे सर्व वेबहुक इव्हेंट प्रकार.

प्रत्येक webhook बॉडीमध्ये type फील्ड असते, ज्याचे मूल्य या पृष्ठावरील इव्हेंट प्रकारांपैकी एक असते. तुम्ही एखाद्या endpoint चे सदस्यत्व घेतल्यावर, events अॅरेमध्ये तुम्हाला हव्या असलेल्या इव्हेंट प्रकारांचा समावेश असणे आवश्यक आहे (किंवा सर्वांचे सदस्यत्व घेण्यासाठी तो रिकामा ठेवावा — मात्र प्रति-टर्न इव्हेंट telephony.turn / web.turn आणि लाइव्ह प्रगती इव्हेंट call.status_changed वगळून; हे इव्हेंट फक्त त्यांना स्पष्टपणे नमूद करणाऱ्या endpoints ना वितरित केले जातात).

हे इव्हेंट दोन वितरण शैलींमधून पाठवले जातात:

  • एंडपॉइंट डिलिव्हरी नेहमी पुनःप्रयत्नांसह नॉन-ब्लॉकिंग सूचना असतात: कोणत्याही 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पूर्णांक | nullनियुक्त केलेला असल्यास, कॉल हाताळणारा एजंट
agent_nameस्ट्रिंग | nullनियुक्त केलेला असल्यास, कॉल हाताळणाऱ्या एजंटचे नाव
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_idinteger | nullनियुक्त असल्यास, कॉल हाताळणारा एजंट
agent_namestring | nullनियुक्त असल्यास, कॉल हाताळणाऱ्या एजंटचे नाव

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_idinteger | nullनियुक्त असल्यास, कॉल हाताळणारा एजंट
agent_namestring | nullनियुक्त असल्यास, कॉल हाताळणाऱ्या एजंटचे नाव

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_idinteger | nullनियुक्त असल्यास, कॉल हाताळणारा एजंट
agent_namestring | nullनियुक्त असल्यास, कॉल हाताळणाऱ्या एजंटचे नाव
positionintegerकॉल इतिहासातील टर्नचा निर्देशांक — क्रमवारीसाठी स्थिर ओळख
rolestringassistant (एजंटचे बोलणे) किंवा user (कॉलरचे बोलणे)
textstringउत्सर्जनाच्या वेळी ज्ञात असलेला टर्नचा ट्रान्स्क्रिप्ट मजकूर
entry_typestringअंतर्निहित इतिहास नोंद प्रकार: completion (एजंट), किंवा user_turn / span (कॉलर)
start_ms, end_msintegerकॉल सुरू झाल्यापासूनचे ऑडिओ ऑफसेट 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_idinteger | nullनियुक्त असल्यास, कॉल हाताळणारा एजंट
agent_namestring | nullनियुक्त असल्यास, कॉल हाताळणाऱ्या एजंटचे नाव

web.complete

telephony.complete चे वेब-चॅनेल समतुल्य, ज्यामध्ये वेब विजेट कॉल्स (direction: "web") आणि बिल्डर माइक चाचणी कॉल्स (direction: "test") समाविष्ट असतात. ब्लॉकिंग नसते. telephony.complete प्रमाणेच पेलोड स्वरूप असते, तसेच origin_domain असते आणि from_number "web" वर सेट असते.

फील्डप्रकारवर्णन
agent_idinteger | nullनियुक्त असल्यास, कॉल हाताळणारा एजंट
agent_namestring | nullनियुक्त असल्यास, कॉल हाताळणाऱ्या एजंटचे नाव

web.tool

telephony.tool चे वेब-चॅनेल समतुल्य. data मध्ये from_number / to_number ऐवजी origin_domain असते.

फील्डप्रकारवर्णन
agent_idinteger | nullनियुक्त असल्यास, कॉल हाताळणारा एजंट
agent_namestring | nullनियुक्त असल्यास, कॉल हाताळणाऱ्या एजंटचे नाव

web.turn

telephony.turn चे वेब-चॅनेल समतुल्य, ज्यामध्ये वेब विजेट कॉल्स आणि बिल्डर माइक चाचणी कॉल्स समाविष्ट असतात. from_number / to_number ऐवजी origin_domain सह पेलोडचे स्वरूप समान असते. telephony.turn प्रमाणेच, यासाठी स्पष्ट सबस्क्रिप्शन आवश्यक असते — ते कधीही रिकाम्या events अॅरेद्वारे डिलिव्हर केले जात नाही.

फील्डप्रकारवर्णन
agent_idinteger | nullनियुक्त असल्यास, कॉल हाताळणारा एजंट
agent_namestring | nullनियुक्त असल्यास, कॉल हाताळणाऱ्या एजंटचे नाव

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इंटिजरट्रान्सफर करण्यात आलेला कॉल
agent_idइंटिजर | नलनियुक्त केलेला असल्यास, कॉल हाताळणारा एजंट
agent_nameस्ट्रिंग | नलनियुक्त केलेला असल्यास, कॉल हाताळणाऱ्या एजंटचे नाव
transfer_outcomeस्ट्रिंगrefer_accepted: कॅरिअरने कॉल ताब्यात घेतला. bridged: कॅरिअरने कोल्ड ट्रान्सफर नाकारल्यामुळे किंवा वॉर्म ट्रान्सफरचा एजंट बाहेर पडल्यामुळे ThunderPhone ने कॉलर आणि डेस्टिनेशन यांना स्वतः कनेक्ट ठेवले. bridge_unanswered: कॅरिअरने कोल्ड ट्रान्सफर नाकारला आणि डेस्टिनेशनने ThunderPhone च्या स्वतःच्या कॉलला उत्तर दिले नाही. failed: ट्रान्सफर पूर्ण झाला नाही आणि कॉल संपला
destinationस्ट्रिंग | नलकॉल ज्या क्रमांकावर ट्रान्सफर करण्यात आला तो क्रमांक
sip_statusइंटिजर | नलकॅरिअरने कोल्ड ट्रान्सफर नाकारला तेव्हाची त्याची SIP स्थिती: 403 (उदाहरणार्थ, कॉल ट्रान्सफर नसलेला Twilio ट्रंक), 405 किंवा 501. कॅरिअरने तो नाकारला नसल्यास null
bridge_kindस्ट्रिंग | नलफक्त bridged: cold_fallback (ThunderPhone ने कनेक्ट केलेला नाकारलेला कोल्ड ट्रान्सफर) किंवा warm (एजंट बाहेर पडल्यानंतर वॉर्म ट्रान्सफरमधील दोन व्यक्ती)
bridge_secondsइंटिजर | नलफक्त bridged: ThunderPhone ने बिल केलेला ब्रिजचा कालावधी, सेकंदांमध्ये
bridge_total_centsइंटिजर | नलफक्त 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पूर्णांक | nullनियुक्त केलेला असल्यास, कॉल हाताळणारा एजंट
agent_nameस्ट्रिंग | nullनियुक्त केलेला असल्यास, कॉल हाताळणारा एजंट
reasonस्ट्रिंगsettled: कॉलचे शुल्क. adjusted: शुल्कानंतर प्राप्त झालेल्या वापरामुळे त्यात वाढ झाली (शुल्क कधीही कमी होत नाही)
billing_seqपूर्णांकशुल्कासाठी 1, त्यानंतर प्रत्येक वाढीसाठी 2, 3, ... . प्राप्त झालेला सर्वोच्च क्रमांक हे कॉलचे सध्याचे बिलिंग आहे
billable_minutesसंख्याबिल आकारलेली मिनिटे, जवळच्या पाव मिनिटापर्यंत पूर्णांकित
billing_total_centsपूर्णांककोणत्याही विनामूल्य कॉल क्रेडिटनंतर, adjusted वाढींसह, आतापर्यंत कॉलसाठी आकारलेले सर्व USD सेंट
adjustment_centsपूर्णांक | nullकेवळ 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 पाठवतो.

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


नियोजित इव्हेंट्स

पाठवले न गेलेले नियोजित पाठवणे यापैकी एक इव्हेंट ट्रिगर करतात. प्रत्यक्ष पाठवले गेलेले पाठवणे त्याऐवजी नेहमीचे इव्हेंट्स ट्रिगर करते: मजकुरासाठी 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स्ट्रिंगनियोजित पाठवण्याचा आयडी
typeस्ट्रिंगsms किंवा call
statusस्ट्रिंगskipped किंवा failed
reasonस्ट्रिंगवरीलप्रमाणे कारण; पाठवण्याच्या status_reason सारखेच मूल्य
detailस्ट्रिंगवाचता येईल असे स्पष्टीकरण
sourceस्ट्रिंगपाठवणे कशामुळे तयार झाले: api
external_idस्ट्रिंग | नलपाठवण्यासाठी तुमची की, किंवा null
from_numberस्ट्रिंगपाठवणारा क्रमांक
toस्ट्रिंगनेहमी "[REDACTED]"
agent_idपूर्णांक | नलकॉल: एजंट; मजकूर संदेश: 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

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": "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_idinteger | nullनियुक्त असल्यास, कॉल हाताळणारा एजंट
agent_namestring | nullनियुक्त असल्यास, कॉल हाताळणारा एजंट
summarystring | nullएजंटकडे कॉल सारांश तयार करा सुरू असल्यास पूर्ण केलेला कॉल सारांश, त्यामुळे उशिरा आलेला एक्स्ट्रॅक्शन इव्हेंट पूर्णतेच्या वेळेत न आलेला सारांशही वितरित करतो; अन्यथा null. सारांश असलेले पण एक्स्ट्रॅक्शन फील्ड नसलेले एजंट हा इव्हेंट कधीही उत्सर्जित करत नाहीत: उशिराचा सारांश GET /v1/calls/{call_id} मधून वाचा
extracted_data.statusstringया इव्हेंटसाठी नेहमी completed
extracted_data.fieldsobjectकॉन्फिगर केलेल्या एक्स्ट्रॅक्शन फील्ड कीनुसार मूल्ये; अनुपलब्ध मूल्ये null असतात
extracted_data.evidenceobjectएक्स्ट्रॅक्शन फील्डनुसार पुरावे. नॉन-नल मूल्यात अचूक संरचनात्मक तपासणी केलेले उद्धरण (जास्तीत जास्त 1,000 वर्ण), speaker_role (caller किंवा agent), आणि turn_index असतात; मॉडेलने परत केलेली अधिक लांब उद्धरणे छाटण्याऐवजी नाकारली जातात आणि त्याचे फील्ड null असल्यास पुरावे null असतात
extracted_data.verificationstringप्रत्येक उमेदवार फील्डसाठी स्वतंत्र पुरावा पासने नेमका एक वैध निकाल परत केल्यावरच verified. unavailable म्हणजे पास अयशस्वी झाला, वेळ संपली, पुरेसे बजेट नव्हते किंवा विकृत अथवा अंशतः आउटपुट परत केले. पूर्णपणे अनुपलब्ध पास ग्राहक पुनरावलोकनासाठी संरचनात्मकदृष्ट्या आधारलेली मूल्ये जतन करतो. अंशतः आउटपुटसाठी, वैध निकाल लागू केले जातात आणि नेमका एक वैध निकाल नसलेला प्रत्येक उमेदवार नल केला जातो
extracted_data.field_reasonsobjectसंरचनात्मक आधार किंवा स्वतंत्र व्हेरिफायरद्वारे नल केलेल्या फील्डनुसार कारणे
extracted_data.schema_versionstringया एक्स्ट्रॅक्शनसाठी वापरलेल्या अचूक फील्ड स्कीमाचा हॅश
extracted_attimestampISO 8601 पूर्णता वेळ
modelstringनेहमी 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 ला अहवाल द्या नंतर किंवा 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_idintegerरनने लक्ष्य केलेला एजंट id किंवा फोन-नंबर id, जो target_type शी जुळतो
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इंटिजर | nullफोन क्रमांक मधील त्याचा id
spam_riskस्ट्रिंगmedium किंवा high
previous_spam_riskस्ट्रिंग | nullमागील वाचनातील धोका; पहिल्या वाचनापूर्वी null
spam_categoryस्ट्रिंग | nullकॅरिअर दाखवू शकतात असे लेबल, उदाहरणार्थ 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% असतो आणि एजंटच्या मायग्रेशन टॅबवर कोणी तो पुन्हा सुरू करेपर्यंत मायग्रेशन थांबवलेले राहते. पेलोडमध्ये फोन क्रमांक, ट्रान्सक्रिप्ट किंवा कॉल आयडी नसतात.

{
  "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टाइमस्टॅम्प

संबंधित