---
title: "Свързване от Twilio"
description: "Изпращайте обаждания от Twilio към агент на ThunderPhone през SIP с CallSid и ги връщайте чрез вашия referUrl с прехвърлянето в адреса за прехвърляне."
---

Вашият TwiML набира SIP адреса на агента със `CallSid` на обаждането в заглавка.
Когато обаждащият се има нужда от човек, агентът изпраща SIP `REFER`, Twilio предава
адреса за прехвърляне с данните за предаването в него към вашия обработчик на `referUrl`,
а TwiML, който обработчикът ви връща, определя къде ще бъде насочен обаждащият се, например към опашка на Flex.

## Преди да започнете

- Агент на ThunderPhone и [API ключ на организацията](/bg/guides/api-keys).
- Twilio Programmable Voice и място за обслужване на TwiML и обработчик на
  `referUrl`: ваш собствен сървър или TwiML Bin и Twilio Function. Flex не е
  задължителен.

## 1. Създайте SIP крайна точка

`<Sip>` на Twilio приема потребителско име и парола, затова използвайте стандартна крайна точка:

```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 адресите на източника](/bg/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`, чийто адрес за прехвърляне съдържа идентификатора
и намерението на предаването. Добавете този номер за прехвърляне (вижте
[Добавяне на номер за прехвърляне](/bg/guides/contact-centers/overview)
и [Заглавки в адреса за прехвърляне](/bg/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 Function поставя обаждащия се на опашка към Flex с предаването като
атрибути на задачата и намира обобщението по идентификатор на предаването.
Търсенето се изпълнява във Function, защото уиджетът HTTP Request на Studio не
може да изпраща заглавката `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 ключа в променливите на средата на Function. Вижте
[Намиране на предадено обаждане](/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>`, както е описано по-горе.
