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

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

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

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

จำนวนการเรียก API ทั้งหมด: 4 ครั้ง เวลาทั้งหมด: ไม่เกินห้านาที

1. สร้างเอเจนต์#

เอเจนต์รวมพรอมป์ต์ เสียง และระดับผลิตภัณฑ์ที่จะใช้ขับเคลื่อน การโทร ดู เอเจนต์ สำหรับฟิลด์การกำหนดค่าทั้งหมด โดยค่าขั้นต่ำคือ:

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": "spark"
  }'

บันทึก 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 เดียวกัน เพื่อให้หมายเลขพร้อมโทรออกด้วย

4. รับสาย#

โทรไปยังหมายเลขจากโทรศัพท์ของคุณ เอเจนต์จะรับสาย แนะนำตัวตาม พรอมป์ต์ของคุณ และเริ่มการสนทนา

ระหว่างที่การโทรกำลังดำเนินอยู่ การโทรจะแสดงใน GET /v1/calls พร้อม status="in_progress" เมื่อการโทรสิ้นสุด ระเบียนจะอัปเดตด้วย end_reason, duration_seconds, billable_minutes และ (ในภายหลัง) URL ไฟล์บันทึกเสียงและคะแนนประเมิน AI

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"

หากคุณสมัครรับ webhook telephony.complete คุณจะได้รับข้อมูลเดียวกันในรูปแบบ POST ไปยังเซิร์ฟเวอร์ของคุณ — ดู call.complete

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