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

Developer cookbook

จัดการสายเรียกเข้า (API)

ครบวงจร: กำหนดค่าเอเจนต์ กำหนดเอเจนต์ให้กับหมายเลขโทรศัพท์ รับสาย และตรวจสอบบันทึกการสนทนา

ขั้นตอนมาตรฐานสำหรับ “รับสายด้วย AI” จากเทอร์มินัลของคุณ คุณจะดำเนินการดังนี้:

  1. สร้างเอเจนต์พร้อมพรอมป์ต์และเสียง
  2. จัดเตรียม (หรือนำเข้า) หมายเลขโทรศัพท์ และกำหนดเอเจนต์เป็น ตัวจัดการสายเรียกเข้า
  3. โทรไปยังหมายเลข ดูบันทึกการโทร ทรานสคริปต์ และไฟล์บันทึกเสียง

จำนวนการเรียก 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 เว้นแต่เอเจนต์จะกำหนดแทนที่การตั้งค่านั้น


ขั้นตอนถัดไป