ThunderPhone 2.0 on nüüd saadaval.Iseteenindusena alates 2 senti/min.Loe uudist
Alusta

Contact centers

View as Markdown
Open in
ClaudeChatGPTCursor

Ühenda Microsoft Dynamics 365-st

Suuna Dynamics 365 Contact Centeri ja Copilot Studio kõned X-päiste abil oma SBC kaudu ThunderPhone

Dynamics 365 Contact Center saadab helistaja sinu seansipiirikontrolleri (SBC) kaudu häälagendile koos kuni viie X-päisega, sealhulgas vestluse ID-ga. Kui häälagent lõpetab, katkestab see kõne, sinu SBC suunab helistaja tagasi Dynamics 365-sse ning HTTP-päringu sõlm toob üleandmise andmed.

Enne alustamist

  • ThunderPhone'i häälagent ja organisatsiooni API-võti.
  • Dynamics 365 Contact Centeri häälkanal, mis on Azure Communication Servicesi otse marsruutimise kaudu ühendatud sinu hallatava SBC-ga (SBC nõuded): toetatud SBC avaliku sertifikaadiga, TLS 1.2 pordis 5061 ja SRTP Microsofti suunas.
  • SIP-i X-päiste tugi sõlmes Vestluse edastamine (Copilot Studio). Veendu, et see on sinu keskkonnas saadaval.

Dynamics 365 edastab kõnesid ainult telefoninumbrile ning Microsoft autentib otsest marsruutimist sertifikaadiga, mitte parooliga. Sinu SBC paikneb Microsofti ja ThunderPhone'i vahel ning teisendab selle numbri häälagendi SIP-aadressiks.

1. Loo SIP-lõpp-punkt

Kõne jõuab ThunderPhone'i sinu SBC-st, seega loo SBC kasutamiseks tavaline lõpp-punkt:

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"}'

Salvesta vastusest kohe password; seda kuvatakse üks kord ning sinu SBC vastab sellega ThunderPhone'i väljakutsele. Kui sinu SBC ei toeta digesta autentimist, loo lõpp-punkt hoopis väärtusega auth ip_allowlist ning määra oma SBC avalik aadress; vt platvormid, mis autentivad lähte-IP järgi.

2. Saada kõned koos kontekstiga

  1. Vali oma SBC-s häälagendile telefoninumber, näiteks +14155550188.
  2. Marsruudi SBC-s sellele numbrile saabuvad kõned lõpp-punkti sip_uri-le, näiteks sip:agent-12-jhxmginwjx@sip.thunderphone.com, TLS-i kaudu pordis 5061. ThunderPhone leiab lõpp-punkti kasutajaosa (agent-12-jhxmginwjx) järgi, mis peab olema nii päringu URI-s kui ka To-päises. Edasta X-päised muutmata kujul.
  3. Lisa Copilot Studios sõlm Vestluse edastamine, mille valikuks on Edastamine välisele telefoninumbrile, sellele numbrile, ning lisa X-päised:
    • X-Call-ID: Dynamics 365 vestluse ID. Ükski Microsofti päis seda ei sisalda, seega lisa see siin; ThunderPhone salvestab selle kõne external_call_id-na. Kontrolli Copilot Studios, milline muutuja sisaldab vestluse ID-d.
    • Kuni neli täiendavat päist, näiteks X-Customer-Tier.

Microsoft saadab kuni viis X-päist, mille nimed on kuni 64 märki ja väärtused kuni 256 märki ning mis kasutavad tähti, numbreid ja märke = ; . ! % * _ + ~ -. See kirjutab eesliite väiketähtedega x-; ThunderPhone võrdleb päiste nimesid tõstutundeta, seega jõuab x-customer-tier viibani kujul {{sip_x_customer_tier}}.

Kui lood kõne selle asemel Azure Communication Services Call Automationiga, kirjutab AddSipX vaikimisi nimed kujul X-MS-Custom-. Edasta SipHeaderPrefix.X, et X-Call-ID säilitaks oma nime (kohandatud kontekst).

3. Too kõne tagasi

Häälagent tagastab kõne: jätab hüvasti ja lõpetab kõne. Lisa see edastusnumber (vt Edastusnumbri lisamine):

{"name": "Dynamics 365", "action": "return"}

Helistaja tagasi Dynamics 365-sse toomine on sinu SBC ülesanne. Microsoft dokumenteerib ühe viisi kontekstiga kõne sisenemiseks: uus kõne SBC kaudu Dynamics 365-s registreeritud numbrile koos UUI-ga, mille võtmed vastavad kontekstimuutujatele, mille seadistasid jaotises Töövood → Täpsemad sätted (kolmanda osapoole IVR-i edastus). Lepi oma SBC pakkujaga kokku, kuidas helistaja selleni numbrini jõuab, kui ThunderPhone kõne lõpetab, ja edasta vestluse ID, mille saatsid X-Call-ID päises, et voog saaks kõne üles leida.

Seejärel hangi üleandmise andmed Copilot Studio HTTP-päringu sõlmega:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= millele järgneb vestluse ID.
  • Päis Authorization: Bearer sk_live_….
  • Pars i vastus muutujaks ning kasuta väärtusi handoff.summary ja handoff.intent.

Vt Üleantud kõne otsimine.

Testi seda

Helista Dynamics 365 numbrile, mis jõuab edastussõlmeni, palu häälagendilt inimest ja kontrolli, et helistaja jõuab tagasi Dynamics 365-sse. Seejärel ava kõne päringuga GET /v1/calls/{call_id}: sip_headers peaks sisaldama väärtust x-call-id ning external_call_id peaks olema vestluse ID. Kui kõne ei jõua kunagi häälagendini ja sinu SBC logides on SIP 404, ei sisalda selle päringu URI ega päis To lõpp-punkti kasutajaosa.

Piirangud

  • SBC on nõutav. Microsoft ei saa helistada SIP-aadressile ega vastata digest-autentimise väljakutsele.
  • Microsoft saadab kuni viis X-päist ja säilitab sissetuleval kõnel ainult esimesed viis. Dynamics 365 aktsepteerib UUI-s kuni 128 märki.
  • Microsoft ei dokumenteeri päiste lugemist BYE korral, seega tuleb üleandmise andmed tagasi ainult otsingu kaudu.