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

<Note>
  สร้างเอเจนต์แรกด้วยตนเองใช่หรือไม่ แดชบอร์ดจะแนะนำขั้นตอนนี้
  โดยตรง — สร้างเอเจนต์ เพิ่มหมายเลข จำลอง ตรวจสอบ — ผ่าน
  วิซาร์ดแบบมีคำแนะนำ เริ่มต้นที่
  [คู่มือเริ่มต้นใช้งานแดชบอร์ด](/th/quickstart-dashboard)
</Note>

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

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

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

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

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

```bash
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

<Tip>
  เลือก `spark` สำหรับคำถามและคำตอบทั่วไปด้วยต้นทุนต่ำที่สุด หรือ `bolt` เมื่อความเร็ว
  สำคัญที่สุด อัปเกรดเป็น `storm-base-with-ack` เมื่อพรอมป์ต์ของคุณ
  ต้องการการให้เหตุผลเชิงลึกมากขึ้น และยอมรับเสียงคั่นครึ่งวินาทีระหว่างที่
  โมเดลกำลังคิดได้ ดู
  [ระดับผลิตภัณฑ์](/api-reference/agents#product-tiers-at-a-glance)
</Tip>

## 2. รับหมายเลขโทรศัพท์

หากคุณเพียงต้องการหมายเลขสำหรับโทรทดสอบ รับหมายเลข ThunderPhone
จากกลุ่มหมายเลขของ ThunderPhone:

```bash
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}`](/api-reference/phone-numbers#retrieve-a-phone-number)
เพื่อติดตามการเปลี่ยนสถานะหากต้องการ

<Note>
  หมายเลข ThunderPhone ใช้สำหรับสายเรียกเข้าเท่านั้น สำหรับสายโทรออก
  [นำหมายเลขของคุณมาใช้ผ่าน VoIP](/th/guides/bring-your-own-numbers)
</Note>

## 3. กำหนดเอเจนต์

เชื่อมโยงเอเจนต์จากขั้นตอนที่ 1 กับทิศทางสายเรียกเข้าของหมายเลข:

```bash
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`](/api-reference/calls#list-calls) พร้อม
`status="in_progress"` เมื่อการโทรสิ้นสุด ระเบียนจะอัปเดตด้วย
`end_reason`, `duration_seconds`, `billable_minutes` และ (ในภายหลัง)
URL ไฟล์บันทึกเสียงและคะแนนประเมิน AI

## 5. ตรวจสอบผลลัพธ์

ดึงรายการสายล่าสุด:

```bash
curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

ดึงทรานสคริปต์:

```bash
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

และ URL ไฟล์บันทึกเสียง (อายุสั้นและมีลายเซ็น):

```bash
curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"
```

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

---

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

<CardGroup cols={2}>
  <Card title="การกำหนดค่าแบบไดนามิกสำหรับแต่ละสาย" icon="bolt" href="/th/guides/dynamic-call-config">
    เลือกเอเจนต์ที่แตกต่างกันสำหรับผู้โทรแต่ละรายตามหมายเลขโทรศัพท์
    หรือตรรกะแบบกำหนดเองใน webhook
  </Card>
  <Card title="เพิ่มการผสานรวมเครื่องมือ" icon="screwdriver-wrench" href="/th/guides/build-tool-integration">
    ให้เอเจนต์เรียกใช้ API ของคุณระหว่างการสนทนา
  </Card>
  <Card title="โอนสาย" icon="phone-arrow-right" href="/th/guides/call-transfers">
    กำหนดเส้นทางผู้โทรโดยตรง หรือคัดกรองปลายทางก่อนเชื่อมต่อสาย
  </Card>
  <Card title="รับ webhook ของ call.complete" icon="bolt" href="/th/webhooks/call-complete">
    สตรีมสายที่เสร็จสิ้นแต่ละสายไปยังไปป์ไลน์ CRM / การวิเคราะห์ของคุณ
  </Card>
  <Card title="การให้คะแนนด้วย AI และรายงานปัญหา" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    ให้คะแนนทุกสายโดยอัตโนมัติ และส่งสายที่ถูกแจ้งสถานะไปตรวจสอบ
  </Card>
</CardGroup>