ThunderPhone v3 এখন লাইভ।নিজেই ব্যবহার শুরু করুন, 2¢/মিনিট থেকে।ঘোষণাটি পড়ুন

Webhooks

ইভেন্ট ক্যাটালগ

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_idinteger | nullএজেন্ট নির্ধারিত থাকলে, কলটি পরিচালনা করা এজেন্ট
agent_namestring | nullএজেন্ট নির্ধারিত থাকলে, কলটি পরিচালনা করা এজেন্ট
returning_callobjectনম্বরটি গত 30 দিনের মধ্যে এই কলারকে কল করে থাকলেই কেবল উপস্থিত: আগের কলের call_id, agent_id, started_at এবং outcome। দেখুন কলব্যাক
sip_headersobjectকলটি X-* বা User-to-User SIP হেডারসহ এলে তবেই উপস্থিত (SIP ঠিকানা এবং ম্যানুয়াল SIP সংযোগ): ছোট হাতের হেডার নাম → মান। দেখুন SIP হেডার

telephony.complete

একটি ইনবাউন্ড বা আউটবাউন্ড টেলিফোনি কল শেষ হলে পাঠানো হয়। নন-ব্লকিং। এতে ট্রান্সক্রিপ্ট, উপলভ্য থাকলে রেকর্ডিং URL এবং বিলিং সারাংশ অন্তর্ভুক্ত থাকে। পে-লোড স্কিমার জন্য দেখুন telephony.complete / web.complete।

ফিল্ডধরনবিবরণ
agent_idinteger | nullএজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট
agent_namestring | 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_idinteger | nullএজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট
agent_namestring | 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_idinteger | nullএজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট
agent_namestring | nullএজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট
positionintegerকল ইতিহাসে turn-এর ইনডেক্স — ক্রম নির্ধারণের জন্য একটি স্থিতিশীল পরিচয়
rolestringassistant (এজেন্টের কথা) অথবা user (কলারের কথা)
textstringইমিশনের সময় জানা turn-এর ট্রান্সক্রিপ্ট টেক্সট
entry_typestringঅন্তর্নিহিত ইতিহাস এন্ট্রির ধরন: completion (এজেন্ট), অথবা user_turn / span (কলার)
start_ms, end_msintegerকল শুরুর পর থেকে 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_idinteger | nullএজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট
agent_namestring | nullএজেন্ট বরাদ্দ থাকলে কলটি পরিচালনাকারী এজেন্ট

web.complete

