Open in
Свързване от Talkdesk
Изпращайте обаждания от Talkdesk към агент на ThunderPhone чрез „Свързване с 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. За да получите обобщението и намерението, добавете стъпка Изпълнение на действие към персонализирана интеграция, създадена с Връзки:
- Тип удостоверяване: 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}.