ThunderPhone v3 พร้อมให้ใช้งานแล้วเริ่มใช้งานได้ด้วยตัวเอง ราคาเริ่มต้น 2 เซนต์ต่อนาที.อ่านประกาศเปิดตัว

Webhooks

แค็ตตาล็อกเหตุการณ์

ประเภทเหตุการณ์เว็บฮุกทั้งหมดที่ ThunderPhone ส่งออก

เนื้อหา webhook ทุกรายการมีฟิลด์ type ซึ่งมีค่าเป็นหนึ่งในประเภทเหตุการณ์ ในหน้านี้ เมื่อคุณสมัครรับข้อมูลสำหรับ ปลายทาง อาร์เรย์ events ต้องมี ประเภทเหตุการณ์ที่คุณต้องการ (หรือเว้นว่างเพื่อสมัครรับข้อมูลทุกประเภท — ยกเว้นเหตุการณ์รายเทิร์น telephony.turn / web.turn และเหตุการณ์ความคืบหน้าแบบสด call.status_changed ซึ่งจะส่งไปยัง ปลายทางที่ระบุชื่อเหตุการณ์เหล่านี้อย่างชัดเจนเท่านั้น)

เหตุการณ์เหล่านี้มีรูปแบบการส่งสองแบบ:

  • การส่งไปยัง Endpoint เป็นการแจ้งเตือนแบบ ไม่บล็อก เสมอ พร้อมการลองใหม่: ตอบกลับด้วยสถานะ 2xx ใดก็ได้ โดยซองข้อมูลมี event_id สำหรับขจัดข้อมูลซ้ำ
  • การแลกเปลี่ยนแบบ บล็อก ทำงานเฉพาะบนเว็บฮุก URL เดียวแบบเดิมเท่านั้น ได้แก่คำขอกำหนดค่า telephony.incoming / web.incoming (หมายเลขในโหมดเว็บฮุก: 13 วินาที รวมการลองใหม่หนึ่งครั้ง; คีย์วิดเจ็ตในโหมดเว็บฮุก: 10 วินาที) และการส่งต่อเครื่องมือในโหมดเว็บฮุก การตอบกลับของคุณกำหนดรูปแบบของการโทรที่กำลังดำเนินอยู่

เพย์โหลดตัวอย่างด้านล่างแสดงซองข้อมูลปลายทางตามลำดับการส่ง (คีย์เรียงตามตัวอักษร: data, event_id, type); การส่งแบบรุ่นเดิม มี data เดียวกันโดยไม่มี event_id อยู่

เหตุการณ์การโทร

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_idinteger | nullเอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์
agent_namestring | nullเอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์
returning_callobjectมีเฉพาะเมื่อหมายเลขโทรหาผู้โทรรายนี้ภายใน 30 วันที่ผ่านมา: call_id, agent_id, started_at และ outcome ของสายก่อนหน้า ดู การโทรกลับ
sip_headersobjectมีเฉพาะเมื่อสายมาถึงพร้อมส่วนหัว SIP X-* หรือ User-to-User (ที่อยู่ 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] ทรานสคริปต์เมื่อเสร็จสิ้นจะปกปิดข้อมูลเหล่านี้เช่นกัน ให้ดึงเนื้อหาและผู้รับจากทรัพยากร SMS ที่กำหนดขอบเขตตามองค์กร โดยใช้ message_id จากการตอบกลับ

