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 крајњу тачку

Twilio-ов <Sip> прихвата корисничко име и лозинку, зато користите стандардну крајњу тачку:

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 не документује сопствено заглавље ИД-а позива, зато додајте ово: 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 функција ставља позиваоца у Flex ред са предајом као атрибутима задатка и проналази сажетак по ИД-у предаје. Претрага се извршава у функцији јер Studio виџет HTTP Request не може да пошаље заглавље 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 кључ у променљивим окружења функције. Погледајте Проналажење предатог позива за остала поља.

Тестирајте

Позовите 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> као горе.