ThunderPhone v3 jau veikia.Viską atlikite savarankiškai – nuo 2 ct/min.Skaityti pranešimą

Contact centers

Prisijungimas iš Microsoft Dynamics 365

Per savo SBC siųskite Dynamics 365 Contact Center ir Copilot Studio skambučius balso agentui ThunderPhone naudodami X antraštes ir per HTTP gaukite agento perdavimo duomenis.

Dynamics 365 Contact Center nukreipia skambinantįjį į agentą per jūsų sesijos sieninį valdiklį (SBC), perduodamas iki penkių X antraščių, įskaitant pokalbio identifikatorių. Kai agentas baigia skambutį, jūsų SBC grąžina skambinantįjį į Dynamics 365, o HTTP Request mazgas gauna perdavimo informaciją.

Prieš pradėdami

  • ThunderPhone agentas ir organizacijos API raktas.
  • Dynamics 365 Contact Center balso kanalas, prijungtas per Azure Communication Services Tiesioginį maršrutizavimą prie jūsų valdomo SBC (SBC reikalavimai): palaikomas SBC su viešuoju sertifikatu, TLS 1.2 per 5061 prievadą ir SRTP ryšiu su Microsoft.
  • SIP X antraščių palaikymas Pokalbio perkėlimo mazge (Copilot Studio). Patvirtinkite, kad jis pasiekiamas jūsų aplinkoje.

Dynamics 365 perkelia tik į telefono numerį, o Microsoft autentifikuoja tiesioginį maršrutizavimą sertifikatu, o ne slaptažodžiu. Jūsų SBC yra tarp Microsoft ir ThunderPhone bei paverčia šį numerį agento SIP adresu.

1. Sukurkite SIP galinį tašką

Skambutis ThunderPhone pasiekia iš jūsų SBC, todėl sukurkite standartinį galinį tašką, kurį naudos 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"}'

Iš karto išsaugokite atsakyme pateiktą password; jis rodomas vieną kartą, o jūsų SBC juo atsako į ThunderPhone užklausą. Jei jūsų SBC nepalaiko digest autentifikavimo, vietoje to sukurkite galinį tašką, nustatę auth į ip_allowlist ir nurodę viešąjį SBC adresą; žr. Platformos, kurios autentifikuoja pagal šaltinio IP.

2. Siųskite skambučius su kontekstu

  1. SBC pasirinkite agento telefono numerį, pavyzdžiui, +14155550188.
  2. SBC nukreipkite skambučius į šį numerį į galinio taško sip_uri, pavyzdžiui, sip:agent-12-jhxmginwjx@sip.thunderphone.com, naudodami TLS per prievadą 5061. ThunderPhone galinį tašką randa pagal naudotojo dalį (agent-12-jhxmginwjx), kuri turi būti ir užklausos URI, ir To antraštėje. Perduokite X antraštes nepakeistas.
  3. Copilot Studio pridėkite Pokalbio perkėlimo mazgą su Perkėlimu į išorinį telefono numerį į šį numerį ir pridėkite X antraštes:
    • X-Call-ID: Dynamics 365 pokalbio identifikatorius. Jokia Microsoft antraštė jo neperduoda, todėl pridėkite jį čia; ThunderPhone išsaugo jį kaip skambučio external_call_id. Copilot Studio patvirtinkite, kuriame kintamajame saugomas pokalbio identifikatorius.
    • Dar iki keturių antraščių, pavyzdžiui, X-Customer-Tier.

Microsoft siunčia daugiausia penkias X antraštes, kurių pavadinimai gali būti iki 64 simbolių, o reikšmės iki 256 simbolių; naudojamos raidės, skaitmenys ir = ; . ! % * _ + ~ -. Priešdėlį ji rašo mažosiomis raidėmis kaip x-; ThunderPhone antraščių pavadinimus lygina nepaisydamas didžiųjų ir mažųjų raidžių, todėl x-customer-tier raginimą pasiekia kaip {{sip_x_customer_tier}}.

Jei skambutį kuriate naudodami Azure Communication Services Call Automation, AddSipX pagal numatytuosius nustatymus įrašo X-MS-Custom- pavadinimus. Perduokite SipHeaderPrefix.X, kad X-Call-ID išlaikytų savo pavadinimą (pasirinktinis kontekstas).

3. Grąžinkite skambutį

Agentas grąžina skambutį: jis atsisveikina ir nutraukia ryšį. Pridėkite šį perdavimo numerį (žr. Pridėkite perdavimo numerį):

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

Skambinančiojo grąžinimas į Dynamics 365 yra jūsų SBC užduotis. Microsoft dokumentuoja vieną būdą, kaip priimti skambutį su kontekstu: naują skambutį per SBC į Dynamics 365 užregistruotą numerį su UUI, kurio raktai atitinka konteksto kintamuosius, kuriuos nustatėte skiltyje Darbo srautai → Išplėstiniai nustatymai (trečiosios šalies IVR perdavimas). Su SBC tiekėju išsiaiškinkite, kaip skambinantysis pasiekia šį numerį, kai ThunderPhone nutraukia ryšį, ir perduokite pokalbio identifikatorių, kurį išsiuntėte per X-Call-ID, kad srautas galėtų rasti skambutį.

Tada gaukite perdavimo duomenis naudodami Copilot Studio HTTP užklausos mazgą:

  • GET https://api.thunderphone.com/v1/calls/handoff?external_call_id= po kurio nurodomas pokalbio identifikatorius.
  • Antraštė Authorization: Bearer sk_live_….
  • Išanalizuokite atsakymą į kintamąjį ir naudokite handoff.summary bei handoff.intent.

Žr. Raskite perduotą skambutį.

Išbandykite

Paskambinkite į Dynamics 365 numerį, kuris pasiekia perdavimo mazgą, paprašykite agento žmogaus ir patikrinkite, ar skambinantysis grįžta į Dynamics 365. Tada atidarykite skambutį naudodami GET /v1/calls/{call_id}: sip_headers turėtų nurodyti x-call-id, o external_call_id turėtų būti pokalbio identifikatorius. Jei skambutis niekada nepasiekia agento ir jūsų SBC žurnaluose matomas SIP 404, jo užklausos URI arba To antraštėje nėra galinio taško naudotojo dalies.

Ribojimai

  • Reikalingas SBC. Microsoft negali skambinti SIP adresu ar atsakyti į Digest autentifikavimo iššūkį.
  • Microsoft siunčia ne daugiau kaip penkias X antraštes ir įeinančiame skambutyje išsaugo tik pirmąsias penkias. Dynamics 365 priima ne daugiau kaip 128 UUI simbolius.
  • Microsoft nedokumentuoja antraščių nuskaitymo iš BYE, todėl perdavimo duomenys grąžinami tik per paiešką.