Open in
แค็ตตาล็อกเหตุการณ์
ประเภทเหตุการณ์เว็บฮุกทั้งหมดที่ 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_id | integer | null | เอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์ |
agent_name | string | null | เอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์ |
returning_call | object | มีเฉพาะเมื่อหมายเลขโทรหาผู้โทรรายนี้ภายใน 30 วันที่ผ่านมา: call_id, agent_id, started_at และ outcome ของสายก่อนหน้า ดู การโทรกลับ |
sip_headers | object | มีเฉพาะเมื่อสายมาถึงพร้อมส่วนหัว SIP X-* หรือ User-to-User (ที่อยู่ SIP และการเชื่อมต่อ SIP ด้วยตนเอง): ชื่อส่วนหัวเป็นตัวพิมพ์เล็ก → ค่า ดู ส่วนหัว SIP |
telephony.complete
ส่งเมื่อสายโทรศัพท์ขาเข้าหรือขาออกสิ้นสุดลง ไม่บล็อกการทำงาน รวมทรานสคริปต์ URL ของไฟล์บันทึกเสียงเมื่อมี และสรุปการเรียกเก็บเงิน โปรดดู
telephony.complete / web.completeสำหรับสคีมาเพย์โหลด
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
agent_id | integer | null | เอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์ |
agent_name | string | 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_id | integer | null | เอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์ |
agent_name | string | 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_id | integer | null | เอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์ |
agent_name | string | null | เอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์ |
position | integer | ดัชนีของเทิร์นในประวัติการโทร ซึ่งเป็นตัวระบุที่คงที่สำหรับการเรียงลำดับ |
role | string | assistant (เสียงพูดของเอเจนต์) หรือ user (เสียงพูดของผู้โทร) |
text | string | ข้อความทรานสคริปต์ของเทิร์นตามที่ทราบ ณ เวลาที่ส่งออก |
entry_type | string | ประเภทของรายการประวัติต้นทาง: completion (เอเจนต์) หรือ user_turn / span (ผู้โทร) |
start_ms, end_ms | integer | ตำแหน่งออฟเซ็ตเสียงเป็น 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_id | integer | null | เอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์ |
agent_name | string | null | เอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์ |
web.complete
เทียบเท่ากับ telephony.complete สำหรับช่องทางเว็บ ครอบคลุมสายวิดเจ็ตเว็บ (direction: "web") และสายทดสอบไมโครโฟนของตัวสร้าง (direction: "test") ไม่บล็อกการทำงาน มีรูปแบบเพย์โหลดเดียวกับ
telephony.complete พร้อม origin_domain
และกำหนด from_number เป็น "web"
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
agent_id | integer | null | เอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์ |
agent_name | string | null | เอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์ |
web.tool
เทียบเท่ากับ telephony.tool สำหรับช่องทางเว็บ data มี
origin_domain แทน from_number / to_number
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
agent_id | integer | null | เอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์ |
agent_name | string | null | เอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์ |
web.turn
เทียบเท่ากับ telephony.turn สำหรับช่องทางเว็บ ครอบคลุมสายวิดเจ็ตเว็บและสายทดสอบไมโครโฟนของตัวสร้าง มีรูปแบบเพย์โหลดเดียวกัน โดยใช้ origin_domain แทน from_number / to_number เช่นเดียวกับ telephony.turn จำเป็นต้อง สมัครรับอย่างชัดเจน และจะไม่ถูกส่งผ่านอาร์เรย์ events ที่ว่างเปล่า
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
agent_id | integer | null | เอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์ |
agent_name | string | 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_id | integer | สายที่ถูกโอน |
agent_id | integer | null | เอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์ |
agent_name | string | null | เอเจนต์ที่จัดการสาย เมื่อมีการกำหนดเอเจนต์ |
transfer_outcome | string | refer_accepted: ผู้ให้บริการรับช่วงสาย bridged: ThunderPhone คงการเชื่อมต่อระหว่างผู้โทรกับปลายทางไว้เอง เนื่องจากผู้ให้บริการปฏิเสธการโอนสายแบบ cold หรือเอเจนต์ของการโอนสายแบบ warm ออกจากสาย bridge_unanswered: ผู้ให้บริการปฏิเสธการโอนสายแบบ cold และปลายทางไม่รับสายที่ ThunderPhone โทรออกเอง failed: การโอนสายไม่สำเร็จและสายสิ้นสุดลง |
destination | string | null | หมายเลขที่โอนสายไปยัง |
sip_status | integer | null | สถานะ SIP ของผู้ให้บริการเมื่อปฏิเสธการโอนสายแบบ cold: 403 (เช่น trunk ของ Twilio ที่ไม่มีการโอนสาย), 405 หรือ 501 เป็น null เมื่อผู้ให้บริการไม่ได้ปฏิเสธ |
bridge_kind | string | null | เฉพาะ bridged: cold_fallback (การโอนสายแบบ cold ที่ถูกปฏิเสธซึ่ง ThunderPhone เชื่อมต่อให้) หรือ warm (บุคคลสองคนในการโอนสายแบบ 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 สองรายการอาจมาถึงไม่เรียงลำดับ เก็บเหตุการณ์ที่มี 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
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
id | string | ID ของการส่งตามกำหนดเวลา |
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 | ready สำหรับ voice.ready; failed สำหรับ voice.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 | จำนวนเต็ม | null | เอเจนต์ที่รับสาย เมื่อมีการกำหนดเอเจนต์ |
agent_name | สตริง | null | เอเจนต์ที่รับสาย เมื่อมีการกำหนดเอเจนต์ |
grade.id | จำนวนเต็ม | ID ของเกรด |
grade.score | จำนวนเต็ม | null | 0–100 |
grade.call_outcome | สตริง | success, failure, unknown หรือ no_conversation |
grade.summary | สตริง | สรุปหนึ่งย่อหน้า |
grade.detected_issues | อาร์เรย์ | สตริงปัญหาที่ผู้ตรวจพบ |
grade.status | สตริง | เป็น completed เสมอ — ระบบจะส่งเฉพาะการรันที่เสร็จสิ้นแล้ว |
grade.grader_model | สตริง | ผู้ตรวจที่สร้างผลลัพธ์: heuristic-v1 (หรือผู้ตรวจตามกฎของ 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_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 หรือเมื่อ 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"
}| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
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 (ใน 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 โทรออกจะส่ง 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.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 | รหัสการโทรของแพลตฟอร์มอื่น โดยเป็น null สำหรับ ours |
migration.metadata | object | metadata ที่คุณส่งเมื่อเริ่มการโทร |
migration.vendor_cost_usd | string | null | ค่าใช้จ่ายของการโทรตามที่แพลตฟอร์มอื่นรายงาน หากมีการรายงาน |
call_id | integer | null | รหัสการโทรของ ThunderPhone โดยเป็น null สำหรับ vendor |
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
ส่งเมื่อการสลับแบบค่อยเป็นค่อยไปของการย้ายข้อมูลย้ายทุกสายกลับไปยัง แพลตฟอร์มอื่นโดยอัตโนมัติ: การโทร 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_id | UUID | การย้ายข้อมูล |
vendor | string | retell, vapi, elevenlabs หรือ bland |
reason | string | ours_failed_burst (การเชื่อมต่อล้มเหลว 3 ครั้งภายใน 15 นาที), dropped_calls (การโทร 2 สายสิ้นสุดลงก่อนเอเจนต์รับสาย ภายใน 30 นาที) หรือ rate_gap (ส่วนต่างของอัตราผลลัพธ์งานจากการโทรที่ได้รับการประเมินอย่างน้อย rollback_min_calls สายต่อแต่ละฝ่าย) |
previous_percent | integer | สัดส่วนสายของ ThunderPhone ก่อนการย้อนกลับ |
ours_percent | integer | เป็น 0 เสมอ |
step | integer | null | ขั้นตอนกำหนดการที่ใช้งานอยู่ (เริ่มนับจาก 0) |
ours / theirs | object | null | การโทรที่ได้รับการประเมินในขั้นตอนปัจจุบันและอัตราความสำเร็จของการโทรเหล่านั้น; theirs อาจเป็นข้อมูลจาก 30 วันล่าสุดเมื่อขั้นตอนนั้นมีการโทรน้อยเกินไป null เมื่อไม่มีการโทร |
ours_failed | integer | จำนวนการเชื่อมต่อล้มเหลวที่นับใน 15 นาทีล่าสุด |
dropped | integer | จำนวนสายที่นับว่าเป็นสายหลุดใน 30 นาทีล่าสุด |
rolled_back_at | timestamp |