Open in
Повежите се из Talkdesk-а
Усмерите Talkdesk позиве ка ThunderPhone агенту помоћу опције Connect to Autopilot Voice и вратите их уз ескалацију помоћу идентификатора за пренос у UUI-ју.
Ваш ток у Talkdesk Studio-у шаље позиваоца гласовном агенту са ИД-ом интеракције
и UUI-јем. Када је позиваоцу потребна особа, агент ескалира позив помоћу SIP
REFER захтева ка Talkdesk-у, а ИД предаје се смешта у Studio променљиву.
Пре него што почнете
- ThunderPhone агент и API кључ организације.
- Лиценца за Talkdesk Оркестратор разговора, која покрива 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-ја и не дозвољава вредности раздвојене са
|или;, па пошаљите једну вредност. Идентификатор предаје одговара. - Talkdesk API-ји не могу да прочитају транскрипт гласовног агента. Уместо тога,
користите претрагу предатог позива или
GET /v1/calls/{call_id}.