Open in
Подключение из 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}.