Open in
ดำเนินการโทรจาก Slack หรือแอปแชต
สร้างบอต Slack, Teams หรือเว็บแชตของคุณเองที่เริ่มการโทร ติดตามการโทรแบบสด กำกับเอเจนต์ และตอบคำถามของเอเจนต์ โดยใช้ API สาธารณะ
คุณสามารถควบคุมเอเจนต์จากแอปแชตที่ทีมของคุณใช้อยู่แล้วได้ ข้อความหนึ่งข้อความ จะเริ่มการโทร การโทรดำเนินไปแบบสดในเธรด การตอบกลับในเธรด จะกำหนดทิศทางให้เอเจนต์ เมื่อเอเจนต์ต้องการการตัดสินใจ เอเจนต์จะถามคุณที่นั่นและ รอคำตอบของคุณ
ThunderPhone ไม่ได้โฮสต์บอตนี้ให้คุณ คุณ (หรือ AI เอเจนต์สำหรับเขียนโค้ดของคุณ) สร้าง เซิร์ฟเวอร์ขนาดเล็กที่เชื่อมต่อแอปแชตของคุณกับ API สาธารณะ หน้านี้แสดง องค์ประกอบต่างๆ ซึ่งเหมือนกันสำหรับ Slack, Microsoft Teams, Discord หรือหน้าเว็บแชตส่วนตัว โดยตัวอย่างใช้ Slack
การทำงานร่วมกัน
| สิ่งที่คุณทำในแชต | สิ่งที่บอตของคุณเรียกใช้ | สิ่งที่เกิดขึ้น |
|---|---|---|
| ส่ง "โทรหา Comcast และขอ ETA ของเหตุขัดข้อง" | POST /v1/call พร้อมข้อความเป็น context | เอเจนต์โทรออก บอตของคุณเปิดเธรดสำหรับการโทร |
| ดูเธรด | รับเว็บฮุก telephony.turn | แต่ละบรรทัดที่เอเจนต์หรืออีกฝ่ายพูดจะแสดงในเธรด |
| ตอบกลับในเธรดระหว่างการโทร | POST /v1/calls/{call_id}/whisper | เอเจนต์ได้รับข้อความของคุณแบบส่วนตัวและดำเนินการตามนั้น อีกฝ่ายจะไม่ได้ยินข้อความนี้ |
| ตอบคำถามของเอเจนต์ | ปลายทางเครื่องมือ ของคุณส่งคืนคำตอบ หรือส่งคำตอบในภายหลังด้วย POST /v1/calls/{call_id}/tool-results | เอเจนต์ดำเนินการโทรต่อโดยใช้คำตอบนั้น ในโหมดพักสาย อีกฝ่ายจะได้ยินเพลงรอสายระหว่างนั้น |
| อ่านผลลัพธ์ | รับ telephony.complete | บอตของคุณโพสต์สรุปและผลลัพธ์ |
บอตของคุณเก็บการแมปหนึ่งรายการ: เธรดแชตใดเป็นของ call_id ใด
ก่อนเริ่มต้น
- คีย์ API เก็บไว้บนเซิร์ฟเวอร์ของคุณและห้ามเก็บในเบราว์เซอร์หรือแชต สร้างคีย์ได้ที่ การตั้งค่าองค์กร → คีย์ (ดู คีย์)
- หมายเลขที่เปิดใช้การโทรออกและเอเจนต์ สำหรับการโทร ข้อความ
จะกลายเป็น
contextสำหรับแต่ละการโทร ดังนั้นเอเจนต์ทั่วไปหนึ่งตัวจึงจัดการทุกงานได้ - เซิร์ฟเวอร์ ที่รับเว็บฮุกได้ เช่น Railway, Fly.io, Render หรือ โฮสต์ของคุณเอง
- ปลายทางเว็บฮุก ที่ชี้ไปยังเซิร์ฟเวอร์นั้นและสมัครรับ
telephony.turnและtelephony.completeเหตุการณ์ turn จะส่งไปยัง ปลายทางที่ระบุเหตุการณ์เหล่านี้เท่านั้น ดู เว็บฮุก เหตุการณ์ turn ต้องเปิดการบันทึกการโทรของเอเจนต์ และsummaryหลังจบการโทรต้องเปิดการตั้งค่า สร้างสรุปการโทร ของเอเจนต์ มิฉะนั้น ฟิลด์เหล่านั้นจะยังคงว่าง - แอปแชตของคุณเอง สำหรับ Slack ให้สร้างแอปในเวิร์กสเปซของคุณที่ api.slack.com/apps
1. เริ่มการโทรจากข้อความ
เมื่อบอตของคุณได้รับข้อความ (ข้อความโดยตรงหรือการ @mention)
ให้ตอบรับคำขอของ Slack ทันที (Slack จะลองส่งซ้ำหากไม่ได้รับการตอบรับภายใน 3 วินาที) และดำเนินการส่วนที่เหลือในเบื้องหลัง ตรวจสอบว่า
ผู้ส่งได้รับอนุญาตให้โทรหรือไม่ จากนั้นเริ่มการโทรโดยใช้ข้อความเป็น context:
curl -X POST https://api.thunderphone.com/v1/call \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from_number": "+15551234567",
"to_number": "+18005550100",
"agent_id": 12,
"context": "Matthew asked: get the outage ETA for account 4471. Wait on hold if needed.",
"idempotency_key": "slack-D012AB3CD-1731000000.000100"
}'บันทึก call_id ที่ส่งกลับไว้กับเธรด Slack (channel บวกกับ
ts ของข้อความ) แล้วตอบกลับในเธรด ("กำลังโทร…") สร้าง
idempotency_key จากช่องและ ts ของข้อความ (ts จะไม่ซ้ำกัน
เฉพาะภายในช่องของตน) เพื่อให้เหตุการณ์ Slack ที่ส่งซ้ำไม่ทำให้เกิดการโทรครั้งที่สอง หากคำขอระบุชื่อบุคคลแทนหมายเลข
บอตของคุณจะค้นหาหมายเลขก่อน ThunderPhone โทรออกเฉพาะไปยัง to_number ที่คุณส่งมา
2. ติดตามการโทรในเธรด
webhook telephony.turn แต่ละรายการมี call_id ผู้พูด (role:
assistant สำหรับเอเจนต์ และ user สำหรับอีกฝ่าย) text และ
position ของเทิร์น ค้นหาเธรดด้วย call_id แล้ว
โพสต์บรรทัดนั้น
- ตรวจสอบ webhook ทุกรายการ ก่อนดำเนินการ ดู ตรวจสอบลายเซ็น webhook
- กำจัดรายการซ้ำด้วย
event_idของ envelope และเรียงลำดับตามpositionการส่งมีอย่างน้อยหนึ่งครั้ง และเทิร์นอาจมาถึงไม่เรียงลำดับ - รวมบรรทัดเป็นชุด หากการโทรที่มีการใช้งานมากอาจทำให้เธรดมีข้อความล้น การโพสต์ทุกไม่กี่ วินาทีอ่านได้ดีกว่าหนึ่งข้อความต่อหนึ่งบรรทัด
เมื่อ telephony.complete มาถึง ให้โพสต์วิธีที่การโทรสิ้นสุด (ค่า status
และ end_reason) summary และข้อมูลที่ดึงออกมา แล้วปิด
เธรด ดูฟิลด์ได้ที่ การโทรเสร็จสิ้น
3. กำกับการโทรจากเธรด
เมื่อมีผู้ตอบกลับในเธรดของการโทรที่ยังดำเนินอยู่ ให้ส่งคำตอบเป็นข้อความกระซิบ เว้นแต่เอเจนต์กำลังรอคำตอบของคำถามอยู่ (ขั้นตอนที่ 4) ซึ่งในกรณีนั้นคำตอบ คือคำตอบสำหรับคำถาม:
curl -X POST https://api.thunderphone.com/v1/calls/987654321/whisper \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"text": "Ask whether they can waive the late fee."}'เอเจนต์จะได้ยินเป็นการส่วนตัวและนำไปใช้ในเทิร์นถัดไป อีกฝ่าย
จะไม่ได้ยินข้อความกระซิบเอง ข้อความกระซิบมีความยาว 1 ถึง 1000 อักขระ ค่า
409 หมายความว่าการโทรไม่ได้ดำเนินอยู่แล้ว: แจ้งเธรดว่าการโทรสิ้นสุดแล้ว
4. ให้เอเจนต์ถามคุณ
มอบเครื่องมือให้เอเจนต์ เช่น ask_owner ที่มีพารามิเตอร์ question
หนึ่งตัว ซึ่งเรียกใช้เซิร์ฟเวอร์ของคุณ สร้างเป็น
การเชื่อมต่อ API และเชื่อมโยงกับเอเจนต์
คำขอเครื่องมือทุกรายการจะส่งข้อมูลการโทรในส่วนหัว X-ThunderPhone-Call-ID
มีสามวิธีในการส่งคำตอบกลับ
พักสาย (สูงสุด 10 นาที) ตั้งค่าเครื่องมือเป็นโหมดพักสาย: spec.wait_mode
"hold" และ spec.timeout สูงสุด 600 วินาที (หากไม่กำหนดระยะหมดเวลา การพักสายจะ
นาน 20 วินาที) ผ่าน
API (ตัวแก้ไขในแดชบอร์ดยังไม่มีทั้งสองฟิลด์)
ปลายทางของคุณโพสต์คำถามไปยังเธรดของการโทร และตอบกลับทันทีด้วยผลลัพธ์ที่รอดำเนินการ:
{"status": "pending", "request_id": "q-C012AB3CD-1731000042.000300"}อีกฝ่ายจะได้ยินเอเจนต์พูดหนึ่งประโยค จากนั้นจึงเป็นเพลงพักสาย สำหรับ
เมนูโทรศัพท์หรือวอยซ์เมล เอเจนต์จะใช้การอัปเดตแบบพูดแทน และ
เอเจนต์แบบฟูลดูเพล็กซ์จะไม่พักสาย แต่จะได้รับการตอบกลับที่รอดำเนินการเป็นผลลัพธ์ เมื่อ
คำตอบมาถึงในเธรด ให้ส่งด้วย
POST /v1/calls/{call_id}/tool-results:
curl -X POST https://api.thunderphone.com/v1/calls/987654321/tool-results \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"request_id": "q-C012AB3CD-1731000042.000300", "result": {"answer": "Yes, book Tuesday at 10."}}'เพลงจะค่อย ๆ เบาลงและเอเจนต์จะดำเนินการต่อด้วยคำตอบของคุณ หากไม่มีผู้ใด
ตอบก่อน timeout เอเจนต์จะได้รับแจ้งว่าไม่มีคำตอบ และเสนอ
ขั้นตอนถัดไปให้อีกฝ่าย ขณะที่คำถามของการโทรกำลังรอดำเนินการ
การตอบกลับถัดไปในเธรดจะตอบคำถามนั้น ให้ส่งเป็นผลลัพธ์ของเครื่องมือ และ
อย่าส่งเป็นข้อความกระซิบด้วย (ข้อความกระซิบจะไปถึงเอเจนต์หลังจาก
เครื่องมือส่งคืนผลลัพธ์เท่านั้น) ดู
การรอนาน
รอในคำขอ (สูงสุด 3 นาที) ปลายทางของคุณโพสต์คำถาม
รอคำตอบแล้วส่งคืน เช่น {"answer": "Yes, book Tuesday at 10."}
ตั้งค่า spec.timeout ของเครื่องมือผ่าน API ได้สูงสุด 180 วินาที (ค่า
เริ่มต้นคือ 20) กำหนดเส้นตายของปลายทางให้สั้นกว่าเล็กน้อย
(เช่น 170 วินาที) เพื่อให้เมื่อไม่มีผู้ใดตอบ ปลายทางยังคงส่งคืน
สิ่งที่เอเจนต์ดำเนินการต่อได้ เช่น
{"answer": null, "note": "No reply yet. Offer to take a message."} เครื่องมือ
ที่ถึง timeout จะไปถึงเอเจนต์ในรูปแบบข้อผิดพลาด และโฮสต์ของคุณต้อง
เปิดคำขอค้างไว้นานเท่านั้น ระหว่างที่รอ เอเจนต์จะบอกอีกฝ่ายว่ากำลังตรวจสอบ
แจ้งว่ายังคงดำเนินการอยู่หลังผ่านไปราว 12 วินาที และ
จากนั้นจะอัปเดตสั้น ๆ ทุกประมาณ 15 วินาที โหมดพักสายใช้ได้ที่นี่
เช่นกัน: ตั้งค่า spec.wait_mode เป็น "hold" แล้วอีกฝ่ายจะได้ยินเพลง
แทนการอัปเดต
ตอบด้วยข้อความกระซิบ ปลายทางของคุณโพสต์คำถามและส่งคืนทันที
เช่น {"status": "asked", "note": "Matthew has been asked; his answer will come as guidance."}
เมื่อคำตอบมาถึง ให้ส่งเป็นข้อความกระซิบ (ขั้นตอนที่ 3) และเอเจนต์
จะตอบกลับทันที ใช้สำหรับคำตอบที่อาจใช้เวลานานกว่า
10 นาที การโทรจะไม่ถูกพักสาย: พรอมป์ต์ของคุณควรบอก
เอเจนต์ว่าต้องทำอะไรระหว่างนั้น เช่น พูดคุยเป็นเพื่อนกับอีกฝ่าย หรือเสนอ
โทรกลับหา
ในทุกกรณี ให้ระบุในพรอมป์ต์ของเอเจนต์ว่าควรใช้เครื่องมือเมื่อใด และ ควรบอกอะไรแก่อีกฝ่ายระหว่างที่รอ:
When you need Matthew's decision, use ask_owner with a short question.
Tell the person you're checking with Matthew and it may take a minute.
If there's no answer, offer to take a message or have Matthew call back.ข้อจำกัดที่ต้องวางแผนรองรับ
- ปลายทางของคุณต้องตอบกลับภายใน
timeoutของเครื่องมือ โดยไม่เกิน 180 วินาที เครื่องมือในโหมดพักสายสามารถ พักสายไว้ได้นานสูงสุด 600 วินาที พร้อมผลลัพธ์ที่รอดำเนินการ - ระหว่างที่เครื่องมือรอ เอเจนต์จะไม่ตอบอีกฝ่าย ในโหมดพักสาย อีกฝ่ายจะได้ยินเสียงเพลง มิฉะนั้นจะได้ยินการแจ้งสถานะด้วยเสียงแบบสั้น
- Whisper มีความยาวได้สูงสุด 1000 อักขระ
- การส่ง
telephony.turnมีอย่างน้อยหนึ่งครั้งและอาจมาไม่เรียงลำดับ
รายการตรวจสอบความปลอดภัย
- เก็บคีย์ API ไว้บนเซิร์ฟเวอร์ของคุณ
- ตรวจสอบลายเซ็นของ ThunderPhone บนเว็บฮุคและคำขอเครื่องมือ และ
ตรวจสอบ signing secret ของ Slack บนคำขอจาก Slack ลายเซ็น ThunderPhone ทั้งสองแบบ
ใช้ secret คนละรายการ: การส่งเว็บฮุคใช้ secret ของปลายทางเว็บฮุคนั้นเอง และคำขอเครื่องมือใช้ secret เว็บฮุค
ขององค์กรคุณจาก
GET /v1/webhook - กำหนดว่าใครสามารถเริ่มการโทรได้: ตรวจสอบ ID ผู้ใช้ Slack ก่อนโทรออก
- การโทรออกเป็นไปตามกฎเดียวกับการโทรประเภทอื่น ดู กฎหมายเกี่ยวกับการโทรออก
สร้างด้วย AI เอเจนต์เขียนโค้ด
ให้ AI เอเจนต์เขียนโค้ดของคุณใช้ เซิร์ฟเวอร์ MCP สำหรับเอกสาร และ หน้านี้ แล้วขอให้สร้าง "Slack bot สำหรับเอเจนต์ ThunderPhone ของฉันที่ทำตาม คู่มือนี้" Zeus ผู้ช่วยในแอป ThunderPhone สามารถตั้งค่าฝั่งของ เอเจนต์ได้ (ปลายทางเว็บฮุค เครื่องมือ และบรรทัดพรอมป์ต์) และเขียน โค้ดเริ่มต้นสำหรับบอตในแชตได้