ThunderPhone v3 уже доступен.Самостоятельный запуск — от 2 ¢/мин.Читать анонс

Contact centers

Подключение из Talkdesk

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

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

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

  • Агент ThunderPhone и API-ключ организации.
  • Лицензия Talkdesk Conversation Orchestrator, включающая компонент Studio Подключиться к Autopilot Voice в режиме Внешний голосовой поток (статья Talkdesk). Talkdesk тарифицирует её поминутно, пока агент удерживает звонок.

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

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

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-адресу источника. 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 его считывает. Добавьте этот номер перевода (см. Добавление номера перевода и Заголовки внутри адреса перевода):

{
  "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 сотруднику, принимающему вызов.

См. Поиск переданного вызова.

Проверьте

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

Ограничения

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