---
title: "ดำเนินการโทรจาก Slack หรือแอปแชต"
description: "สร้างบอต Slack, Teams หรือเว็บแชตของคุณเองที่เริ่มการโทร ติดตามการโทรแบบสด กำกับเอเจนต์ และตอบคำถามของเอเจนต์ โดยใช้ API สาธารณะ"
---

คุณสามารถควบคุมเอเจนต์จากแอปแชตที่ทีมของคุณใช้อยู่แล้วได้ ข้อความหนึ่งข้อความ
จะเริ่มการโทร การโทรดำเนินไปแบบสดในเธรด การตอบกลับในเธรด
จะกำหนดทิศทางให้เอเจนต์ เมื่อเอเจนต์ต้องการการตัดสินใจ เอเจนต์จะถามคุณที่นั่นและ
รอคำตอบของคุณ

ThunderPhone ไม่ได้โฮสต์บอตนี้ให้คุณ คุณ (หรือ AI เอเจนต์สำหรับเขียนโค้ดของคุณ) สร้าง
เซิร์ฟเวอร์ขนาดเล็กที่เชื่อมต่อแอปแชตของคุณกับ API สาธารณะ หน้านี้แสดง
องค์ประกอบต่างๆ ซึ่งเหมือนกันสำหรับ Slack, Microsoft Teams, Discord หรือหน้าเว็บแชตส่วนตัว
โดยตัวอย่างใช้ Slack

## การทำงานร่วมกัน

