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 не документира собствена заглавка за идентификатор на обаждане, затова добавете тази: 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>, както е описано по-горе.