Määritä SIP X-otsikot puheenohjatuille agenteille

Tässä artikkelissa kerrotaan, miten voit määrittää SIP:n (Session Initiation Protocol) X-otsikot saapuville ja lähteville kutsuille Copilot Studion äänitoiminnoissa Dynamics 365 Contact Center käyttöä varten.

SIP X-otsikot mahdollistavat mukautetun metatiedon välittämisen puhelinjärjestelmien ja ääniohjattujen agenttien välillä. Dynamics 365 Contact Center äänikäyttöiset agentit tukevat sekä saapuvia että lähteviä X-otsikoita. Tämä konfiguraatio mahdollistaa saumattoman tiedonvaihdon puhelunsiirron ja reitityksen aikana.

edellytykset

• Dynamics 365 Contact Center kun äänikäyttöiset agentit ovat käytössä

• Copilot Studion käyttö tarvittavilla käyttöoikeuksilla

• Suora reititys puhelinkonfiguraatiota varten

• Copilot Studion aiheiden luominen ja muuttujien hallinnasta perusymmärrys

Määritä saapuvat X-otsikot

Saapuvat X-otsikot sisältävät metatietoja, jotka välitetään ulkoisista puhelinjärjestelmistä ääniohjaajallesi. Tämän datan vastaanottamiseksi ja käyttämiseksi sinun täytyy konfiguroida Parse Value -solmu, joka poimii X-otsikkotiedot Conversation.SipXHeader järjestelmämuuttujasta.

Saapuvat X-otsikkovaatimukset

• Maksimimäärä: Viisi X-headeria per saapuva puhelu.

• Nimivaatimus: Kaikkien X-otsikon nimien on alettava .x-

  Note

  Copilot Studiossa kaikkien saapuvien X-otsikoiden tulee alkaa pienillä kirjaimilla x-, vaikka X-otsikon lähettävä ulkoinen järjestelmä käyttäisi isoa kirjainkokoa X-. Copilot Studiossa määritetty lähtevä X-otsikko voi olla joko pienin kirjaimin tai isoin kirjaimin riippuen siitä, missä tapauksessa ulkoinen järjestelmä odottaa.

• Nimen pituus: enintään 64 merkkiä.

• Arvon pituus: Enintään 256 merkkiä.

• JSON-skeema vaaditaan kaikille odotetuille X-otsikoille.

• Päivitä JSON-skeema, kun X-otsikon nimet muuttuvat.

• Kanavadatariippuvuus: X-otsikot täytyy olla läsnä .Conversation.SipXHeader

Lisää muuttujien hallinta - Jäsennä arvosolmu

1. Siirry ääniohjatun agenttisi aiheeseen.

2. Lisää uusi aihesolmu.

3. Valitse muuttujien hallinta ja valitse Parse-arvo.

   

Määritä jäsennysarvosolmu

1. Järjestelmävalikosta aseta jäsennysarvokenttä arvoksi Conversation.SipXHeader.

2. Aseta datatyyppinäytedatasta.

3. Määrittele odotettu X-otsikkorakenne valitsemalla Skeema sample-JSONista.

   

Määrittele JSON-skeema X-otsikoille

Skeeman Get from sample JSON -dialogissa anna JSON-rakenne, joka sisältää ne X-otsikon nimet, joita odotat saavasi. Esimerkiksi, jos odotat otsikoita X-CallID kuten ja X-AAI-Incoming saapuvassa puhelussa, lisää ne JSON-skeemaasi.

Valitse Vahvista soveltaaksesi skeemaa.

Esimerkki JSON X-otsikoille

{

"x-CallID": "",

"x-AAI-Incoming": ""  
}

Tallenna jäsennetyt tiedot

1. Luo tai valitse muuttuja Tallenna nimellä -kentästä (esim. IncomingSipXHeader).

   

2. Aseta muuttujan laajuus globaaliksi , jotta pääset käsiksi useisiin aiheisiin agentissasi.

Pääse X-otsikon arvoihin aiheissasi

Kun olet konfiguroitu, voit käyttää yksittäisiä X-otsikon arvoja piste-merkinnällä, kuten seuraavissa esimerkeissä:

• Global.IncomingSipXHeader.'x-AAI-Incoming'

• IncomingSIPXHeaders.sipXHeader.'X-CallID'

Suorituksenaikainen toiminta

• Copilot Studio vastaanottaa vain viisi ensimmäistä X-otsikkoa, jotka ulkoinen järjestelmä lähettää.

• Copilot Studio täyttää tietueen automaattisesti X-otsikon arvoilla, kun nimet vastaavat rakennetta.

• Puuttuvilla X-otsikoilla on tyhjiä merkkijonoarvoja.

• Skeemapäivityksiä tarvitaan, kun X-otsikon nimet muuttuvat tai jos haluat lisäotsikoita.

Määritä lähtevät X-otsikot

Voit välittää mukautettua dataa, kun puhelut siirretään ulkoisiin puhelinnumeroihin lähtevien X-otsikoiden avulla. Määritä nämä otsikot Siirtokeskustelusolmussa .

Lähtevät X-headerin vaatimukset

• Maksimimäärä: Viisi X-headeria per siirto.

