ThunderPhone v3 on julkaistu.Ota käyttöön itse – alkaen 2 ¢/min.Lue lisää julkistuksesta

Contact centers

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

  1. Valitse SBC:ssä agentille puhelinnumero, esimerkiksi +14155550188.
  2. Reititä SBC:ssä tähän numeroon tulevat puhelut päätepisteen sip_uri-osoitteeseen, esimerkiksi sip:agent-12-jhxmginwjx@sip.thunderphone.com, TLS:llä portissa 5061. 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.
  3. 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 puhelun external_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.summary ja handoff.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.