Open in
ইভেন্ট ক্যাটালগ
ThunderPhone যে সব ওয়েবহুক ইভেন্ট টাইপ পাঠায়।
প্রতিটি webhook বডিতে একটি type ফিল্ড থাকে, যার মান এই পৃষ্ঠার ইভেন্ট
টাইপগুলোর একটি। আপনি যখন একটি
endpoint-এ সাবস্ক্রাইব করেন, তখন events অ্যারেতে আপনার চাওয়া
ইভেন্ট টাইপগুলো থাকতে হবে (অথবা সবকিছুর জন্য সাবস্ক্রাইব করতে এটি খালি থাকতে পারে —
তবে প্রতি-টার্ন ইভেন্টগুলো telephony.turn /
web.turn এবং লাইভ অগ্রগতি ইভেন্ট
call.status_changed ব্যতীত, যেগুলো শুধুমাত্র সেসব
endpoint-এ পাঠানো হয় যেগুলো স্পষ্টভাবে তাদের নাম উল্লেখ করে)।
এই ইভেন্টগুলো দুটি ডেলিভারি শৈলীতে পাঠানো হয়:
- এন্ডপয়েন্ট ডেলিভারি সবসময় পুনঃচেষ্টা-সহ নন-ব্লকিং বিজ্ঞপ্তি: যেকোনো 2xx দিয়ে সাড়া দিন; ডিডুপ্লিকেশনের জন্য এনভেলপটিতে একটি
event_idথাকে। - ব্লকিং বিনিময় শুধু লেগ্যাসি একক-URL webhook-এ চলে:
telephony.incoming/web.incomingকনফিগারেশন অনুরোধ (webhook-মোড নম্বর: একটি পুনঃচেষ্টাসহ 13 s; webhook-মোড উইজেট কী: 10 s) এবং webhook-মোড টুল ডিসপ্যাচ। আপনার প্রতিক্রিয়া লাইভ কলকে রূপ দেয়।
নিচের উদাহরণ payload-গুলো ওয়্যার অর্ডারে এন্ডপয়েন্ট এনভেলপ দেখায়
(কীগুলো বর্ণানুক্রমে সাজানো: data, event_id, type); লেগ্যাসি ডেলিভারিতে
event_id ছাড়া একই data থাকে।
কল ইভেন্ট
telephony.incoming
একটি ইনবাউন্ড কল আপনার কোনো একটি
ফোন নম্বরে পৌঁছালে পাঠানো হয়। প্রতিটি
ইনবাউন্ড কলের জন্য endpoint ডেলিভারি fire-and-forget বিজ্ঞপ্তি হিসেবে পাঠানো হয়,
নম্বরটি এজেন্ট-কনফিগার করা হোক বা webhook-কনফিগার করা হোক। কোনো এজেন্ট বরাদ্দ না থাকা
নম্বরগুলো legacy webhook-এ অতিরিক্তভাবে blocking কনফিগারেশন রিকোয়েস্ট পায় — সম্পূর্ণ
রিকোয়েস্ট / রেসপন্স স্কিমার জন্য দেখুন
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 | integer | null | এজেন্ট নির্ধারিত থাকলে, কলটি পরিচালনা করা এজেন্ট |
agent_name | string | null | এজেন্ট নির্ধারিত থাকলে, কলটি পরিচালনা করা এজেন্ট |
returning_call | object | নম্বরটি গত 30 দিনের মধ্যে এই কলারকে কল করে থাকলেই কেবল উপস্থিত: আগের কলের call_id, agent_id, started_at এবং outcome। দেখুন কলব্যাক |
sip_headers | object | কলটি X-* বা User-to-User SIP হেডারসহ এলে তবেই উপস্থিত (SIP ঠিকানা এবং ম্যানুয়াল SIP সংযোগ): ছোট হাতের হেডার নাম → মান। দেখুন SIP হেডার |
telephony.complete
একটি ইনবাউন্ড বা আউটবাউন্ড টেলিফোনি কল শেষ হলে পাঠানো হয়। নন-ব্লকিং।
এতে ট্রান্সক্রিপ্ট, উপলভ্য থাকলে রেকর্ডিং URL এবং বিলিং সারাংশ অন্তর্ভুক্ত থাকে। পে-লোড
স্কিমার জন্য দেখুন
telephony.complete / web.complete।
| ফিল্ড | ধরন | বিবরণ |
|---|---|---|
agent_id | integer | null | এজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট |
agent_name | string | null | এজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট |
telephony.tool
একটি টেলিফোনি কল
function tool ইনভোক করার পরে পাঠানো হয়। নন-ব্লকিং অডিট বিজ্ঞপ্তি —
এই ইভেন্ট ডেলিভারির সময় tool ইতিমধ্যেই কার্যকর হয়ে গেছে; এটি আপনার নিজস্ব function tool
এবং বিল্ট-ইন send_sms tool অন্তর্ভুক্ত করে (অন্যান্য বিল্ট-ইন,
knowledge-base, app-connection বা MCP tool নয়)। send_sms-এর জন্য
arguments.to এবং arguments.body উভয়ই [REDACTED] থাকে। completion
ট্রান্সক্রিপ্টেও এগুলো রিড্যাক্ট করা হয়; রেসপন্সের message_id ব্যবহার করে
organization-scoped 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 | integer | null | এজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট |
agent_name | string | null | এজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট |
telephony.turn
একটি টেলিফোনি কল চলমান থাকা অবস্থায়, প্রতিটি
কথা-সংবলিত turn ঘটার সঙ্গে সঙ্গে একবার পাঠানো হয় — এজেন্টের বলা completion এবং
কলারের ট্রান্সক্রাইব করা turn। এটি আপনাকে polling করার পরিবর্তে
সাধারণ webhook-এর মাধ্যমে লাইভ কথোপকথন অনুসরণ করতে দেয়
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 | integer | null | এজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট |
agent_name | string | null | এজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট |
position | integer | কল ইতিহাসে turn-এর ইনডেক্স — ক্রম নির্ধারণের জন্য একটি স্থিতিশীল পরিচয় |
role | string | assistant (এজেন্টের কথা) অথবা user (কলারের কথা) |
text | string | ইমিশনের সময় জানা turn-এর ট্রান্সক্রিপ্ট টেক্সট |
entry_type | string | অন্তর্নিহিত ইতিহাস এন্ট্রির ধরন: completion (এজেন্ট), অথবা user_turn / span (কলার) |
start_ms, end_ms | integer | কল শুরুর পর থেকে ms-এ অডিও অফসেট; ইমিশনের সময় প্লেআউট টাইমিং আগে থেকেই জানা থাকলেই কেবল উপস্থিত থাকে |
web.incoming
telephony.incoming-এর ওয়েব-চ্যানেল সমতুল্য, যা একটি
ওয়েব widget সেশন বা builder mic test call
শুরু হলে পাঠানো হয়। প্রতিটি ওয়েব সেশনের জন্য endpoint ডেলিভারি fire-and-forget।
mode="webhook"-এ publishable key-গুলো legacy webhook-এ অতিরিক্তভাবে
blocking কনফিগারেশন রিকোয়েস্ট পায় — ওই blocking রিকোয়েস্টের আকৃতি ভিন্ন
(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-mode widget
সেশনের জন্য to_number খালি থাকে (কনফিগারেশনের পরে সেশনের এজেন্ট নম্বর বরাদ্দ করা হয়);
builder mic test call-এর জন্য origin_domain এবং
publishable_key_prefix খালি থাকে।
| ফিল্ড | ধরন | বিবরণ |
|---|---|---|
agent_id | integer | null | এজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট |
agent_name | string | null | এজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট |
web.complete
telephony.complete-এর ওয়েব-চ্যানেল সমতুল্য, যা ওয়েব
widget কল (direction: "web") এবং builder mic test call
(direction: "test") অন্তর্ভুক্ত করে। নন-ব্লকিং। এর পে-লোড আকৃতি
telephony.complete-এর মতোই, তবে origin_domain
যোগ করা থাকে এবং from_number হিসেবে "web" সেট করা থাকে।
| ফিল্ড | ধরন | বিবরণ |
|---|---|---|
agent_id | integer | null | এজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট |
agent_name | string | null | এজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট |
web.tool
telephony.tool-এর ওয়েব-চ্যানেল সমতুল্য। data-তে
from_number / to_number-এর পরিবর্তে origin_domain থাকে।
| ফিল্ড | ধরন | বিবরণ |
|---|---|---|
agent_id | integer | null | এজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট |
agent_name | string | null | এজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট |
web.turn
telephony.turn-এর ওয়েব-চ্যানেল সমতুল্য,
যা ওয়েব widget কল এবং builder mic test call অন্তর্ভুক্ত করে। একই পে-লোড
আকৃতি, তবে from_number / to_number-এর পরিবর্তে origin_domain থাকে।
telephony.turn-এর মতোই, এটির জন্য একটি স্পষ্ট সাবস্ক্রিপশন প্রয়োজন — এটি
কখনোই খালি events array-এর মাধ্যমে ডেলিভার করা হয় না।
| ফিল্ড | ধরন | বিবরণ |
|---|---|---|
agent_id | integer | null | এজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট |
agent_name | string | 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 | integer | যে কলটি ট্রান্সফার করা হয়েছিল |
agent_id | integer | null | কোনো এজেন্ট নিযুক্ত থাকলে, কলটি পরিচালনা করা এজেন্ট |
agent_name | string | null | কোনো এজেন্ট নিযুক্ত থাকলে, কলটি পরিচালনা করা এজেন্ট |
transfer_outcome | string | refer_accepted: ক্যারিয়ার কলটির দায়িত্ব নিয়েছে। bridged: ক্যারিয়ার কোল্ড ট্রান্সফার প্রত্যাখ্যান করায় বা ওয়ার্ম ট্রান্সফারের এজেন্ট সরে যাওয়ায় ThunderPhone নিজেই কলার ও গন্তব্যকে সংযুক্ত রেখেছে। bridge_unanswered: ক্যারিয়ার একটি কোল্ড ট্রান্সফার প্রত্যাখ্যান করেছে এবং গন্তব্য ThunderPhone-এর নিজস্ব কলের উত্তর দেয়নি। failed: ট্রান্সফার সম্পন্ন হয়নি এবং কল শেষ হয়েছে |
destination | string | null | যে নম্বরে কলটি ট্রান্সফার করা হয়েছিল |
sip_status | integer | null | কোল্ড ট্রান্সফার প্রত্যাখ্যান করার সময় ক্যারিয়ারের SIP স্ট্যাটাস: 403 (উদাহরণস্বরূপ, কল ট্রান্সফারবিহীন একটি Twilio ট্রাঙ্ক), 405 বা 501। ক্যারিয়ার এটি প্রত্যাখ্যান না করলে null |
bridge_kind | string | null | শুধুমাত্র bridged: cold_fallback (প্রত্যাখ্যাত একটি কোল্ড ট্রান্সফার যা ThunderPhone সংযুক্ত করেছে) অথবা warm (এজেন্ট চলে যাওয়ার পরে ওয়ার্ম ট্রান্সফারের দুই ব্যক্তি) |
bridge_seconds | integer | null | শুধুমাত্র bridged: ThunderPhone যে ব্রিজ সময়ের জন্য বিল করেছে, সেকেন্ডে |
bridge_total_cents | integer | null | শুধুমাত্র 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 | integer | যে কলে বিল করা হয়েছে |
agent_id | integer | null | কোনো এজেন্ট নিযুক্ত থাকলে, কলটি পরিচালনা করা এজেন্ট |
agent_name | string | null | কোনো এজেন্ট নিযুক্ত থাকলে, কলটি পরিচালনা করা এজেন্ট |
reason | string | settled: কলের চার্জ। adjusted: চার্জের পরে আসা ব্যবহার, যা চার্জ বাড়িয়েছে (চার্জ কখনও কমানো হয় না) |
billing_seq | integer | চার্জের জন্য 1, তারপর প্রতিটি বৃদ্ধির জন্য 2, 3, ...। প্রাপ্ত সর্বোচ্চটিই কলের বর্তমান বিলিং |
billable_minutes | number | বিল করা মিনিট, নিকটতম এক-চতুর্থাংশ মিনিটে রাউন্ড করা |
billing_total_cents | integer | যেকোনো বিনামূল্যের কল ক্রেডিটের পর, adjusted বৃদ্ধি-সহ, এ পর্যন্ত কলের জন্য চার্জ করা সবকিছু USD সেন্টে |
adjustment_cents | integer | 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 ইভেন্ট পাঠানো হয় না। ইনবাউন্ড ক্যারিয়ার ওয়েবহুক কনফিগারেশন এবং স্বাক্ষর যাচাইকরণ আলাদাভাবে প্রকাশ করা হবে।
নির্ধারিত ইভেন্ট
যে নির্ধারিত প্রেরণগুলো পাঠানো হয় না, সেগুলো এই ইভেন্টগুলোর একটি ট্রিগার করে। যে প্রেরণ পাঠানো হয়, সেটি পরিবর্তে সাধারণ ইভেন্টগুলো ট্রিগার করে: টেক্সটের জন্য scheduled_send_id সেট থাকা sms.* ইভেন্টগুলো, কলের জন্য কল ইভেন্টগুলো, যার telephony.complete-এ scheduled_send_id থাকে। উভয়ই নন-ব্লকিং। প্রেরণের সঙ্গে এজেন্ট থাকলে, সেই এজেন্টের এজেন্ট-স্কোপড এন্ডপয়েন্টগুলোও এগুলো পায়।
পেলোডে কেবল 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 | string | নির্ধারিত পাঠানোর আইডি |
type | string | sms বা call |
status | string | skipped বা failed |
reason | string | কেন, উপরে বর্ণিত অনুযায়ী; পাঠানোর status_reason-এর একই মান |
detail | string | পঠনযোগ্য ব্যাখ্যা |
source | string | কী পাঠানোটি তৈরি করেছে: api |
external_id | string | null | পাঠানোর জন্য আপনার কী, অথবা null |
from_number | string | পাঠানোর নম্বর |
to | string | সর্বদা "[REDACTED]" |
agent_id | integer | null | কল: এজেন্ট; টেক্সট: null |
send_at, expires_at, created_at | timestamp | 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 | string | কাস্টম ভয়েসের পাবলিক আইডি |
voice.name | string | custom:<public_id> ফর্মে এজেন্ট ভয়েসের মান |
voice.display_name | string | সংস্থার জন্য প্রদর্শিত ভয়েসের নাম |
voice.language | string | ক্লোনের একক ভাষা কোড |
voice.gender | string | male, female, অথবা একটি খালি স্ট্রিং |
voice.status | string | voice.ready-এর জন্য ready; voice.failed-এর জন্য failed |
voice.failure_reason | string | সফল হলে খালি; ব্যর্থ হলে প্রক্রিয়াকরণ ব্যর্থতার বিবরণ |
voice.created_at, voice.updated_at | timestamp | ISO 8601 টাইমস্ট্যাম্প |
reason | string | ব্যর্থতার বিবরণ; শুধু 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_id | integer | null | কলটি পরিচালনা করা এজেন্ট, যখন একজন নিযুক্ত ছিলেন |
agent_name | string | null | কলটি পরিচালনা করা এজেন্ট, যখন একজন নিযুক্ত ছিলেন |
grade.id | integer | গ্রেড আইডি |
grade.score | integer | null | 0–100 |
grade.call_outcome | string | success, failure, unknown, অথবা no_conversation |
grade.summary | string | এক অনুচ্ছেদের সারসংক্ষেপ |
grade.detected_issues | array | গ্রেডার দ্বারা শনাক্ত সমস্যার স্ট্রিং |
grade.status | string | সর্বদা completed — শুধুমাত্র সম্পন্ন রান ইভেন্ট পাঠায় |
grade.grader_model | string | কোন গ্রেডার ফলাফল তৈরি করেছে: দ্রুত অস্থায়ী গ্রেডের জন্য heuristic-v1 (অথবা অন্য ThunderPhone নিয়মভিত্তিক গ্রেডার), পূর্ণ গ্রেডের জন্য thunderphone-grader। এটি একটি ThunderPhone লেবেল, কোনো AI মডেলের নাম নয় |
grade.graded_at, grade.created_at | timestamp | |
report | object | 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_id | integer | null | কলটি পরিচালনা করা এজেন্ট, যদি কোনো এজেন্ট নিয়োগ করা হয়ে থাকে |
agent_name | string | null | কলটি পরিচালনা করা এজেন্ট, যদি কোনো এজেন্ট নিয়োগ করা হয়ে থাকে |
summary | string | null | এজেন্টের কলের সারসংক্ষেপ তৈরি করুন চালু থাকলে সম্পূর্ণ কলের সারসংক্ষেপ; তাই দেরিতে আসা এক্সট্রাকশন ইভেন্ট এমন সারসংক্ষেপও প্রদান করে যা সমাপ্তির সময়সীমা মিস করেছে; অন্যথায় null। সারসংক্ষেপ আছে কিন্তু এক্সট্রাকশন ক্ষেত্র নেই এমন এজেন্টরা কখনও এই ইভেন্ট পাঠায় না: GET /v1/calls/{call_id} থেকে দেরিতে আসা সারসংক্ষেপ পড়ুন |
extracted_data.status | string | এই ইভেন্টের জন্য সর্বদা completed |
extracted_data.fields | object | কনফিগার করা এক্সট্রাকশন ক্ষেত্র কী অনুযায়ী মান; অনুপলব্ধ মান null |
extracted_data.evidence | object | এক্সট্রাকশন ক্ষেত্র অনুযায়ী প্রমাণ। একটি নন-নাল মানে সঠিকভাবে কাঠামোগতভাবে যাচাই করা উদ্ধৃতি থাকে (সর্বোচ্চ 1,000 অক্ষর), speaker_role (caller অথবা agent), এবং turn_index; মডেল-ফেরত দীর্ঘ উদ্ধৃতিগুলো সংক্ষিপ্ত করার পরিবর্তে প্রত্যাখ্যান করা হয়, এবং কোনো ক্ষেত্র null হলে তার প্রমাণও null হয় |
extracted_data.verification | string | প্রতিটি প্রার্থী ক্ষেত্রের জন্য স্বাধীন প্রমাণ পাস ঠিক একটি বৈধ রায় ফেরত দিলেই শুধু verified। unavailable অর্থ পাসটি ব্যর্থ হয়েছে, সময় শেষ হয়েছে, যথেষ্ট বাজেট ছিল না, অথবা বিকৃত কিংবা আংশিক আউটপুট ফেরত দিয়েছে। সম্পূর্ণ অনুপলব্ধ পাস গ্রাহক পর্যালোচনার জন্য কাঠামোগতভাবে ভিত্তিক মানগুলো সংরক্ষণ করে। আংশিক আউটপুটের ক্ষেত্রে বৈধ রায় প্রয়োগ করা হয় এবং ঠিক একটি বৈধ রায় ছাড়া প্রতিটি প্রার্থীকে নাল করা হয় |
extracted_data.field_reasons | object | কাঠামোগত ভিত্তি বা স্বাধীন যাচাইকারী দ্বারা নাল করা ক্ষেত্রগুলোর কারণ, ক্ষেত্র অনুযায়ী |
extracted_data.schema_version | string | এই এক্সট্রাকশনের জন্য ব্যবহৃত সঠিক ক্ষেত্র স্কিমার হ্যাশ |
extracted_at | timestamp | ISO 8601 সমাপ্তির সময় |
model | string | সর্বদা 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_id | integer | null | কোনো এজেন্ট নিযুক্ত থাকলে, কলটি পরিচালনাকারী এজেন্ট |
agent_name | string | null | কোনো এজেন্ট নিযুক্ত থাকলে, কলটি পরিচালনাকারী এজেন্ট |
issue_report.severity | string | critical, warning, বা info |
issue_report.status | string | open বা resolved |
issue_report.source | string | user (ড্যাশবোর্ড থেকে জমা দেওয়া) বা 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"
}| ফিল্ড | ধরন | বিবরণ |
|---|---|---|
automatic | boolean | স্বয়ংক্রিয় এসকেলেশনের জন্য true; ম্যানুয়াল এসকেলেশনের জন্য false |
cluster_id | UUID | এসকেলেট করা সমস্যা প্যাটার্ন |
escalation_id | UUID | এসকেলেশন রেকর্ড |
status | string | ইভেন্ট পাঠানোর সময় 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_id | integer | null | অ্যাসাইন করা থাকলে কলটি পরিচালনা করা এজেন্ট |
agent_name | string | null | অ্যাসাইন করা থাকলে কলটি পরিচালনা করা এজেন্ট |
test_call_run.target_type | string | agent বা phone_number |
test_call_run.target_id | integer | রানটি যে এজেন্ট id বা ফোন-নম্বর id-কে লক্ষ্য করেছে, তা target_type-এর সঙ্গে মেলে |
test_call_run.status | string | completed বা failed |
test_call_run.call_id | integer | null | কল দেওয়ার আগে রান ব্যর্থ হলে null |
test_call_run.error_message | string | সফল হলে খালি |
অ্যালার্ট ইভেন্ট
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 (in data) | UUID | অ্যালার্টের ট্রিগার হওয়ার id — এনভেলপের ডেলিভারি event_id থেকে আলাদা |
rule_id, rule_name | UUID, string | যে নিয়মটি ট্রিগার হয়েছে |
metric | string | success_rate, failure_rate, avg_score, call_volume, বা suite_regression |
comparator | string | lt, lte, gt, বা gte |
metric_value | number | নিয়মটি ট্রিগার হওয়ার সময় উইন্ডো জুড়ে মেট্রিকের মান |
threshold | number | কনফিগার করা থ্রেশহোল্ড |
window_hours | integer | শেষের দিকের মূল্যায়ন উইন্ডো |
fired_at | timestamp |
নিয়ম, মেট্রিক, কুলডাউন এবং ইমেল / 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 | string | E.164 ফরম্যাটে নম্বরটি |
phone_number_id | integer | null | ফোন নম্বর-এ এর id |
spam_risk | string | medium বা high |
previous_spam_risk | string | null | সর্বশেষ রিডিংয়ের ঝুঁকি; প্রথমটির আগে null |
spam_category | string | null | ক্যারিয়াররা যে লেবেল দেখাতে পারে, যেমন Telemarketer বা Survey। এটিকে মুক্ত টেক্সট হিসেবে বিবেচনা করুন |
scores | object | প্রতিটি 0 থেকে 100, অথবা পর্যাপ্ত কল ভলিউম না হওয়া পর্যন্ত null: maturity (নম্বরটি কতটা প্রতিষ্ঠিত), connection (মানুষ কলের উত্তর দেয় কি না), engagement (তারা কলে থাকে কি না), sentiment (তারা এটি ব্লক বা রিপোর্ট করে কি না) |
checked_at | timestamp | 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.id | UUID | মাইগ্রেশনটি |
migration.routing_id | UUID | রাউট করা কলটি, যা আপনি কল করার সময় পেয়েছেন |
migration.arm | string | ours (ThunderPhone কলটি করেছে) অথবা vendor (অন্য প্ল্যাটফর্মটি করেছে) |
migration.vendor | string | retell, vapi, elevenlabs, অথবা bland |
migration.vendor_call_id | string | null | অন্য প্ল্যাটফর্মের কল id; ours-এর জন্য null |
migration.metadata | object | কল করার সময় আপনার পাঠানো metadata |
migration.vendor_cost_usd | string | null | অন্য প্ল্যাটফর্মটি কলের খরচ হিসেবে যা রিপোর্ট করেছে, যদি করে থাকে |
call_id | integer | null | ThunderPhone কল id; vendor-এর জন্য null |
status | string | vendor-এর জন্য: যাকে কল করা হয়েছে তিনি কথা বললে 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_id | UUID | মাইগ্রেশন |
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 | টাইমস্ট্যাম্প |