| สิ่งที่คุณทำในแชต | สิ่งที่บอตของคุณเรียกใช้ | สิ่งที่เกิดขึ้น |
|---|---|---|
| ส่ง "โทรหา Comcast และขอ ETA ของเหตุขัดข้อง" | [`POST /v1/call`](/api-reference/outbound-calls) พร้อมข้อความเป็น `context` | เอเจนต์โทรออก บอตของคุณเปิดเธรดสำหรับการโทร |
| ดูเธรด | รับเว็บฮุก [`telephony.turn`](/th/webhooks/events) | แต่ละบรรทัดที่เอเจนต์หรืออีกฝ่ายพูดจะแสดงในเธรด |
| ตอบกลับในเธรดระหว่างการโทร | [`POST /v1/calls/{call_id}/whisper`](/api-reference/calls#whisper-to-the-agent) | เอเจนต์ได้รับข้อความของคุณแบบส่วนตัวและดำเนินการตามนั้น อีกฝ่ายจะไม่ได้ยินข้อความนี้ |
| ตอบคำถามของเอเจนต์ | [ปลายทางเครื่องมือ](/th/guides/build-tool-integration) ของคุณส่งคืนคำตอบ หรือส่งคำตอบในภายหลังด้วย [`POST /v1/calls/{call_id}/tool-results`](/api-reference/calls#deliver-a-tool-result) | เอเจนต์ดำเนินการโทรต่อโดยใช้คำตอบนั้น ในโหมดพักสาย อีกฝ่ายจะได้ยินเพลงรอสายระหว่างนั้น |
| อ่านผลลัพธ์ | รับ [`telephony.complete`](/th/webhooks/events) | บอตของคุณโพสต์สรุปและผลลัพธ์ |

บอตของคุณเก็บการแมปหนึ่งรายการ: เธรดแชตใดเป็นของ `call_id` ใด

## ก่อนเริ่มต้น

- **คีย์ API** เก็บไว้บนเซิร์ฟเวอร์ของคุณและห้ามเก็บในเบราว์เซอร์หรือแชต
  สร้างคีย์ได้ที่ **การตั้งค่าองค์กร → คีย์** (ดู
  [คีย์](/th/guides/organization-settings))
- **หมายเลขที่เปิดใช้การโทรออกและเอเจนต์** สำหรับการโทร ข้อความ
  จะกลายเป็น `context` สำหรับแต่ละการโทร ดังนั้นเอเจนต์ทั่วไปหนึ่งตัวจึงจัดการทุกงานได้
- **เซิร์ฟเวอร์** ที่รับเว็บฮุกได้ เช่น Railway, Fly.io, Render หรือ
  โฮสต์ของคุณเอง
- **ปลายทางเว็บฮุก** ที่ชี้ไปยังเซิร์ฟเวอร์นั้นและสมัครรับ
  `telephony.turn` และ `telephony.complete` เหตุการณ์ turn จะส่งไปยัง
  ปลายทางที่ระบุเหตุการณ์เหล่านี้เท่านั้น ดู [เว็บฮุก](/th/webhooks/endpoints)
  เหตุการณ์ turn ต้องเปิดการบันทึกการโทรของเอเจนต์ และ
  `summary` หลังจบการโทรต้องเปิดการตั้งค่า **สร้างสรุปการโทร** ของเอเจนต์ มิฉะนั้น
  ฟิลด์เหล่านั้นจะยังคงว่าง
- **แอปแชตของคุณเอง** สำหรับ Slack ให้สร้างแอปในเวิร์กสเปซของคุณที่
  [api.slack.com/apps](https://api.slack.com/apps)

<Tip>
  ใช้แอป Slack ที่คุณสร้างสำหรับเวิร์กสเปซของตัวเอง และรับข้อความ
  ผ่าน Events API ของ Slack แทนการอ่านประวัติช่อง Slack
  จำกัดการอ่านอย่างเข้มงวดสำหรับแอปที่แจกจ่ายไปยังเวิร์กสเปซอื่นนอก
  Marketplace ของตน แอปที่คุณสร้างสำหรับเวิร์กสเปซของตัวเองจะไม่อยู่ภายใต้
  ข้อจำกัดเหล่านั้น และเหตุการณ์จะส่งถึงคุณทันทีที่เกิดขึ้นโดยไม่ต้องอ่านข้อมูล ขอบเขต
  ของบอตที่ใช้ทั่วไป ได้แก่ `chat:write`, `app_mentions:read`, `im:history` (ข้อความ
  โดยตรง), `channels:history` และ `groups:history` (การตอบกลับในเธรดภายใน
  ช่องสาธารณะและส่วนตัวที่บอตอยู่) สมัครรับเหตุการณ์บอต
  `app_mention`, `message.im`, `message.channels` และ `message.groups` และ
  เปิดแท็บข้อความใต้หน้าหลักของแอปเพื่อให้ผู้คนส่ง DM ถึงบอตได้
</Tip>

## 1. เริ่มการโทรจากข้อความ

เมื่อบอตของคุณได้รับข้อความ (ข้อความโดยตรงหรือการ @mention)
ให้ตอบรับคำขอของ Slack ทันที (Slack จะลองส่งซ้ำหากไม่ได้รับการตอบรับภายใน 3 วินาที) และดำเนินการส่วนที่เหลือในเบื้องหลัง ตรวจสอบว่า
ผู้ส่งได้รับอนุญาตให้โทรหรือไม่ จากนั้นเริ่มการโทรโดยใช้ข้อความเป็น `context`:

```bash
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](/th/guides/verify-webhook-signatures)
- **กำจัดรายการซ้ำด้วย `event_id` ของ envelope และเรียงลำดับตาม `position`**
  การส่งมีอย่างน้อยหนึ่งครั้ง และเทิร์นอาจมาถึงไม่เรียงลำดับ
- **รวมบรรทัดเป็นชุด** หากการโทรที่มีการใช้งานมากอาจทำให้เธรดมีข้อความล้น การโพสต์ทุกไม่กี่
  วินาทีอ่านได้ดีกว่าหนึ่งข้อความต่อหนึ่งบรรทัด

เมื่อ `telephony.complete` มาถึง ให้โพสต์วิธีที่การโทรสิ้นสุด (ค่า `status`
และ `end_reason`) `summary` และข้อมูลที่ดึงออกมา แล้วปิด
เธรด ดูฟิลด์ได้ที่ [การโทรเสร็จสิ้น](/th/webhooks/call-complete)

## 3. กำกับการโทรจากเธรด

เมื่อมีผู้ตอบกลับในเธรดของการโทรที่ยังดำเนินอยู่ ให้ส่งคำตอบเป็นข้อความกระซิบ
เว้นแต่เอเจนต์กำลังรอคำตอบของคำถามอยู่ (ขั้นตอนที่ 4) ซึ่งในกรณีนั้นคำตอบ
คือคำตอบสำหรับคำถาม:

```bash
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](/th/guides/build-tool-integration) และเชื่อมโยงกับเอเจนต์
คำขอเครื่องมือทุกรายการจะส่งข้อมูลการโทรในส่วนหัว `X-ThunderPhone-Call-ID`

มีสามวิธีในการส่งคำตอบกลับ

**พักสาย (สูงสุด 10 นาที)** ตั้งค่าเครื่องมือเป็นโหมดพักสาย: `spec.wait_mode`
`"hold"` และ `spec.timeout` สูงสุด 600 วินาที (หากไม่กำหนดระยะหมดเวลา การพักสายจะ
นาน 20 วินาที) ผ่าน
[API](/api-reference/integrations#timeout-and-wait-mode) (ตัวแก้ไขในแดชบอร์ดยังไม่มีทั้งสองฟิลด์)
ปลายทางของคุณโพสต์คำถามไปยังเธรดของการโทร และตอบกลับทันทีด้วยผลลัพธ์ที่รอดำเนินการ:

```json
{"status": "pending", "request_id": "q-C012AB3CD-1731000042.000300"}
```

อีกฝ่ายจะได้ยินเอเจนต์พูดหนึ่งประโยค จากนั้นจึงเป็นเพลงพักสาย สำหรับ
เมนูโทรศัพท์หรือวอยซ์เมล เอเจนต์จะใช้การอัปเดตแบบพูดแทน และ
เอเจนต์แบบฟูลดูเพล็กซ์จะไม่พักสาย แต่จะได้รับการตอบกลับที่รอดำเนินการเป็นผลลัพธ์ เมื่อ
คำตอบมาถึงในเธรด ให้ส่งด้วย
[`POST /v1/calls/{call_id}/tool-results`](/api-reference/calls#deliver-a-tool-result):

```bash
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` เอเจนต์จะได้รับแจ้งว่าไม่มีคำตอบ และเสนอ
ขั้นตอนถัดไปให้อีกฝ่าย ขณะที่คำถามของการโทรกำลังรอดำเนินการ
การตอบกลับถัดไปในเธรดจะตอบคำถามนั้น ให้ส่งเป็นผลลัพธ์ของเครื่องมือ และ
อย่าส่งเป็นข้อความกระซิบด้วย (ข้อความกระซิบจะไปถึงเอเจนต์หลังจาก
เครื่องมือส่งคืนผลลัพธ์เท่านั้น) ดู
[การรอนาน](/th/tools/overview)

**รอในคำขอ (สูงสุด 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 นาที การโทรจะไม่ถูกพักสาย: พรอมป์ต์ของคุณควรบอก
เอเจนต์ว่าต้องทำอะไรระหว่างนั้น เช่น พูดคุยเป็นเพื่อนกับอีกฝ่าย หรือเสนอ
โทรกลับหา

ในทุกกรณี ให้ระบุในพรอมป์ต์ของเอเจนต์ว่าควรใช้เครื่องมือเมื่อใด และ
ควรบอกอะไรแก่อีกฝ่ายระหว่างที่รอ:

```text
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`](/api-reference/organizations#legacy-single-url-webhook)
- กำหนดว่าใครสามารถเริ่มการโทรได้: ตรวจสอบ ID ผู้ใช้ Slack ก่อนโทรออก
- การโทรออกเป็นไปตามกฎเดียวกับการโทรประเภทอื่น ดู
  [กฎหมายเกี่ยวกับการโทรออก](/th/guides/outbound-calling-laws)

## สร้างด้วย AI เอเจนต์เขียนโค้ด

ให้ AI เอเจนต์เขียนโค้ดของคุณใช้ [เซิร์ฟเวอร์ MCP สำหรับเอกสาร](/th/guides/docs-mcp) และ
หน้านี้ แล้วขอให้สร้าง "Slack bot สำหรับเอเจนต์ ThunderPhone ของฉันที่ทำตาม
คู่มือนี้" Zeus ผู้ช่วยในแอป ThunderPhone สามารถตั้งค่าฝั่งของ
เอเจนต์ได้ (ปลายทางเว็บฮุค เครื่องมือ และบรรทัดพรอมป์ต์) และเขียน
โค้ดเริ่มต้นสำหรับบอตในแชตได้
