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 не поддържа дайджест
автентикация, вместо това създайте крайната точка с 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, затова предаването се връща само чрез търсенето.