• Nimivaatimus: Kaikki X-otsikon nimet voivat alkaa tai X-x-, riippuen siitä, mitä tapausta ulkoinen järjestelmä odottaa.

  Note

  Copilot Studiossa kaikkien saapuvien X-otsikoiden tulee alkaa pienillä kirjaimilla x-, vaikka X-otsikon lähettävä ulkoinen järjestelmä käyttäisi isoa kirjainkokoa X-. Copilot Studiossa määritetty lähtevä X-otsikko voi olla joko pienin kirjaimin tai isoin kirjaimin riippuen siitä, missä tapauksessa ulkoinen järjestelmä odottaa.

• Nimen pituus: enintään 64 merkkiä.

• Arvon pituus: Enintään 256 merkkiä.

• Siirtotyyppi: Saatavilla vain ulkoisen puhelinnumeron siirtoon.

Aseta Siirto-keskustelusolmu

1. Lisää Transfer conversation -solmu aiheen kulkuun.

2. Valitse Siirron tyyppi -kohdassa Siirto ulkoiseen puhelinnumeroon ja syötä siirtonumero. Esimerkiksi +18005551212.

Määritä X-otsikot Siirrä keskustelusolmun ominaisuudet -osiossa

1. Valitse solmun Lisää-kuvake (…) ja valitse sitten Ominaisuudet.

2. Valitse + Lisää lisätäksesi X-otsikkoavain-arvoparit.

   

3. Määrittele X-otsikon merkinnät. Lähtevät X-otsikon nimet lähetetään täsmälleen niin kuin ne määrittelet Siirtokeskustelusolmussa . Valitse sopiva kotelo sen mukaan, mitä vastaanottojärjestelmä odottaa.

   • Avainnimi: Täytyy alkaa kirjaimella X- tai x- (esim. X-AAI-Outgoing tai X-CallID)
   • Arvo: Syötä staattinen arvo tai aseta muuttuja

   

Parhaat käytännöt

Skeeman suunnittelu

• Käytä kuvailevia X-otsikon nimiä, jotka selkeästi ilmaisevat niiden tarkoituksen.

• Pidä JSON-skeema ajan tasalla, kun X-otsikkovaatimukset muuttuvat.

• Dokumentoi X-header-skeemasi tiimin viitteitä ja vianetsintää varten.

Muuttujien hallinta

• Käytä globaaleja muuttujia X-otsikon datalle, johon täytyy päästä käsiksi eri aiheiden välillä.

• Valitse merkitykselliset muuttujien nimet (esimerkiksi IncomingSIPXHeaders tai CustomerXHeaders).

• Aloita muuttujat keskustelun alkuvaiheessa.

Virheenkäsittely

• Tarkista aina X-otsikon läsnäolo ennen kuin käytät arvoja logiikassa.

• Ota käyttöön varasuunnitelma puuttuville tai virheellisille X-otsikoiden datalle.

• Testaa huolellisesti erilaisilla X-header-skenaarioilla.

Suorituskykyyn liittyviä huomioita

• Käsittele X-otsikot aikaisessa vaiheessa keskustelun kulkua.

• Välimuistissa käytetään usein arvoja erillisinä muuttujina tarvittaessa.

• Vältä saman kanavadatan toistuvaa jäsentämistä.

Yleisiä ongelmia saapuvissa X-otsikoissa

X-otsikon arvoja ei vastaanotettu

• Varmista, että JSON-skeema vastaa tarkasti odotettuja X-otsikoiden nimiä.

• Tarkista, että Parse Value -solmu on konfiguroitu .Conversation.SipXHeader

• Varmista, että muuttuja on asetettu globaaliksi laajuudeksi, jos sitä käytetään useista aiheista.

• Varmista, että odotetaan enintään viisi X-otsikkoa, ja X-otsikot ovat ulkoisen järjestelmän lähettämät viisi parasta X-otsikota.

Tyhjät tai nollat X-otsikon arvot

• Varmista, että ulkoinen järjestelmä lähettää X-otsikoita odotetuilla nimillä.

• Varmista, että JSON-skeema sisältää kaikki vaaditut X-otsikon nimet pienellä x- etuliitteellä.

Yleisiä ongelmia liittyen lähteviin X-otsikoihin

X-otsikot, joita ei lähetetty siirron aikana

• Varmista, että kaikki X-otsikon nimet alkavat tai X-x-.

• Varmista, että siirtotyyppi on asetettu Ulkoisen puhelinnumeron siirtoon.

• Varmista, että X-otsikon arvot on määritetty oikein ennen Siirto-keskustelusolmua .

Siirto epäonnistuu X-otsikoilla

• Varmista, että X-otsikon nimet ja arvot eivät ylitä pituusrajoja.

• Varmista, että vastaanottojärjestelmä pystyy käsittelemään lähetettävät X-otsikot.

• Tarkista erikoishahmoja, jotka voivat aiheuttaa jäsennysongelmia.

Skeeman hallinta

X-otsikkoskeeman päivittäminen

• Uusien X-otsikoiden vastaanottamiseksi päivitä JSON-näyte Define JSON -skeemassa X-otsikoille.

• Vahvista ja tallenna päivitetty skeema.

• Testaa skeemaa uudella X-header-kokoonpanolla.