---
title: "เชื่อมต่อจาก Twilio"
description: "ส่งสายจาก Twilio ไปยังเอเจนต์ ThunderPhone ผ่าน SIP โดยใช้ CallSid และรับสายกลับผ่าน referUrl ของคุณพร้อมการส่งต่อในที่อยู่สำหรับโอนสาย"
---

TwiML ของคุณโทรไปยังที่อยู่ SIP ของเอเจนต์ โดยส่ง `CallSid` ของสายไว้ในส่วนหัว
เมื่อผู้โทรต้องการคุยกับบุคคล เอเจนต์จะส่ง SIP `REFER` แล้ว Twilio จะส่งที่อยู่สำหรับ
โอนสายซึ่งมีข้อมูลการส่งต่ออยู่ภายในไปยังตัวจัดการ `referUrl` ของคุณ และ TwiML ที่ตัวจัดการ
ส่งกลับจะกำหนดว่าผู้โทรจะไปที่ใด เช่น คิว Flex

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

- เอเจนต์ ThunderPhone และ[คีย์ API](/th/guides/api-keys)ขององค์กร
- Twilio Programmable Voice และตำแหน่งสำหรับให้บริการ TwiML กับตัวจัดการ
  `referUrl`: เซิร์ฟเวอร์ของคุณเอง หรือ TwiML Bin และ Twilio Function ไม่จำเป็นต้องใช้ Flex

## 1. สร้างปลายทาง SIP

`<Sip>` ของ Twilio รับชื่อผู้ใช้และรหัสผ่าน ดังนั้นให้ใช้ปลายทางมาตรฐาน:

```bash
curl -X POST https://api.thunderphone.com/v1/sip-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"agent_id": 12, "name": "Twilio"}'
```

จัดเก็บ `password` จากการตอบกลับทันที เนื่องจากจะแสดงเพียงครั้งเดียว หากต้องการ
รับสายจาก Twilio เท่านั้นด้วย โปรดดู
[จำกัด IP ต้นทาง](/th/guides/sip-addresses)

## 2. ส่งสายพร้อมบริบท

ส่งกลับ TwiML นี้สำหรับสายที่คุณต้องการส่งต่อให้เอเจนต์:

```xml
<Response>
  <Dial answerOnBridge="true" referUrl="https://YOUR_SERVER/thunderphone-refer">
    <Sip username="tp409667538f83" password="YOUR_ENDPOINT_PASSWORD">sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls?X-Call-ID={{CallSid}}</Sip>
  </Dial>
</Response>
```

- `;transport=tls` สำคัญ: Twilio ใช้ UDP หากไม่ได้ระบุเป็นอย่างอื่น
- `X-Call-ID` ส่ง `CallSid` Twilio ไม่มีเอกสารเกี่ยวกับส่วนหัว call-id
  ของตัวเอง ดังนั้นให้เพิ่มส่วนหัวนี้: ThunderPhone จะจัดเก็บเป็น
  `external_call_id` ของสาย `{{CallSid}}` ใช้ได้ใน TwiML Bin; หากใช้เซิร์ฟเวอร์ของคุณเอง
  ให้เขียน `CallSid` ของคำขอขาเข้า
- เพิ่มบริบทเพิ่มเติมด้วยวิธีเดียวกัน เช่น `&amp;X-Account-Id=12345` ภายใน
  TwiML ให้เขียน `&` เป็น `&amp;` เนื่องจาก `&` เดี่ยวเป็น XML ที่ไม่ถูกต้อง แต่ละค่า
  จะไปถึงพรอมป์ต์ในรูปตัวแปร เช่น `{{sip_x_account_id}}` Twilio อนุญาตส่วนหัว `x-`
  และ `User-to-User` ที่เข้ารหัสแบบเปอร์เซ็นต์ โดย URI ทั้งหมดต้องมีความยาวไม่เกิน 255 อักขระ
  และส่วนหัวต้องมีความยาวไม่เกิน 1,024 อักขระ