telephony.complete-এর ওয়েব-চ্যানেল সমতুল্য, যা ওয়েব widget কল (direction: "web") এবং builder mic test call (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-এর ওয়েব-চ্যানেল সমতুল্য, যা ওয়েব widget কল এবং builder mic test call অন্তর্ভুক্ত করে। একই পে-লোড আকৃতি, তবে from_number / to_number-এর পরিবর্তে origin_domain থাকে। telephony.turn-এর মতোই, এটির জন্য একটি স্পষ্ট সাবস্ক্রিপশন প্রয়োজন — এটি কখনোই খালি events array-এর মাধ্যমে ডেলিভার করা হয় না।

ফিল্ডধরনবিবরণ
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_idintegerযে কলটি ট্রান্সফার করা হয়েছিল
agent_idinteger | nullকোনো এজেন্ট নিযুক্ত থাকলে, কলটি পরিচালনা করা এজেন্ট
agent_namestring | nullকোনো এজেন্ট নিযুক্ত থাকলে, কলটি পরিচালনা করা এজেন্ট
transfer_outcomestringrefer_accepted: ক্যারিয়ার কলটির দায়িত্ব নিয়েছে। bridged: ক্যারিয়ার কোল্ড ট্রান্সফার প্রত্যাখ্যান করায় বা ওয়ার্ম ট্রান্সফারের এজেন্ট সরে যাওয়ায় ThunderPhone নিজেই কলার ও গন্তব্যকে সংযুক্ত রেখেছে। bridge_unanswered: ক্যারিয়ার একটি কোল্ড ট্রান্সফার প্রত্যাখ্যান করেছে এবং গন্তব্য ThunderPhone-এর নিজস্ব কলের উত্তর দেয়নি। failed: ট্রান্সফার সম্পন্ন হয়নি এবং কল শেষ হয়েছে
destinationstring | nullযে নম্বরে কলটি ট্রান্সফার করা হয়েছিল
sip_statusinteger | nullকোল্ড ট্রান্সফার প্রত্যাখ্যান করার সময় ক্যারিয়ারের SIP স্ট্যাটাস: 403 (উদাহরণস্বরূপ, কল ট্রান্সফারবিহীন একটি Twilio ট্রাঙ্ক), 405 বা 501। ক্যারিয়ার এটি প্রত্যাখ্যান না করলে null
bridge_kindstring | nullশুধুমাত্র bridged: cold_fallback (প্রত্যাখ্যাত একটি কোল্ড ট্রান্সফার যা ThunderPhone সংযুক্ত করেছে) অথবা warm (এজেন্ট চলে যাওয়ার পরে ওয়ার্ম ট্রান্সফারের দুই ব্যক্তি)
bridge_secondsinteger | nullশুধুমাত্র bridged: ThunderPhone যে ব্রিজ সময়ের জন্য বিল করেছে, সেকেন্ডে
bridge_total_centsinteger | 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_idintegerযে কলে বিল করা হয়েছে
agent_idinteger | nullকোনো এজেন্ট নিযুক্ত থাকলে, কলটি পরিচালনা করা এজেন্ট
agent_namestring | nullকোনো এজেন্ট নিযুক্ত থাকলে, কলটি পরিচালনা করা এজেন্ট
reasonstringsettled: কলের চার্জ। adjusted: চার্জের পরে আসা ব্যবহার, যা চার্জ বাড়িয়েছে (চার্জ কখনও কমানো হয় না)
billing_seqintegerচার্জের জন্য 1, তারপর প্রতিটি বৃদ্ধির জন্য 2, 3, ...। প্রাপ্ত সর্বোচ্চটিই কলের বর্তমান বিলিং
billable_minutesnumberবিল করা মিনিট, নিকটতম এক-চতুর্থাংশ মিনিটে রাউন্ড করা
billing_total_centsintegerযেকোনো বিনামূল্যের কল ক্রেডিটের পর, adjusted বৃদ্ধি-সহ, এ পর্যন্ত কলের জন্য চার্জ করা সবকিছু USD সেন্টে
adjustment_centsinteger | 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-এর মতোই ফিল্ড থাকে।

ফিল্ডধরনবিবরণ
idstringনির্ধারিত পাঠানোর আইডি
typestringsms বা call
statusstringskipped বা failed
reasonstringকেন, উপরে বর্ণিত অনুযায়ী; পাঠানোর status_reason-এর একই মান
detailstringপঠনযোগ্য ব্যাখ্যা
sourcestringকী পাঠানোটি তৈরি করেছে: api
external_idstring | nullপাঠানোর জন্য আপনার কী, অথবা null
from_numberstringপাঠানোর নম্বর
tostringসর্বদা "[REDACTED]"
agent_idinteger | nullকল: এজেন্ট; টেক্সট: null
send_at, expires_at, created_attimestampISO 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.idstringকাস্টম ভয়েসের পাবলিক আইডি
voice.namestringcustom:<public_id> ফর্মে এজেন্ট ভয়েসের মান
voice.display_namestringসংস্থার জন্য প্রদর্শিত ভয়েসের নাম
voice.languagestringক্লোনের একক ভাষা কোড
voice.genderstringmale, female, অথবা একটি খালি স্ট্রিং
voice.statusstringvoice.ready-এর জন্য ready; voice.failed-এর জন্য failed
voice.failure_reasonstringসফল হলে খালি; ব্যর্থ হলে প্রক্রিয়াকরণ ব্যর্থতার বিবরণ
voice.created_at, voice.updated_attimestampISO 8601 টাইমস্ট্যাম্প
reasonstringব্যর্থতার বিবরণ; শুধু 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 (in 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_numberstringE.164 ফরম্যাটে নম্বরটি
phone_number_idinteger | nullফোন নম্বর-এ এর id
spam_riskstringmedium বা high
previous_spam_riskstring | nullসর্বশেষ রিডিংয়ের ঝুঁকি; প্রথমটির আগে null
spam_categorystring | nullক্যারিয়াররা যে লেবেল দেখাতে পারে, যেমন Telemarketer বা Survey। এটিকে মুক্ত টেক্সট হিসেবে বিবেচনা করুন
scoresobjectপ্রতিটি 0 থেকে 100, অথবা পর্যাপ্ত কল ভলিউম না হওয়া পর্যন্ত null: maturity (নম্বরটি কতটা প্রতিষ্ঠিত), connection (মানুষ কলের উত্তর দেয় কি না), engagement (তারা কলে থাকে কি না), sentiment (তারা এটি ব্লক বা রিপোর্ট করে কি না)
checked_attimestampThunderPhone কখন ফলাফলটি পড়েছে

মাইগ্রেশন ইভেন্ট

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অন্য প্ল্যাটফর্মের কল id; ours-এর জন্য null
migration.metadataobjectকল করার সময় আপনার পাঠানো metadata
migration.vendor_cost_usdstring | nullঅন্য প্ল্যাটফর্মটি কলের খরচ হিসেবে যা রিপোর্ট করেছে, যদি করে থাকে
call_idinteger | nullThunderPhone কল id; 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টাইমস্ট্যাম্প

সম্পর্কিত