---
title: "Подключение из Talkdesk"
description: "Перенаправляйте звонки Talkdesk голосовому агенту ThunderPhone с помощью Connect to Autopilot Voice и передавайте их обратно с идентификатором передачи в UUI."
---

Ваш поток Talkdesk Studio передаёт звонящего агенту вместе с идентификатором
взаимодействия и UUI. Когда звонящему нужен человек, агент выполняет эскалацию
через SIP `REFER` в Talkdesk, а идентификатор передачи попадает в переменную Studio.

## Перед началом

- Агент ThunderPhone и [API-ключ](/ru/guides/api-keys) организации.
- Лицензия Talkdesk **Conversation Orchestrator**, включающая компонент Studio
  **Подключиться к Autopilot Voice** в режиме **Внешний голосовой поток**
  ([статья Talkdesk](https://support.talkdesk.com/hc/en-us/articles/48921776047259)).
  Talkdesk тарифицирует её поминутно, пока агент удерживает звонок.

## 1. Создайте SIP-эндпоинт

Talkdesk документирует только список разрешённых IP-адресов, поэтому создайте
эндпоинт, принимающий звонки по адресу источника:

```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": "Talkdesk",
    "auth": "ip_allowlist",
    "allowed_source_cidrs": ["TALKDESK_SIGNALLING_RANGE_1", "TALKDESK_SIGNALLING_RANGE_2"],
    "srtp": "optional"
  }'
```

В статье Talkdesk указано, что аудио передаётся по SRTP, а `"srtp": "optional"`
отвечает по SRTP, когда Talkdesk предлагает его. В статье не указано, требует ли Talkdesk
SRTP; если Talkdesk сообщает, что требует, установите для `srtp` значение `required`,
которое отклоняет звонки без него.

Получите диапазоны SIP-сигнализации Talkdesk у Talkdesk. Каждый должен быть публичным диапазоном IPv4
размером `/16` или уже (IPv6 — `/48` или уже). См.
[Платформы, аутентифицируемые по IP-адресу источника](/ru/guides/sip-addresses).
Talkdesk отправляет SIP из сети Twilio, адреса которой используются всеми клиентами Twilio,
поэтому адрес эндпоинта не позволяет другим звонящим подключиться: не
публикуйте его.
Сохраните `sip_uri` из ответа, например
`sip:agent-12-jhxmginwjx@sip.thunderphone.com`.

## 2. Передавайте звонки с контекстом

В потоке Studio добавьте **Подключиться к Autopilot Voice** в режиме **Внешний голосовой
поток** и задайте в качестве цели `sip_uri` эндпоинта с добавленным `;transport=tls`, например
`sip:agent-12-jhxmginwjx@sip.thunderphone.com;transport=tls`. Эндпоинт
отклоняет звонки по UDP, который SIP Twilio использует, если не указано иное.

Talkdesk отправляет:

- `X-Talkdesk-Interaction-Id`, сохраняемый как `external_call_id` звонка;
- `User-to-User` в шестнадцатеричном кодировании, например `business_hours=open`. Он поступает в
  промпт в декодированном виде как `{{sip_uui}}`.

Версия 2.1 компонента также может отправлять **Заданные заголовки**. На странице
настроек Talkdesk они описаны как JSON, передаваемый по WebSocket, поэтому уточните у
Talkdesk, поступают ли они как SIP-заголовки, прежде чем полагаться на них.

## 3. Получите вызов обратно

Агент выполняет эскалацию с помощью `REFER` на адрес эскалации Talkdesk, передавая
идентификатор передачи как шестнадцатеричный UUI внутри этого адреса — единственного
места, откуда Talkdesk его считывает. Добавьте этот номер перевода (см.
[Добавление номера перевода](/ru/guides/contact-centers/overview)
и [Заголовки внутри адреса перевода](/ru/guides/call-transfers)):

```json
{
  "name": "Talkdesk escalation",
  "number": "sip:escalation@talkdesk.com",
  "headers": {"User-to-User": "autopilot_result={{handoff_id}}"},
  "headers_in_uri": true,
  "uui_encoding": "hex"
}
```

Используйте адрес из статьи Talkdesk. Версия компонента 2.1 считывает
`autopilot_result=`; версия 1.7 считывает `escalate_to=`, поэтому в версии
1.7 используйте этот ключ. `REFER` выглядит так:

```
Refer-To: <sip:escalation@talkdesk.com?User-to-User=6175746F70696C6F745F726573756C743D...%3Bencoding%3Dhex>
```

Talkdesk помещает значение в переменную Studio. Чтобы получить сводку и интент,
добавьте шаг **Выполнить действие** в пользовательскую интеграцию, созданную с
помощью Connections:

- Тип аутентификации — **ключ API**, имя заголовка — `Authorization`, значение —
  `Bearer sk_live_…`.
- Запрос: `GET https://api.thunderphone.com/v1/calls/handoff?handoff_id=`,
  затем добавьте идентификатор из переменной. Также можно найти вызов по
  `external_call_id`, используя идентификатор взаимодействия.
- Настройте маршрутизацию по `handoff.intent` и покажите `handoff.summary`
  сотруднику, принимающему вызов.

См. [Поиск переданного вызова](/api-reference/calls#look-up-a-handed-off-call).

## Проверьте

Начните вызов через поток Studio, попросите агента перевести вас на сотрудника и
убедитесь, что поток продолжается после компонента, а идентификатор передачи
находится в его переменной. Затем откройте вызов с помощью `GET /v1/calls/{call_id}`:
`external_call_id` должен совпадать с идентификатором взаимодействия Talkdesk.

## Ограничения

- Talkdesk считывает не более 256 байтов UUI и не допускает значений, разделённых
  `|` или `;`, поэтому отправляйте одно значение. Идентификатор передачи помещается.
- API Talkdesk не могут считывать расшифровку разговора агента. Вместо этого
  используйте поиск передачи или `GET /v1/calls/{call_id}`.
