Open in
Yhdistä Microsoft Dynamics 365:stä
Ohjaa Dynamics 365 Contact Centerin ja Copilot Studion puhelut ThunderPhone-agentille SBC:si kautta X-otsakkeilla ja hae agentin puhelunsiirto HTTP:n kautta.
Dynamics 365 Contact Center lähettää soittajan agentille istuntorajakontrollerisi (SBC) kautta enintään viidellä X-otsakkeella, mukaan lukien keskustelutunnus. Kun agentti on valmis, se katkaisee puhelun, SBC:si palauttaa soittajan Dynamics 365:een, ja HTTP Request -solmu hakee siirron.
Ennen kuin aloitat
- ThunderPhone-agentti ja organisaation API-avain.
- Dynamics 365 Contact Centerin puhekanava, joka on yhdistetty Azure Communication Servicesin Direct Routing -toiminnolla käyttämääsi SBC:hen (SBC-vaatimukset): tuettu SBC, jossa on julkinen varmenne, TLS 1.2 portissa 5061 ja SRTP Microsoftiin päin.
- SIP X-otsaketuki Keskustelun siirto -solmussa (Copilot Studio). Varmista, että se on käytettävissä ympäristössäsi.
Dynamics 365 siirtää puhelun vain puhelinnumeroon, ja Microsoft todentaa Direct Routingin varmenteella, ei salasanalla. SBC:si sijaitsee Microsoftin ja ThunderPhonen välissä ja muuntaa kyseisen numeron agentin SIP-osoitteeksi.
1. Luo SIP-päätepiste
Puhelu saapuu ThunderPhoneen SBC:si kautta, joten luo SBC:n käytettäväksi tavallinen päätepiste:
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"}'Tallenna vastauksen password heti; se näytetään vain kerran, ja SBC:si vastaa sillä ThunderPhonen haasteeseen. Jos SBC:si ei tue digest-todennusta, luo päätepiste siten, että auth on ip_allowlist ja käytä sen sijaan SBC:si julkista osoitetta; katso
Lähde-IP-osoitteella todentavat alustat.
2. Välitä puhelut kontekstin kanssa
- Valitse SBC:ssä agentille puhelinnumero, esimerkiksi
+14155550188. - Reititä SBC:ssä tähän numeroon tulevat puhelut päätepisteen
sip_uri-osoitteeseen, esimerkiksisip:agent-12-jhxmginwjx@sip.thunderphone.com, TLS:llä portissa5061. ThunderPhone löytää päätepisteen käyttäjäosan (agent-12-jhxmginwjx) perusteella, jonka on oltava sekä pyyntö-URI:ssa ettäTo-otsakkeessa. Välitä X-otsakkeet muuttamattomina. - Lisää Copilot Studiossa Keskustelun siirto -solmu, jossa Siirto ulkoiseen puhelinnumeroon on asetettu tähän numeroon, ja lisää X-otsakkeet:
X-Call-ID: Dynamics 365:n keskustelutunnus. Mikään Microsoftin otsake ei sisällä sitä, joten lisää se tähän; ThunderPhone tallentaa sen puhelunexternal_call_id-arvoksi. Varmista Copilot Studiossa, mikä muuttuja sisältää keskustelutunnuksen.- Enintään neljä muuta otsaketta, kuten
X-Customer-Tier.
Microsoft lähettää enintään viisi X-otsaketta, joiden nimet ovat enintään 64 merkkiä ja arvot enintään 256 merkkiä ja joissa käytetään kirjaimia, numeroita sekä merkkejä = ; . ! % * _ + ~ -. Se kirjoittaa etuliitteen pienillä kirjaimilla x-; ThunderPhone vastaa otsakenimiä kirjainkoosta riippumatta, joten x-customer-tier päätyy kehotteeseen muodossa {{sip_x_customer_tier}}.
Jos rakennat puhelun sen sijaan Azure Communication Services Call Automationilla, AddSipX kirjoittaa oletusarvoisesti X-MS-Custom--nimet. Välitä SipHeaderPrefix.X, jotta X-Call-ID säilyttää nimensä
(mukautettu konteksti).
3. Palauta puhelu
Agentti palauttaa puhelun: se hyvästelee ja katkaisee puhelun. Lisää tämä siirtonumero (katso Lisää siirtonumero):
{"name": "Dynamics 365", "action": "return"}Soittajan palauttaminen Dynamics 365:een on SBC:si tehtävä. Microsoft
dokumentoi yhden tavan tuoda kontekstia sisältävä puhelu takaisin: uusi puhelu SBC:n kautta
Dynamics 365:een rekisteröityyn numeroon, jossa on UUI, jonka avaimet vastaavat
kohdassa Työvirrat → Lisäasetukset määrittämiäsi kontekstimuuttujia
(kolmannen osapuolen IVR-siirto).
Selvitä SBC-toimittajasi kanssa, miten soittaja pääsee tähän numeroon, kun
ThunderPhone katkaisee puhelun, ja välitä lähettämäsi keskustelutunnus X-Call-ID-otsakkeessa,
jotta työnkulku löytää puhelun.
Nouda sitten luovutustiedot Copilot Studion HTTP-pyyntö -solmulla:
GET https://api.thunderphone.com/v1/calls/handoff?external_call_id=ja sen perään keskustelutunnus.- Otsake
Authorization: Bearer sk_live_…. - Jäsennä vastaus muuttujaan ja käytä arvoja
handoff.summaryjahandoff.intent.
Katso Siirretyn puhelun haku.
Testaa
Soita Dynamics 365 -numeroon, joka saavuttaa siirtosolmun, pyydä agenttia
yhdistämään sinut henkilölle ja tarkista, että soittaja palaa Dynamics 365:een. Avaa sitten
puhelu komennolla GET /v1/calls/{call_id}: kohdan sip_headers pitäisi sisältää x-call-id, ja
kohdan external_call_id pitäisi olla keskustelutunnus. Jos puhelu ei koskaan saavuta
agenttia ja SBC-lokeissa näkyy SIP 404, sen pyyntö-URI tai To-otsake ei sisällä
päätepisteen käyttäjäosaa.
Rajoitukset
- SBC vaaditaan. Microsoft ei voi soittaa SIP-osoitteeseen eikä vastata digest-haasteeseen.
- Microsoft lähettää enintään viisi X-otsaketta ja säilyttää saapuvassa puhelussa vain viisi ensimmäistä. Dynamics 365 hyväksyy UUI:ssa enintään 128 merkkiä.
- Microsoft ei dokumentoi otsakkeiden lukemista
BYE-viestistä, joten luovutustiedot palautuvat vain haun kautta.