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