---
title: "Повежите из Twilio"
description: "Усмерите Twilio позиве ка ThunderPhone агенту преко SIP-а помоћу CallSid-а и вратите их преко свог referUrl-а, уз прослеђивање у адреси за трансфер."
---

Ваш TwiML позива SIP адресу агента са `CallSid` позива у заглављу.
Када је позиваоцу потребна особа, агент шаље SIP `REFER`, Twilio прослеђује
адресу за пренос са подацима о предаји позива у њој вашем `referUrl`
руковаоцу, а TwiML који Ваш руковалац врати одлучује куда се позивалац усмерава, као што је Flex ред.

## Пре него што почнете

- ThunderPhone агент и [API кључ](/sr/guides/api-keys) организације.
- Twilio Programmable Voice и место за испоручивање TwiML-а и `referUrl`
  руковаоца: Ваш сопствени сервер или TwiML Bin и Twilio Function. Flex је
  опционалан.

## 1. Креирајте SIP крајњу тачку

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

```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": "Twilio"}'
```

Одмах сачувајте `password` из одговора; приказује се само једном. Да бисте
прихватали позиве само од Twilio-а, погледајте
[Ограничите изворне IP адресе](/sr/guides/sip-addresses).

## 2. Шаљите позиве са контекстом

Вратите овај TwiML за позив који желите да проследите агенту:

```xml
<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](https://www.twilio.com/docs/api/errors/13802).
  `answerOnBridge="true"` одржава позиваоца повезаним док ново одредиште не
  одговори, па неуспешан пренос може да користи резервни поступак.

Studio-ов виџет **Повежите позив са** не документује прилагођена заглавља ни
`referUrl`, зато из Studio-а проследите позив овом TwiML-у, на пример помоћу
виџета **Преусмерите TwiML**.

## 3. Преузмите позив назад

Агент преноси позив помоћу `REFER` захтева чија адреса за пренос садржи
ИД и намеру предаје. Додајте овај број за пренос (погледајте
[Додавање броја за пренос](/sr/guides/contact-centers/overview)
и [Заглавља у адреси за пренос](/sr/guides/call-transfers)):

```json
{
  "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`:

```js
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 кључ у променљивим окружења функције. Погледајте
[Проналажење предатог позива](/api-reference/calls#look-up-a-handed-off-call)
за остала поља.

## Тестирајте

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