- `referUrl` ช่วยให้ Twilio รับ `REFER` ของเอเจนต์ได้ หากไม่มี การโอนสายจะล้มเหลวพร้อม
  [ข้อผิดพลาด 13802](https://www.twilio.com/docs/api/errors/13802)
  `answerOnBridge="true"` จะคงการเชื่อมต่อของผู้โทรไว้จนกว่าปลายทางใหม่จะรับสาย
  ดังนั้นการโอนสายที่ล้มเหลวจึงสามารถใช้ทางเลือกสำรองได้

วิดเจ็ต **เชื่อมต่อสายไปยัง** ของ Studio ไม่มีเอกสารเกี่ยวกับส่วนหัวแบบกำหนดเองหรือ
`referUrl` ดังนั้นจาก Studio ให้ส่งสายไปยัง TwiML นี้ เช่น ด้วยวิดเจ็ต
**การเปลี่ยนเส้นทาง TwiML**

## 3. รับสายกลับ

เอเจนต์โอนสายด้วย `REFER` ซึ่งที่อยู่สำหรับโอนสายมีรหัสและเจตนาของการส่งต่อ เพิ่มหมายเลขโอนสายนี้ (ดู
[เพิ่มหมายเลขโอนสาย](/th/guides/contact-centers/overview)
และ [ส่วนหัวภายในที่อยู่สำหรับโอนสาย](/th/guides/call-transfers)):

```json
{
  "name": "Twilio support",
  "number": "sip:support@acme.sip.twilio.com",
  "headers": {"X-Handoff-Id": "{{handoff_id}}", "X-Handoff-Intent": "{{handoff_intent}}"},
  "headers_in_uri": true
}
```

Twilio ส่งที่อยู่ทั้งหมดไปยัง `referUrl` ของคุณในรูปแบบ `ReferTransferTarget` ตัวอย่างเช่น `<sip:support@acme.sip.twilio.com?X-Handoff-Id=Zr3mY0b1Q9xWw2kPq4s7Tg&X-Handoff-Intent=billing_dispute>`
ตัวจัดการของคุณอ่านส่วนหัวจากที่อยู่นั้นและส่งคืน TwiML ที่ระบุปลายทางถัดไปของผู้โทร ส่วนผู้ใช้ของที่อยู่ (`support`) คุณเลือกได้เอง ดังนั้นคุณจึงเพิ่มหมายเลขโอนสายหนึ่งหมายเลขต่อปลายทางและกำหนดเส้นทางตามค่านั้นได้

Twilio Function นี้นำผู้โทรเข้าคิวไปยัง Flex โดยใช้ข้อมูลการส่งต่อเป็นแอตทริบิวต์ของงาน และค้นหาสรุปด้วยรหัสการส่งต่อ การค้นหาทำงานใน Function เนื่องจากวิดเจ็ต HTTP Request ของ Studio ไม่สามารถส่งส่วนหัว `Authorization` ได้:

```js
exports.handler = async (context, event, callback) => {
  const target = (event.ReferTransferTarget || "").replace(/^<|>$/g, "");
  const params = new URLSearchParams(target.split("?")[1] || "");
  const handoffId = params.get("X-Handoff-Id") || "";
  const attributes = { handoff_id: handoffId, intent: params.get("X-Handoff-Intent") || "" };

  if (handoffId) {
    const response = await fetch(
      "https://api.thunderphone.com/v1/calls/handoff?handoff_id=" + encodeURIComponent(handoffId),
      { headers: { Authorization: "Bearer " + context.THUNDERPHONE_API_KEY } }
    );
    if (response.ok) {
      const call = await response.json();
      attributes.summary = (call.handoff && call.handoff.summary) || "";
    }
  }

  const twiml = new Twilio.twiml.VoiceResponse();
  twiml.enqueue({ workflowSid: context.FLEX_WORKFLOW_SID }).task({}, JSON.stringify(attributes));
  callback(null, twiml);
};
```

เก็บคีย์ API ไว้ในตัวแปรสภาพแวดล้อมของ Function ดู
[ค้นหาสายที่ส่งต่อแล้ว](/api-reference/calls#look-up-a-handed-off-call)
สำหรับฟิลด์อื่น

## ทดสอบ

โทรไปยังหมายเลข Twilio ที่ส่งคืน TwiML ข้างต้น ขอคุยกับบุคคลผ่านเอเจนต์ และตรวจสอบว่าตัวจัดการ `referUrl` ของคุณได้รับ `ReferTransferTarget` ที่มีส่วนหัวทั้งสองรายการ และผู้โทรเข้าสู่คิว จากนั้นเปิดสายด้วย
`GET /v1/calls/{call_id}`: `external_call_id` ควรเป็น `CallSid`

## ข้อจำกัด

- Twilio จำกัด `Refer-To` ไว้ที่ 256 อักขระ ThunderPhone จำกัดที่อยู่ไว้ที่ 254 อักขระและละเว้นส่วนหัวที่ใส่ไม่พอดี ดังนั้นควรใช้ชื่อและค่าของส่วนหัวให้สั้น
- Twilio ไม่มีเอกสารสำหรับการอ่านส่วนหัวใน `BYE` ดังนั้นสายขากลับจึงไม่สามารถส่งข้อมูลการส่งต่อกลับไปยัง Twilio ได้ ใช้ `REFER` ตามตัวอย่างข้างต้น
- Twilio ไม่รองรับ `REFER` สำหรับสายที่เชื่อมต่อผ่าน `<Conference>` หรือ `<Queue>` ดังนั้นให้โทรหาเอเจนต์ด้วย `<Dial><Sip>` ตามตัวอย่างข้างต้น
