Open in
Povežite se iz Microsoft Dynamics 365
Usmjerite pozive iz rješenja Dynamics 365 Contact Center i Copilot Studio prema agentu ThunderPhone putem svojeg SBC-a s X-zaglavlima te putem HTTP-a dohvatite prijenos poziva agenta.
Dynamics 365 Contact Center šalje pozivatelja agentu putem Vašeg kontrolera granice sesije (SBC), s najviše pet X-zaglavlja, uključujući ID razgovora. Kada agent završi, prekida poziv, Vaš SBC vraća pozivatelja u Dynamics 365, a čvor HTTP zahtjeva dohvaća predaju.
Prije početka
- ThunderPhone agent i organizacijski API ključ.
- Glasovni kanal za Dynamics 365 Contact Center, povezan putem usluge Azure Communication Services Izravno usmjeravanje sa SBC-om kojim upravljate (zahtjevi za SBC): podržani SBC s javnim certifikatom, TLS 1.2 na priključku 5061 i SRTP-om prema Microsoftu.
- Podrška za SIP X-zaglavlja na čvoru Prijenos razgovora (Copilot Studio). Potvrdite da je dostupna u Vašem okruženju.
Dynamics 365 prenosi samo na telefonski broj, a Microsoft provjerava autentičnost Izravnog usmjeravanja certifikatom, a ne lozinkom. Vaš SBC nalazi se između Microsofta i ThunderPhonea te taj broj pretvara u SIP adresu agenta.
1. Izradite SIP krajnju točku
Poziv dolazi do ThunderPhonea s Vašeg SBC-a, stoga izradite standardnu krajnju točku koju će SBC upotrebljavati:
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"}'Odmah spremite password iz odgovora; prikazuje se samo jednom, a Vaš SBC njime
odgovara na ThunderPhoneov izazov. Ako Vaš SBC ne podržava digest
autentifikaciju, umjesto toga izradite krajnju točku s postavkom auth na
ip_allowlist i javnom adresom Vašeg SBC-a; pogledajte
Platforme koje provjeravaju autentičnost prema izvornoj IP adresi.
2. Šaljite pozive s kontekstom
- Odaberite telefonski broj za agenta na Vašem SBC-u, primjerice
+14155550188. - Na SBC-u usmjerite pozive na taj broj prema
sip_urikrajnje točke, na primjersip:agent-12-jhxmginwjx@sip.thunderphone.com, putem TLS-a na priključku5061. ThunderPhone pronalazi krajnju točku prema korisničkom dijelu (agent-12-jhxmginwjx), koji mora biti i u URI-ju zahtjeva i u zaglavljuTo. Proslijedite X-zaglavlja nepromijenjena. - U alatu Copilot Studio dodajte čvor Prijenos razgovora s opcijom
Prijenos na vanjski telefonski broj na taj broj te dodajte X-zaglavlja:
X-Call-ID: ID razgovora u sustavu Dynamics 365. Nijedno Microsoftovo zaglavlje ne sadrži ga, stoga ga dodajte ovdje; ThunderPhone ga pohranjuje kaoexternal_call_idpoziva. U alatu Copilot Studio potvrdite koja varijabla sadrži ID razgovora.- Do četiri dodatna zaglavlja, kao što je
X-Customer-Tier.
Microsoft šalje najviše pet X-zaglavlja, s nazivima do 64 znaka i vrijednostima
do 256 znakova, koristeći slova, znamenke i = ; . ! % * _ + ~ -. Prefiks
zapisuje malim slovima kao x-; ThunderPhone uspoređuje nazive zaglavlja bez
obzira na velika i mala slova, pa x-customer-tier dolazi u prompt kao
{{sip_x_customer_tier}}.
Ako poziv umjesto toga izradite pomoću usluge Azure Communication Services Call
Automation, AddSipX prema zadanim postavkama zapisuje nazive X-MS-Custom-.
Proslijedite SipHeaderPrefix.X kako bi X-Call-ID zadržao svoj naziv
(prilagođeni kontekst).
3. Vratite poziv
Agent vraća poziv: pozdravlja se i prekida vezu. Dodajte ovaj broj za preusmjeravanje (pogledajte Dodajte broj za preusmjeravanje):
{"name": "Dynamics 365", "action": "return"}Vraćanje pozivatelja u Dynamics 365 zadatak je vašeg SBC-a. Microsoft
dokumentira jedan način ulaska za poziv s kontekstom: novi poziv preko SBC-a na
broj registriran u Dynamics 365, s UUI-jem čiji ključevi odgovaraju varijablama
konteksta koje ste postavili u odjeljku Tijekovi rada → Napredne postavke
(prijenos IVR-a treće strane).
Dogovorite s dobavljačem SBC-a kako pozivatelj dolazi do tog broja kada
ThunderPhone prekine vezu te prenesite ID razgovora koji ste poslali u
X-Call-ID kako bi tijek mogao pronaći poziv.
Zatim dohvatite podatke o predaji čvorom Copilot Studio HTTP zahtjev:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=nakon kojeg slijedi ID razgovora.- Zaglavlje
Authorization: Bearer sk_live_…. - Raščlanite odgovor u varijablu i upotrijebite
handoff.summaryihandoff.intent.
Pogledajte Potražite predani poziv.
Testirajte
Nazovite broj u sustavu Dynamics 365 koji vodi do čvora za preusmjeravanje,
zatražite od agenta osobu i provjerite vraća li se pozivatelj u Dynamics 365.
Zatim otvorite poziv pomoću GET /v1/calls/{call_id}: sip_headers bi trebao
navesti x-call-id, a external_call_id bi trebao biti ID razgovora. Ako poziv
nikada ne dođe do agenta, a zapisi vašeg SBC-a prikazuju SIP 404, URI zahtjeva
ili zaglavlje To ne sadrži korisnički dio krajnje točke.
Ograničenja
- SBC je obavezan. Microsoft ne može uspostaviti poziv na SIP adresu ni odgovoriti na digest provjeru autentičnosti.
- Microsoft šalje najviše pet X-zaglavlja i zadržava samo prvih pet u dolaznom pozivu. Dynamics 365 prihvaća najviše 128 znakova UUI-ja.
- Microsoft ne dokumentira čitanje zaglavlja u poruci
BYE, stoga se podaci o predaji vraćaju samo putem pretraživanja.