Open in
Повежите се из 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. Шаљите позиве са контекстом
- Изаберите број телефона за агента на Вашем SBC-у, као што је
+14155550188. - На SBC-у усмерите позиве на тај број ка
sip_uriкрајње тачке, на примерsip:agent-12-jhxmginwjx@sip.thunderphone.com, преко TLS-а на порту5061. ThunderPhone проналази крајњу тачку према корисничком делу (agent-12-jhxmginwjx), који мора бити и у URI-ју захтева и у заглављуTo. Проследите X-заглавља непромењена. - У 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, па се пренос враћа само путем претраге.