{
  "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 มี origin_domain แทน from_number / to_number

ฟิลด์ประเภทคำอธิบาย
agent_idinteger | nullเอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์
agent_namestring | nullเอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์

web.turn

เทียบเท่ากับ telephony.turn สำหรับช่องทางเว็บ ครอบคลุมสายวิดเจ็ตเว็บและสายทดสอบไมโครโฟนของตัวสร้าง มีรูปแบบเพย์โหลดเดียวกัน โดยใช้ origin_domain แทน from_number / to_number เช่นเดียวกับ telephony.turn จำเป็นต้อง สมัครรับอย่างชัดเจน และจะไม่ถูกส่งผ่านอาร์เรย์ events ที่ว่างเปล่า

ฟิลด์ประเภทคำอธิบาย
agent_idinteger | nullเอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์
agent_namestring | nullเอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์

call.transfer_completed

ส่งหนึ่งครั้งต่อการโทรหนึ่งสายพร้อมผลลัพธ์สุดท้ายของ การโอนสาย: การโอนสายแบบ cold หรือบริดจ์ระหว่างบุคคล ที่เหลืออยู่หลังจากเอเจนต์ออกจากการโอนสายแบบ warm ไม่บล็อก และส่งไปยังเอนด์พอยต์เท่านั้น (ไม่ส่งไปยัง webhook แบบ 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 คงการเชื่อมต่อระหว่างผู้โทรกับปลายทางไว้เอง เนื่องจากผู้ให้บริการปฏิเสธการโอนสายแบบ cold หรือเอเจนต์ของการโอนสายแบบ warm ออกจากสาย bridge_unanswered: ผู้ให้บริการปฏิเสธการโอนสายแบบ cold และปลายทางไม่รับสายที่ ThunderPhone โทรออกเอง failed: การโอนสายไม่สำเร็จและสายสิ้นสุดลง
destinationstring | nullหมายเลขที่โอนสายไปยัง
sip_statusinteger | nullสถานะ SIP ของผู้ให้บริการเมื่อปฏิเสธการโอนสายแบบ cold: 403 (เช่น trunk ของ Twilio ที่ไม่มีการโอนสาย), 405 หรือ 501 เป็น null เมื่อผู้ให้บริการไม่ได้ปฏิเสธ
bridge_kindstring | nullเฉพาะ bridged: cold_fallback (การโอนสายแบบ cold ที่ถูกปฏิเสธซึ่ง ThunderPhone เชื่อมต่อให้) หรือ warm (บุคคลสองคนในการโอนสายแบบ 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 สองรายการอาจมาถึงไม่เรียงลำดับ เก็บเหตุการณ์ที่มี billing_seq สูงสุดสำหรับแต่ละ call_id

{
  "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จำนวนเต็มยอดทั้งหมดที่เรียกเก็บจากการโทรจนถึงขณะนี้เป็นเซนต์ USD หลังหักเครดิตการโทรฟรี และรวมการเพิ่มขึ้นแบบ adjusted
adjustment_centsจำนวนเต็ม | nullเฉพาะ adjusted: ยอดเพิ่มขึ้นนี้เป็นเซนต์ USD หลังหักเครดิตการโทรฟรี

ยอดรวมเดียวกันนี้อยู่ใน ออบเจ็กต์การโทร ในชื่อ billable_minutes และ billing_total_cents event_id จะเหมือนกันในการส่งทุกครั้ง ของ billing_seq เดียวกัน ดังนั้นรายงานที่ส่งซ้ำจะไม่สร้างเหตุการณ์ที่สอง

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จำนวนเต็ม | ค่าว่างเอเจนต์ที่จัดการการโทร เมื่อมีการกำหนดเอเจนต์
agent_nameสตริง | ค่าว่างเอเจนต์ที่จัดการการโทร เมื่อมีการกำหนดเอเจนต์
directionสตริงทิศทางของการโทร เช่นเดียวกับในออบเจ็กต์การโทร
statusสตริงสถานะที่การโทรเข้าสู่ ดูตารางด้านล่าง
occurred_atการประทับเวลาเวลาที่เกิดขึ้น
hold_secondsจำนวนเต็ม | ค่าว่างเฉพาะ 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 เป็นผู้ตัดสินใจว่าจะทำอย่างไรกับกล่องข้อความเสียง จะไม่มีการส่งสถานะ voicemail; answered_by ใน telephony.complete ยังคงระบุเป็น 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: รหัสของ การส่งตามกำหนดเวลา ที่ส่งข้อความนั้น หรือ 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 ใน รุ่นปัจจุบัน การกำหนดค่าเว็บฮุกของผู้ให้บริการเครือข่ายขาเข้าและการตรวจสอบ ลายเซ็นจะเผยแพร่แยกต่างหาก


เหตุการณ์ที่กำหนดเวลาไว้

การส่งที่กำหนดเวลาไว้ที่ไม่ถูกส่งจะทริกเกอร์หนึ่งในเหตุการณ์เหล่านี้ การส่งที่ถูกส่งออกจะทริกเกอร์เหตุการณ์ตามปกติแทน ได้แก่ เหตุการณ์sms.*ที่ตั้งค่าscheduled_send_idสำหรับข้อความ เหตุการณ์การโทรสำหรับการโทร โดยมีscheduled_send_idอยู่ในtelephony.completeทั้งสองแบบไม่บล็อก เมื่อการส่งมีเอเจนต์ เอ็นด์พอยต์ที่กำหนดขอบเขตตามเอเจนต์สำหรับเอเจนต์นั้นจะได้รับเหตุการณ์เหล่านี้ด้วย

เพย์โหลดมีเฉพาะ ID สถานะ และเวลาเท่านั้น โดยจะไม่มีเนื้อหาข้อความ หรือตัวแปรหรือบริบทของการโทร และtoจะถูกปกปิดข้อมูล ดึงข้อมูลส่วนที่เหลือด้วยGET /v1/scheduled/{id}

scheduled.skipped

ส่งเมื่อไม่ได้ส่งรายการโดยตั้งใจ reasonอาจเป็นexpired(ไม่สามารถส่งออกได้ก่อนexpires_at) opted_out(หมายเลขอยู่ในรายการปฏิเสธการรับข้อความรวมถึงรายการที่เพิ่มหลังจากสร้างการส่ง) quiet_hours(ครบกำหนดนอกช่วง 8.00 น. ถึง 21.00 น.ตามเขตเวลาของผู้รับ) 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 คือข้อผิดพลาดของการส่งนั้นเอง: รหัสข้อผิดพลาด SMS เช่น carrier_rejected สำหรับข้อความ หรือเหตุผลที่สายถูกปฏิเสธหรือล้มเหลว เช่น กฎปลายทางที่ถูกบล็อก (ตัวอย่างเช่น premium_rate) หรือ agent_deleted เพย์โหลดมีฟิลด์เดียวกันกับ scheduled.skipped

ฟิลด์ประเภทคำอธิบาย
idstringID ของการส่งตามกำหนดเวลา
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.namestringค่าของเสียงเอเจนต์ในรูปแบบ custom:<public_id>
voice.display_namestringชื่อเสียงที่แสดงต่อองค์กร
voice.languagestringรหัสภาษาภาษาเดียวของโคลน
voice.genderstringmale, female หรือสตริงว่าง
voice.statusstringready สำหรับ voice.ready; failed สำหรับ voice.failed
voice.failure_reasonstringว่างเมื่อสำเร็จ รายละเอียดความล้มเหลวในการประมวลผลเมื่อไม่สำเร็จ
voice.created_at, voice.updated_attimestampการประทับเวลา ISO 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_idจำนวนเต็ม | nullเอเจนต์ที่รับสาย เมื่อมีการกำหนดเอเจนต์
agent_nameสตริง | nullเอเจนต์ที่รับสาย เมื่อมีการกำหนดเอเจนต์
grade.idจำนวนเต็มID ของเกรด
grade.scoreจำนวนเต็ม | null0–100
grade.call_outcomeสตริงsuccess, failure, unknown หรือ no_conversation
grade.summaryสตริงสรุปหนึ่งย่อหน้า
grade.detected_issuesอาร์เรย์สตริงปัญหาที่ผู้ตรวจพบ
grade.statusสตริงเป็น completed เสมอ — ระบบจะส่งเฉพาะการรันที่เสร็จสิ้นแล้ว
grade.grader_modelสตริงผู้ตรวจที่สร้างผลลัพธ์: heuristic-v1 (หรือผู้ตรวจตามกฎของ ThunderPhone รายอื่น) สำหรับเกรดชั่วคราวแบบรวดเร็ว และ thunderphone-grader สำหรับเกรดเต็มรูปแบบ เป็นป้ายกำกับของ ThunderPhone ไม่ใช่ชื่อโมเดล AI
grade.graded_at, grade.created_atการประทับเวลา
reportออบเจ็กต์ | nullรายงานการโทร สำหรับลูกค้า: ป้ายกำกับผลลัพธ์ แฟล็กและเหตุผลที่ต้องให้ความสนใจ ผู้โทร สรุปหนึ่งบรรทัด ประสบการณ์ของผู้โทร สำหรับเกรดฮิวริสติกระยะแรก ค่านี้เป็น null หรือรายงาน pending ที่มีฟิลด์เป็นตัวยึดตำแหน่ง เหตุการณ์ของเกรดเต็มรูปแบบจะมีรายงานที่เสร็จสมบูรณ์

call.data_extracted

ส่งเมื่อการดึงข้อมูลแบบมีโครงสร้างเสร็จสิ้นสำเร็จทุกครั้ง รวมถึงการลองใหม่ภายหลังจาก telephony.complete / web.complete หรือการรันใหม่ด้วยตนเองผ่านPOST /v1/calls/{call_id}/extract ไม่บล็อก

ในโหมดการดึงข้อมูลแบบบล็อก เหตุการณ์เสร็จสิ้นโดยปกติจะรอไม่เกินงบเวลาการดึงข้อมูล 75 วินาที หากกระบวนการ worker สำหรับการดึงข้อมูลสูญหาย ระบบระบายงานขั้นสุดท้ายของสภาพแวดล้อมการใช้งานจริงทุกห้านาทีจะปล่อยเหตุการณ์เสร็จสิ้นที่ 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จำนวนเต็ม | ค่าว่างเอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์
agent_nameสตริง | ค่าว่างเอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์
summaryสตริง | ค่าว่างสรุปสาย ที่เสร็จสมบูรณ์เมื่อเอเจนต์เปิด สร้างสรุปสาย ไว้ ดังนั้นเหตุการณ์การดึงข้อมูลที่มาถึงภายหลังจะส่งสรุปที่พลาดช่วงเวลาการเสร็จสิ้นมาด้วย มิฉะนั้นเป็น null เอเจนต์ที่มีสรุปแต่ไม่มีฟิลด์การดึงข้อมูลจะไม่ส่งเหตุการณ์นี้ ให้อ่านสรุปที่มาถึงภายหลังจาก GET /v1/calls/{call_id}
extracted_data.statusสตริงเป็น completed เสมอสำหรับเหตุการณ์นี้
extracted_data.fieldsออบเจ็กต์ค่าที่จัดเก็บโดยใช้คีย์ฟิลด์การดึงข้อมูลที่กำหนดไว้ ค่าที่ไม่พร้อมใช้งานจะเป็น null
extracted_data.evidenceออบเจ็กต์หลักฐานที่จัดเก็บโดยใช้ฟิลด์การดึงข้อมูล ค่าที่ไม่เป็นค่าว่างจะมีข้อความอ้างอิงที่ตรวจสอบโครงสร้างอย่างแม่นยำแล้ว ความยาวไม่เกิน 1,000 อักขระ พร้อม speaker_role (caller หรือ agent) และ turn_index ข้อความอ้างอิงที่โมเดลส่งกลับมายาวกว่านั้นจะถูกปฏิเสธแทนการตัดทอน และหลักฐานจะเป็น null ทุกครั้งที่ฟิลด์ของหลักฐานนั้นเป็น null
extracted_data.verificationสตริงเป็น verified เฉพาะเมื่อรอบตรวจสอบหลักฐานแบบอิสระส่งผลตัดสินที่ถูกต้องเพียงหนึ่งรายการสำหรับทุกฟิลด์ผู้สมัคร unavailable หมายความว่ารอบตรวจสอบล้มเหลว หมดเวลา มีงบประมาณไม่เพียงพอ หรือส่งเอาต์พุตที่มีรูปแบบไม่ถูกต้องหรือไม่ครบถ้วน รอบตรวจสอบที่ไม่พร้อมใช้งานทั้งหมดจะเก็บค่าที่อ้างอิงตามโครงสร้างไว้เพื่อให้ลูกค้าตรวจสอบ สำหรับเอาต์พุตบางส่วน จะใช้ผลตัดสินที่ถูกต้อง และตั้งค่าผู้สมัครแต่ละรายการที่ไม่มีผลตัดสินที่ถูกต้องเพียงหนึ่งรายการเป็นค่าว่าง
extracted_data.field_reasonsออบเจ็กต์เหตุผลที่จัดเก็บโดยใช้ฟิลด์ซึ่งถูกตั้งเป็นค่าว่างจากการอ้างอิงตามโครงสร้างหรือตัวตรวจสอบอิสระ
extracted_data.schema_versionสตริงแฮชของสคีมาฟิลด์ที่ใช้สำหรับการดึงข้อมูลนี้โดยตรง
extracted_atการประทับเวลาเวลาเสร็จสิ้นในรูปแบบ ISO 8601
modelสตริงเป็น thunderphone-extractor เสมอ: ป้ายกำกับของ ThunderPhone สำหรับโมเดลการดึงข้อมูล ไม่ใช่ชื่อของโมเดล AI

campaign.completed

ส่งหนึ่งครั้งเมื่อแคมเปญเปลี่ยนจาก running เป็น completed ไม่ว่ากำหนดการจะสิ้นสุดลงหรือผู้ติดต่อทั้งหมดเข้าสู่สถานะสุดท้ายแล้ว การลองใหม่ของ runner จะไม่ส่งเหตุการณ์อื่น เหตุการณ์วงจรชีวิตระดับองค์กรนี้จะส่งไปยังปลายทางที่กำหนดขอบเขตระดับองค์กรเท่านั้น ไม่ส่งไปยังปลายทางที่กำหนดขอบเขตระดับเอเจนต์ ไม่บล็อก

{
  "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 หรือเมื่อ Fix with 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"
}
ฟิลด์ประเภทคำอธิบาย
automaticbooleantrue สำหรับการยกระดับอัตโนมัติ 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_idintegerID เอเจนต์หรือ 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)UUIDID การทริกเกอร์การแจ้งเตือน — แตกต่างจาก 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_numberstringหมายเลขในรูปแบบ E.164
phone_number_idinteger | nullid ของหมายเลขใน หมายเลขโทรศัพท์
spam_riskstringmedium หรือ high
previous_spam_riskstring | nullความเสี่ยงจากผลการตรวจสอบครั้งล่าสุด โดยเป็น null ก่อนการตรวจสอบครั้งแรก
spam_categorystring | nullป้ายกำกับที่ผู้ให้บริการเครือข่ายอาจแสดง เช่น Telemarketer หรือ Survey ให้ถือเป็นข้อความอิสระ
scoresobjectค่าแต่ละรายการตั้งแต่ 0 ถึง 100 หรือเป็น null จนกว่าจะมีปริมาณการโทรเพียงพอ: maturity (หมายเลขมีการใช้งานมานานเพียงใด), connection (ผู้คนรับสายหรือไม่), engagement (ผู้คนอยู่ในสายต่อหรือไม่), sentiment (ผู้คนบล็อกหรือรายงานหมายเลขหรือไม่)
checked_attimestampเวลาที่ ThunderPhone อ่านผลลัพธ์

เหตุการณ์การย้ายระบบ

migration.call.complete

ส่งเมื่อการโทรที่โทรผ่าน POST /v1/migrations/{id}/calls สิ้นสุดลง ไม่ว่าแพลตฟอร์มใดจะรับสาย การทำงานแบบไม่บล็อก ระบบจะส่งภายในประมาณ 5 นาทีหลังการโทรสิ้นสุด data มีทุกฟิลด์ของ telephony.complete พร้อมบล็อก migration การโทรที่ ThunderPhone โทรออกจะส่ง telephony.complete ตามปกติด้วย โดยมี call_id เดียวกัน 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รหัสการโทรของแพลตฟอร์มอื่น โดยเป็น null สำหรับ ours
migration.metadataobjectmetadata ที่คุณส่งเมื่อเริ่มการโทร
migration.vendor_cost_usdstring | nullค่าใช้จ่ายของการโทรตามที่แพลตฟอร์มอื่นรายงาน หากมีการรายงาน
call_idinteger | nullรหัสการโทรของ ThunderPhone โดยเป็น null สำหรับ vendor
statusstringสำหรับ 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

ส่งเมื่อการสลับแบบค่อยเป็นค่อยไปของการย้ายข้อมูลย้ายทุกสายกลับไปยัง แพลตฟอร์มอื่นโดยอัตโนมัติ: การโทร 3 สายเชื่อมต่อกับ ThunderPhone ไม่สำเร็จภายใน 15 นาที การโทร 2 สายที่ส่งไปยัง ThunderPhone สิ้นสุดลงก่อนเอเจนต์รับสาย หรือ อัตราผลลัพธ์งานของ 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การย้ายข้อมูล
vendorstringretell, vapi, elevenlabs หรือ bland
reasonstringours_failed_burst (การเชื่อมต่อล้มเหลว 3 ครั้งภายใน 15 นาที), dropped_calls (การโทร 2 สายสิ้นสุดลงก่อนเอเจนต์รับสาย ภายใน 30 นาที) หรือ rate_gap (ส่วนต่างของอัตราผลลัพธ์งานจากการโทรที่ได้รับการประเมินอย่างน้อย rollback_min_calls สายต่อแต่ละฝ่าย)
previous_percentintegerสัดส่วนสายของ ThunderPhone ก่อนการย้อนกลับ
ours_percentintegerเป็น 0 เสมอ
stepinteger | nullขั้นตอนกำหนดการที่ใช้งานอยู่ (เริ่มนับจาก 0)
ours / theirsobject | nullการโทรที่ได้รับการประเมินในขั้นตอนปัจจุบันและอัตราความสำเร็จของการโทรเหล่านั้น; theirs อาจเป็นข้อมูลจาก 30 วันล่าสุดเมื่อขั้นตอนนั้นมีการโทรน้อยเกินไป null เมื่อไม่มีการโทร
ours_failedintegerจำนวนการเชื่อมต่อล้มเหลวที่นับใน 15 นาทีล่าสุด
droppedintegerจำนวนสายที่นับว่าเป็นสายหลุดใน 30 นาทีล่าสุด
rolled_back_attimestamp

ที่เกี่ยวข้อง