ThunderPhone v3 je dostupan.Postavite sve sami, već od 2 ¢/min.Pročitajte objavu

Contact centers

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

  1. Odaberite telefonski broj za agenta na Vašem SBC-u, primjerice +14155550188.
  2. Na SBC-u usmjerite pozive na taj broj prema sip_uri krajnje točke, na primjer sip:agent-12-jhxmginwjx@sip.thunderphone.com, putem TLS-a na priključku 5061. ThunderPhone pronalazi krajnju točku prema korisničkom dijelu (agent-12-jhxmginwjx), koji mora biti i u URI-ju zahtjeva i u zaglavlju To. Proslijedite X-zaglavlja nepromijenjena.
  3. 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 kao external_call_id poziva. 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.summary i handoff.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.