Open in
เชื่อมต่อจาก Twilio
ส่งสายจาก Twilio ไปยังเอเจนต์ ThunderPhone ผ่าน SIP โดยใช้ CallSid และรับสายกลับผ่าน referUrl ของคุณพร้อมการส่งต่อในที่อยู่สำหรับโอนสาย
TwiML ของคุณโทรไปยังที่อยู่ SIP ของเอเจนต์ โดยส่ง CallSid ของสายไว้ในส่วนหัว
เมื่อผู้โทรต้องการคุยกับบุคคล เอเจนต์จะส่ง SIP REFER แล้ว Twilio จะส่งที่อยู่สำหรับ
โอนสายซึ่งมีข้อมูลการส่งต่ออยู่ภายในไปยังตัวจัดการ referUrl ของคุณ และ TwiML ที่ตัวจัดการ
ส่งกลับจะกำหนดว่าผู้โทรจะไปที่ใด เช่น คิว Flex
ก่อนเริ่มต้น
- เอเจนต์ ThunderPhone และคีย์ APIขององค์กร
- Twilio Programmable Voice และตำแหน่งสำหรับให้บริการ TwiML กับตัวจัดการ
referUrl: เซิร์ฟเวอร์ของคุณเอง หรือ TwiML Bin และ Twilio Function ไม่จำเป็นต้องใช้ Flex
1. สร้างปลายทาง SIP
<Sip> ของ Twilio รับชื่อผู้ใช้และรหัสผ่าน ดังนั้นให้ใช้ปลายทางมาตรฐาน:
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 ต้นทาง
2. ส่งสายพร้อมบริบท
ส่งกลับ TwiML นี้สำหรับสายที่คุณต้องการส่งต่อให้เอเจนต์:
<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ส่งCallSidTwilio ไม่มีเอกสารเกี่ยวกับส่วนหัว call-id ของตัวเอง ดังนั้นให้เพิ่มส่วนหัวนี้: ThunderPhone จะจัดเก็บเป็นexternal_call_idของสาย{{CallSid}}ใช้ได้ใน TwiML Bin; หากใช้เซิร์ฟเวอร์ของคุณเอง ให้เขียนCallSidของคำขอขาเข้า- เพิ่มบริบทเพิ่มเติมด้วยวิธีเดียวกัน เช่น
&X-Account-Id=12345ภายใน TwiML ให้เขียน&เป็น&เนื่องจาก&เดี่ยวเป็น XML ที่ไม่ถูกต้อง แต่ละค่า จะไปถึงพรอมป์ต์ในรูปตัวแปร เช่น{{sip_x_account_id}}Twilio อนุญาตส่วนหัวx-และUser-to-Userที่เข้ารหัสแบบเปอร์เซ็นต์ โดย URI ทั้งหมดต้องมีความยาวไม่เกิน 255 อักขระ และส่วนหัวต้องมีความยาวไม่เกิน 1,024 อักขระ referUrlช่วยให้ Twilio รับREFERของเอเจนต์ได้ หากไม่มี การโอนสายจะล้มเหลวพร้อม ข้อผิดพลาด 13802answerOnBridge="true"จะคงการเชื่อมต่อของผู้โทรไว้จนกว่าปลายทางใหม่จะรับสาย ดังนั้นการโอนสายที่ล้มเหลวจึงสามารถใช้ทางเลือกสำรองได้
วิดเจ็ต เชื่อมต่อสายไปยัง ของ Studio ไม่มีเอกสารเกี่ยวกับส่วนหัวแบบกำหนดเองหรือ
referUrl ดังนั้นจาก Studio ให้ส่งสายไปยัง TwiML นี้ เช่น ด้วยวิดเจ็ต
การเปลี่ยนเส้นทาง TwiML
3. รับสายกลับ
เอเจนต์โอนสายด้วย REFER ซึ่งที่อยู่สำหรับโอนสายมีรหัสและเจตนาของการส่งต่อ เพิ่มหมายเลขโอนสายนี้ (ดู
เพิ่มหมายเลขโอนสาย
และ ส่วนหัวภายในที่อยู่สำหรับโอนสาย):
{
"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 ได้:
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 ดู ค้นหาสายที่ส่งต่อแล้ว สำหรับฟิลด์อื่น
ทดสอบ
โทรไปยังหมายเลข 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>ตามตัวอย่างข้างต้น