ThunderPhone v3 พร้อมให้ใช้งานแล้วเริ่มใช้งานได้ด้วยตัวเอง ราคาเริ่มต้น 2 เซนต์ต่อนาที.อ่านประกาศเปิดตัว

Contact centers

เชื่อมต่อจาก 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 ส่ง 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 answerOnBridge="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> ตามตัวอย่างข้างต้น