Open in
จัดการสายเรียกเข้า (API)
ครบวงจร: กำหนดค่าเอเจนต์ กำหนดเอเจนต์ให้กับหมายเลขโทรศัพท์ รับสาย และตรวจสอบบันทึกการสนทนา
ขั้นตอนมาตรฐานสำหรับ “รับสายด้วย AI” จากเทอร์มินัลของคุณ คุณจะดำเนินการดังนี้:
- สร้างเอเจนต์พร้อมพรอมป์ต์และเสียง
- จัดเตรียม (หรือนำเข้า) หมายเลขโทรศัพท์ และกำหนดเอเจนต์เป็น ตัวจัดการสายเรียกเข้า
- โทรไปยังหมายเลข ดูบันทึกการโทร ทรานสคริปต์ และไฟล์บันทึกเสียง
จำนวนการเรียก API ทั้งหมด: สี่ครั้ง เวลารวม: น้อยกว่าห้านาที
1. สร้างเอเจนต์
เอเจนต์จะรวมพรอมต์ เสียง และระดับผลิตภัณฑ์ที่จะขับเคลื่อน
การโทร คุณยังตั้งค่าขีดจำกัดการโทร เช่น max_call_duration_seconds
และ ring_duration_seconds บนเอเจนต์ได้ สำหรับการโทรออก คุณยังตั้งค่า
max_hold_seconds เพื่อจำกัดระยะเวลาที่เอเจนต์รอสายพักก่อนวางสายได้
เอเจนต์ Bolt ยังรองรับ audio_tier, endpointing และ intelligence
เพื่อควบคุมวิธีฟังและตอบกลับ: intelligence เป็น core หรือ pro
และ audio_tier (การรับฟัง) เป็น lite, standard, plus หรือ max (Max ยังไม่
พร้อมให้ใช้งานทั่วไป) ค่าย้อนหลัง (lite และ standard สำหรับ
intelligence; lean, hearing และ deep_hearing สำหรับการรับฟัง) ยัง
ใช้งานได้ เอเจนต์ฟูลดูเพล็กซ์จะใช้เสียงเดียวกันในทุกภาษาที่รองรับ
ดังนั้นการสลับเสียงตามภาษาจึงใช้ไม่ได้กับการโทรเหล่านั้น เอเจนต์ยัง
รองรับ intro_clip และ intro_ring_count เพื่อเล่นเสียงเกริ่นที่บันทึกไว้ล่วงหน้าและ
เสียงเรียกเข้าสูงสุดสองครั้งก่อนเอเจนต์พูด เอเจนต์ใหม่ยังต้องมีเขตเวลา หาก
เอเจนต์ของคุณรองรับหลายภาษา คุณสามารถตั้งค่า language_switching เพื่อควบคุม
ว่าจะให้เอเจนต์ถามก่อนสลับภาษาหรือใช้ภาษาของผู้โทร
คุณยังตั้งค่า words บนเอเจนต์เพื่อควบคุมวิธีออกเสียงคำเฉพาะ
และคำที่เอเจนต์รับฟังได้
ดูเอเจนต์สำหรับฟิลด์การกำหนดค่าทั้งหมด โดยค่าขั้นต่ำคือ:
curl -X POST https://api.thunderphone.com/v1/agents \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Acme Support",
"prompt": "You are a friendly support agent for Acme. Help callers with orders and returns. Keep answers short.",
"voice": "john",
"product": "bolt"
}'บันทึก id ที่ส่งกลับ — คุณจะต้องใช้ในขั้นตอนที่ 2
2. รับหมายเลขโทรศัพท์
หากคุณเพียงต้องการหมายเลขสำหรับโทรทดสอบ ให้รับหมายเลข ThunderPhone จากพูลของ ThunderPhone:
curl -X POST https://api.thunderphone.com/v1/phone-numbers \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"area_code": "415"}'การตอบกลับมี id และ number ในรูปแบบ E.164 หมายเลข ThunderPhone
เริ่มต้นด้วย status="provisioning" และจะเปลี่ยนเป็น active ภายในไม่กี่
วินาที — โพล
GET /v1/phone-numbers/{id}
เพื่อติดตามการเปลี่ยนสถานะหากคุณต้องการ
3. กำหนดเอเจนต์
เชื่อมโยงเอเจนต์จากขั้นตอนที่ 1 กับทิศทางสายเรียกเข้าของหมายเลข:
curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/{phone_id} \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"inbound_agent_id": 12}'เพียงเท่านี้ — หมายเลขพร้อมใช้งานแล้ว หลังจากองค์กรของคุณได้รับอนุมัติให้
โทรออก คุณยังสามารถตั้งค่า outbound_agent_id ใน PATCH เดียวกันได้ จนกว่าจะถึงตอนนั้น
API จะปฏิเสธการกำหนดนี้ด้วย 400
หากคุณกำหนดเส้นทางสายเรียกเข้า ผ่าน config webhook แทน inbound_agent_id แบบคงที่ webhook นั้นสามารถส่งคืน timezone สำหรับแต่ละสาย พร้อมกับ agent_id และ variables ได้แล้ว สำหรับเอเจนต์ Bolt คุณยังสามารถตั้งค่า audio_tier endpointing และ intelligence บนเอเจนต์ในการเขียนผ่าน API ได้ API ยังคงยอมรับชื่อเดิม eagerness เป็นชื่อแทนของ endpointing หากเอเจนต์ของคุณใช้การเชื่อมต่อ API ที่มี trigger="call_start" ThunderPhone สามารถเรียกใช้เครื่องมือเหล่านั้นหนึ่งครั้งเมื่อเริ่มต้นการโทรแต่ละครั้ง ก่อนคำทักทาย โดยใช้ call_start_arguments ที่บันทึกไว้
การโทรกลับมายังการโทรออกของคุณ
เมื่อมีผู้โทรกลับมายังหมายเลขที่เคยโทรหาพวกเขาภายใน 30 วันที่ผ่านมา เอเจนต์ที่รับสายจะได้รับบันทึกข้อมูลพื้นหลังสั้นๆ เกี่ยวกับสายนั้น ได้แก่ เวลาที่โทร เอเจนต์ที่โทร และสิ่งที่เกิดขึ้น (ไม่มีผู้รับสาย ข้อความเสียง หรือการสนทนา) หมายเลขที่ไม่มีเอเจนต์รับสายเข้า จะส่งรายละเอียดเดียวกันไปยังเว็บฮุกการกำหนดค่าของคุณในชื่อ returning_call หากหมายเลขนั้นไม่มีเว็บฮุก หรือเว็บฮุกหมดเวลาหรือไม่สามารถเข้าถึงได้ สายจะถูกส่งไปยังเอเจนต์ที่โทรก่อนหน้านี้แทนที่จะสิ้นสุดสาย รหัสผู้โทรสามารถปลอมแปลงได้ ดังนั้นระบบจะแชร์สรุปและตัวแปรของสายก่อนหน้านี้ก็ต่อเมื่อผู้ดูแลระบบเปิดใช้ แชร์รายละเอียดของสายก่อนหน้า ใน องค์กร → ทั่วไป → การโทรกลับ ดู การโทรกลับ
4. รับสาย
โทรไปยังหมายเลขจากโทรศัพท์ของคุณ เอเจนต์จะรับสาย แนะนำตัวตาม พรอมป์ต์ของคุณ และเริ่มการสนทนา
ระหว่างที่สายกำลังดำเนินอยู่ สายจะแสดงใน
GET /v1/calls พร้อม
status="in_progress" เมื่อสายสิ้นสุด ระเบียนจะอัปเดตด้วย
end_reason, duration_seconds, billable_minutes และ (ในภายหลัง)
URL ของไฟล์บันทึกเสียงและคะแนนประเมินจาก AI
สายเรียกเข้าจะนับรวมใน
ขีดจำกัดการโทรพร้อมกันขององค์กร (ค่าเริ่มต้นคือสายที่กำลังดำเนินอยู่ 20 สาย โดยใช้ร่วมกับสายโทรออก สายเว็บ และสายทดสอบ) สายที่เข้ามาเมื่อถึงขีดจำกัดจะถูกปฏิเสธก่อนที่เอเจนต์จะรับสายและถูกวางสาย จะไม่ถูกเรียกเก็บเงิน และจะบันทึกเป็นสายที่ล้มเหลวโดยมีเหตุผลการสิ้นสุดเป็น concurrent_call_limit_reached ส่งอีเมลถึง support@thunderphone.com หากต้องการขีดจำกัดที่สูงขึ้น
5. ตรวจสอบผลลัพธ์
ดึงรายการสายล่าสุด:
curl 'https://api.thunderphone.com/v1/calls?limit=5' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"ดึงบทสนทนา:
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"และ URL ของไฟล์บันทึกเสียง (ลงนามและมีอายุสั้น):
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"หากคุณสมัครรับ
เว็บฮุก telephony.complete
คุณจะได้รับข้อมูลเดียวกันในรูปแบบ POST ไปยังเซิร์ฟเวอร์ของคุณ — ดู
call.complete
หากเอเจนต์ของคุณกำหนดค่าฟิลด์การดึงข้อมูลไว้ เพย์โหลดการโทรที่เสร็จสิ้นแล้วอาจมีข้อมูลที่ดึงออกมาแบบมีโครงสร้างด้วย สรุปการโทรจะเขียนด้วยภาษาที่องค์กรของคุณใช้ใน ThunderPhone เว้นแต่เอเจนต์จะกำหนดแทนที่การตั้งค่านั้น
ขั้นตอนถัดไป
เลือกเอเจนต์ที่แตกต่างกันสำหรับผู้โทรแต่ละรายตามหมายเลขโทรศัพท์ หรือตรรกะแบบกำหนดเองในเว็บฮุก
ให้เอเจนต์เรียกใช้ API ของคุณระหว่างการสนทนา
ส่งต่อผู้โทรโดยตรง หรือตรวจสอบปลายทางก่อนเชื่อมต่อ
สตรีมสายที่เสร็จสิ้นแต่ละสายไปยัง CRM / ไปป์ไลน์การวิเคราะห์ของคุณ
ให้คะแนนทุกสายโดยอัตโนมัติ และส่งสายที่ถูกตั้งค่าสถานะไปตรวจสอบ