ThunderPhone v3 је сада доступан.Почните самостално, већ од 2 ¢/мин.Прочитајте објаву

Contact centers

Повежите се из Microsoft Dynamics 365

Усмеравајте позиве из Dynamics 365 Contact Center и Copilot Studio ка ThunderPhone агенту преко свог SBC-а са X-заглављима и потражите пренос позива агента путем HTTP-а.

Dynamics 365 Contact Center шаље позиваоца агенту преко Вашег граничног контролера сесије (SBC), са до пет X-заглавља, укључујући ИД разговора. Када агент заврши, прекида позив, Ваш SBC враћа позиваоца у Dynamics 365, а чвор HTTP захтева преузима податке о предаји.

Пре него што почнете

  • ThunderPhone агент и организациони API кључ.
  • Гласовни канал Dynamics 365 Contact Center, повезан преко услуге Azure Communication Services Директно рутирање са SBC-ом којим управљате (захтеви за SBC): подржани SBC са јавним сертификатом, TLS 1.2 на порту 5061 и SRTP према Microsoft-у.
  • Подршка за SIP X-заглавља на чвору Пренеси разговор (Copilot Studio). Потврдите да је доступна у Вашем окружењу.

Dynamics 365 преноси само на број телефона, а Microsoft потврђује идентитет за Директно рутирање сертификатом, а не лозинком. Ваш SBC се налази између Microsoft-а и ThunderPhone-а и претвара тај број у SIP адресу агента.

1. Направите SIP крајњу тачку

Позив стиже до ThunderPhone-а са Вашег SBC-а, па направите стандардну крајњу тачку коју ће SBC користити:

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": "Dynamics 365 SBC"}'

Одмах сачувајте password из одговора; приказује се само једном, а Ваш SBC њиме одговара на ThunderPhone-ов изазов. Ако Ваш SBC не подржава digest потврду идентитета, уместо тога направите крајњу тачку са auth подешеним на ip_allowlist и јавном адресом Вашег SBC-а; погледајте Платформе које потврђују идентитет према изворној IP адреси.

2. Шаљите позиве са контекстом

  1. Изаберите број телефона за агента на Вашем SBC-у, као што је +14155550188.
  2. На SBC-у усмерите позиве на тај број ка sip_uri крајње тачке, на пример sip:agent-12-jhxmginwjx@sip.thunderphone.com, преко TLS-а на порту 5061. ThunderPhone проналази крајњу тачку према корисничком делу (agent-12-jhxmginwjx), који мора бити и у URI-ју захтева и у заглављу To. Проследите X-заглавља непромењена.
  3. У Copilot Studio додајте чвор Пренеси разговор са опцијом Пренос на спољни број телефона на тај број и додајте X-заглавља:
    • X-Call-ID: ИД разговора у Dynamics 365. Ниједно Microsoft заглавље га не садржи, зато га додајте овде; ThunderPhone га чува као external_call_id позива. У Copilot Studio потврдите која променљива садржи ИД разговора.
    • До још четири заглавља, као што је X-Customer-Tier.

Microsoft шаље највише пет X-заглавља, са именима до 64 знака и вредностима до 256 знакова, користећи слова, цифре и = ; . ! % * _ + ~ -. Префикс записује малим словима као x-; ThunderPhone упоређује имена заглавља без обзира на величину слова, тако да x-customer-tier стиже до промпта као {{sip_x_customer_tier}}.

Ако позив уместо тога правите помоћу услуге Аутоматизација позива у Azure Communication Services, AddSipX подразумевано записује имена X-MS-Custom-. Проследите SipHeaderPrefix.X како би X-Call-ID задржао своје име (прилагођени контекст).

3. Вратите позив

Агент враћа позив: поздравља се и прекида везу. Додајте овај број за пренос (погледајте Додајте број за пренос):

{"name": "Dynamics 365", "action": "return"}

Враћање позиваоца у Dynamics 365 је задатак Вашег SBC-а. Microsoft документује један начин за долазни позив са контекстом: нови позив преко SBC-а ка броју регистрованом у Dynamics 365, са UUI чији се кључеви подударају са променљивама контекста које сте подесили у оквиру Радни токови → Напредна подешавања (пренос IVR-а треће стране). Договорите са добављачем SBC-а како позивалац стиже до тог броја када ThunderPhone прекине везу и проследите ИД разговора који сте послали у X-Call-ID како би ток могао да пронађе позив.

Затим преузмите пренос помоћу чвора HTTP захтев у Copilot Studio-у:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= након чега следи ИД разговора.
  • Заглавље Authorization: Bearer sk_live_….
  • Анализирајте одговор у променљиву и користите handoff.summary и handoff.intent.

Погледајте Потражите пренети позив.

Тестирајте

Позовите број Dynamics 365 који води до чвора за пренос, затражите од агента особу и проверите да ли се позивалац враћа у Dynamics 365. Затим отворите позив помоћу GET /v1/calls/{call_id}: sip_headers треба да садржи x-call-id, а external_call_id треба да буде ИД разговора. Ако позив никада не стигне до агента, а евиденција Вашег SBC-а приказује SIP 404, URI захтева или заглавље To не садржи кориснички део крајње тачке.

Ограничења

  • SBC је обавезан. Microsoft не може да позове SIP адресу нити да одговори на digest изазов.
  • Microsoft шаље највише пет X-заглавља и задржава само првих пет за долазни позив. Dynamics 365 прихвата највише 128 знакова UUI-ја.
  • Microsoft не документује читање заглавља у оквиру BYE, па се пренос враћа само путем претраге.