---
title: "เชื่อมต่อจาก Amazon Connect"
description: "ส่งสายจาก Amazon Connect ไปยังเอเจนต์ ThunderPhone ผ่าน SIP พร้อมรหัสผู้ติดต่อและ UUI แล้วดำเนินโฟลว์ต่อด้วยการส่งต่อของเอเจนต์"
---

โฟลว์ Amazon Connect ของคุณจะส่งผู้โทรไปยังเอเจนต์พร้อมรหัสติดต่อและ
UUI ที่คุณกำหนดไว้ เมื่อเอเจนต์ดำเนินการเสร็จ จะวางสาย โฟลว์ของคุณจะทำงานต่อ และ
Lambda จะดึงข้อมูลการส่งต่อด้วยรหัสติดต่อ

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

- เอเจนต์ ThunderPhone และ[คีย์ API](/th/guides/api-keys)ขององค์กร
- ตัวเชื่อมต่อ **การโอนสายเสียงภายนอก** ของ Amazon Connect ขอเพิ่มโควตา
  "ตัวเชื่อมต่อการโอนสายเสียงภายนอกต่อบัญชี" ก่อน เมนูจะยังซ่อนอยู่จนกว่า AWS จะอนุมัติ AWS เรียกเก็บค่าบริการตัวเชื่อมต่อแต่ละรายการรายวัน
  ([$100 ต่อวันตั้งแต่วันที่ 21 กรกฎาคม 2025](https://aws.amazon.com/about-aws/whats-new/2025/07/amazon-connect-announces-per-day/))
  พร้อมค่าการใช้งานต่อนาที

<Warning>
  คู่มือผู้ดูแลระบบปัจจุบันของ AWS ไม่มีหน้าสำหรับการโอนสายเสียงภายนอกแล้ว
  ก่อนสร้างบนพื้นฐานนี้ ให้ยืนยันกับ AWS ว่าตัวเชื่อมต่อพร้อมใช้งานสำหรับ
  อินสแตนซ์และรีเจียนของคุณ
</Warning>

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

ตัวเชื่อมต่อไม่มีเอกสารเกี่ยวกับการยืนยันตัวตน SIP digest ดังนั้นให้สร้าง
ปลายทางที่รับสายตามที่อยู่ต้นทาง:

```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": "Amazon Connect",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["CONNECT_SIGNALLING_RANGE_1", "CONNECT_SIGNALLING_RANGE_2"]
  }'
```

รับช่วงสัญญาณ SIP ของตัวเชื่อมต่อสำหรับรีเจียนของคุณจาก AWS แต่ละช่วงต้องเป็น
ช่วง IPv4 สาธารณะขนาด `/16` หรือแคบกว่า (IPv6 ขนาด `/48` หรือแคบกว่า) ดู
[แพลตฟอร์มที่ยืนยันตัวตนด้วย IP ต้นทาง](/th/guides/sip-addresses)
สำหรับกฎและความเสี่ยงของที่อยู่ที่ใช้ร่วมกันโดยลูกค้าทุกรายของ
แพลตฟอร์ม เก็บค่า `sip_uri` จากการตอบกลับไว้ เช่น
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`

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

1. ในคอนโซล Amazon Connect ให้เปิด **ระบบเสียงภายนอก → การผสานรวมการโอนสายเสียง**
   แล้วเลือก **สร้าง**
2. เลือกประเภทปลายทาง (SBC) และเพิ่มเส้นทางขาออกโดยมีโฮสต์
   `sip.thunderphone.com` พอร์ต `5061` และโปรโตคอล TLS ปลายทางต้องใช้
   TLS หรือ TCP (พอร์ต `5060`) และปฏิเสธ UDP AWS ไม่มีเอกสารระบุว่า
   ตัวเชื่อมต่อรองรับโปรโตคอลใดบ้าง ดังนั้นให้ยืนยันกับ AWS ว่าสามารถใช้หนึ่งใน
   โปรโตคอลเหล่านั้นได้
3. ในโฟลว์ของคุณ ให้เพิ่มบล็อก **โอนไปยังหมายเลขโทรศัพท์** โดยตั้งค่า **โอนไปยัง**
   เป็น **ระบบเสียงภายนอก** แล้วกำหนด:
   - **ARN ปลายทาง:** ตัวเชื่อมต่อ
   - **ถึงผู้ใช้:** ส่วนผู้ใช้ของ `sip_uri` ของปลายทาง เช่น
     `agent-12-jhxmginwjx`
   - **UUI** (ไม่บังคับ): บริบทสำหรับเอเจนต์ Connect จะส่งในรูปแบบเข้ารหัส hex
   - **ดำเนินโฟลว์ต่อหลังตัดการเชื่อมต่อ:** ใช่ เพื่อให้โฟลว์ทำงานต่อเมื่อ
     เอเจนต์วางสาย

Connect ส่งรหัสติดต่อใน `X-Amzn-ConnectContactId` ThunderPhone จัดเก็บ
เป็น `external_call_id` ของสาย ซึ่งเป็นวิธีที่โฟลว์ของคุณใช้ค้นหาสายในภายหลัง
UUI จะส่งถึงพรอมต์เป็น `{{sip_uui}}` การผสานรวมของบุคคลที่สามมีเอกสารเกี่ยวกับ
ส่วนหัวรหัสติดต่อ แต่เอกสารของ AWS เองไม่มี ดังนั้นให้ตรวจสอบในการทดสอบสายครั้งแรกของคุณ

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

AWS ไม่มีเอกสารระบุวิธีให้ Connect อ่านส่วนหัวใน `BYE` หรือรับ
`REFER` จากเอเจนต์ ดังนั้นเอเจนต์จึงคืนสาย: กล่าวลาและวางสาย แล้วโฟลว์ของคุณจะทำงานต่อหลังบล็อกการโอนสาย เพิ่มหมายเลขโอนสายนี้ (ดู [เพิ่มหมายเลขโอนสาย](/th/guides/contact-centers/overview)):

```json
{"name": "Amazon Connect", "action": "return"}
```

จากนั้นดึงข้อมูลการส่งต่อด้วยบล็อก **เรียกใช้ฟังก์ชัน AWS Lambda** หลังการโอนสาย Lambda จะค้นหาสายด้วยรหัสผู้ติดต่อ:

```python
import json
import os
import urllib.error
import urllib.parse
import urllib.request


def lambda_handler(event, context):
    contact_id = event["Details"]["ContactData"]["ContactId"]
    url = "https://api.thunderphone.com/v1/calls/handoff?" + urllib.parse.urlencode(
        {"external_call_id": contact_id}
    )
    request = urllib.request.Request(
        url, headers={"Authorization": "Bearer " + os.environ["THUNDERPHONE_API_KEY"]}
    )
    try:
        with urllib.request.urlopen(request, timeout=5) as response:
            call = json.load(response)
    except (urllib.error.URLError, TimeoutError):
        return {"found": "false"}
    handoff = call.get("handoff") or {}
    return {
        "found": "true",
        "intent": handoff.get("intent") or "",
        "summary": handoff.get("summary") or "",
    }
```

บล็อกจะส่งคืนแมปแบบแบน ดังนั้นโฟลว์จึงสามารถแยกเส้นทางตาม `intent` หรือตั้งค่า
`summary` เป็นแอททริบิวต์ผู้ติดต่อสำหรับผู้ที่รับสายได้ เรียกใช้บล็อกแบบซิงโครนัส
(ไม่เกิน 8 วินาที) และจัดเก็บคีย์ API แบบเข้ารหัส เช่น ใน AWS Secrets Manager ฟิลด์การตอบกลับอยู่ใน
[ค้นหาสายที่ส่งต่อ](/api-reference/calls#look-up-a-handed-off-call)

## ทดสอบ

โทรไปยังหมายเลขในอินสแตนซ์ Connect ของคุณที่ไปถึงบล็อกการโอนสาย ขอให้
เอเจนต์โอนหาบุคคลหนึ่ง และตรวจสอบว่าโฟลว์ทำงานต่อ จากนั้นเปิดสายด้วย
`GET /v1/calls/{call_id}`: `sip_headers` ควรแสดง
`x-amzn-connectcontactid` และ `external_call_id` ควรเท่ากับ `ContactId`
ที่ Lambda ของคุณได้รับ หากการโอนสายล้มเหลวด้วย SIP `404` แสดงว่า ThunderPhone ไม่พบ
ส่วน user ของปลายทาง: ต้องมีอยู่ทั้งใน URI คำขอและส่วนหัว `To`

## ข้อจำกัด

- AWS ไม่มีเอกสารระบุวิธีอ่านส่วนหัวใน `BYE` รวมถึง
  `X-TP-Handoff-Id` ดังนั้นรหัสผู้ติดต่อจึงเป็นลิงก์เดียวกลับไปยังสาย
- AWS ไม่มีเอกสารระบุความยาว UUI สูงสุดสำหรับคอนเน็กเตอร์
- บล็อก Lambda แบบซิงโครนัสจะหมดเวลาหลัง 8 วินาที
