ThunderPhone v3 вече е тук.Започнете самостоятелно — от 2 цента/мин.Прочетете съобщението

Contact centers

Свързване от 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}.