Jaa


getAgentAvailability

Customer Servicen monikanava sisältää Dynamics 365 Customer Service Enterprisea laajentavia ominaisuuksia, joiden avulla organisaatiot voivat ottaa hetkessä yhteyttä asiakkaisiin ja olla heidän kanssaan vuorovaikutuksessa digitaalisten viestikanavien kautta. Customer Servicen monikanava edellyttää lisäkäyttöoikeuden. Lisätietoja on Dynamics 365 Customer Servicen hinnoittelun yleiskatsaus- ja Dynamics 365 Customer Servicen hinnoittelusuunnitelma -sivuilla.

Noutaa jonon asiakaspalvelijan käytettävyyden reitityssääntöjen perusteella. Monikanavan kehittäjä voi käyttää tätä ohjelmointirajapintaa määrittääkseen, näkyykö Aloita keskustelu -vaihtoehdon asiakkaalle, ja myös näyttääkseen tietoja, kuten odotusajan ja sijainnin jonoissa.

Note

  • Kuuntele live-chatin nostamaa lcw:ready-tapahtumaa , ennen kuin kutsut live-chat SDK -menetelmiä. Live-chat-menetelmät voidaan käynnistää lcw:ready-tapahtuman nostamisen jälkeen. Voit kuunnella tätä tapahtumaa lisäämällä oman tapahtuman kuuntelijan ikkunaobjektiin.
  • Tätä menetelmää voidaan kutsua useita kertoja asiakaspuolelta, kun asiakkaan syöte muuttuu. Asiakaspuolen välimuisti päivitetään 2 minuutin välein tai kun asiakaskontekstin parametrit muuttuvat.
  • Tätä menetelmää voidaan kutsua 100 kertaa minuutissa vain organisaatiota kohti. Jos ylität rajan, näet http 429 -vastauksen tilakoodin, joka ilmaisee, että olet lähettänyt liian monta pyyntöä tietyssä ajassa.

Syntaksi

Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability();

Parametrit

None

Palautusarvo

Nimi Type Description
queueId String Kohdejono, johon pyyntö reititetään reitityssäännön määrityksen ja syötetietojen perusteella (annetaan entiteetin arvo ja konteksti, jotka ovat osa reitityssääntöä).
isQueueAvailable totuusarvo Näyttää:
- TOSI, jos jono on aukioloaikojen sisällä.
- EPÄTOSI, jos jono on aukioloaikojen ulkopuolella.
StartTimeOfNextOperatingHour Päivämäärä ja aika Jonon käyttötuntien alkamisaika (UTC), jos se on aukioloaikojen ulkopuolella. Käyttöaikana palautetaan arvo 01-01-0001.
EndTimeOfNextOperatingHour Päivämäärä ja aika Aika (UTC), jolloin jonon aukioloajat päättyvät, jos se on aukioloaikojen ulkopuolella. Käyttöaikana palautetaan arvo 01-01-0001.
nexttransitiontime Päivämäärä ja aika Aika (UTC), jolloin jono on jälleen toiminnassa, jos se on aukioloaikojen ulkopuolella. Aika, jolloin jono ei ole toiminnassa, näytetään aukioloaikoina.
positionInQueue Number Jonopaikka asiakkaalle, joka odottaa muiden samassa jonossa olevien asiakkaiden takana.
isAgentAvailable totuusarvo Näyttää:
- TOSI, jos jonossa olevat asiakaspalvelijat ovat tällä hetkellä käytettävissä vastaanottamaan pyyntöjä työnkulun määritettyjen reititys- ja määrityssääntöjen perusteella. Ohjelmointirajapinta palauttaa arvon tosi myös, jos botti on liitetty työnkulkuun tai jonoon. Suosittelemme, että tätä ohjelmointirajapintaa ei käytetä, kun botti on läsnä.
- EPÄTOSI, jos agentit eivät ole käytettävissä vastaanottamaan pyyntöjä.
averageWaitTime Number Keskimääräinen odotusaika minuutteina kohdejonossa oleville asiakkaille viimeisten 48 tunnin tietojen perusteella.

Esimerkki

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
               // Gets the agent availability
               Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability();
});

Välitä funktion mukautetut kontekstiarvot varmistaaksesi, että konteksti vastaanotetaan

Tämä menetelmä suorittaa sisäisen kutsun setContextProvider-funktioon ja kutsuu sitten getAgentAvailability-funktiota synkronisesti varmistaakseen, että konteksti on määritetty ennen jatkamista. Koska funktiot ovat asynkronisia, kun niitä käytetään erikseen, konteksti ei ehkä ole valmis, kun konsulttiasiakaspalvelija on käytettävissä.

Note

Sinun ei tarvitse kutsua setContextProvider-menetelmää ennen getAgentAvailability-kutsua.

Tässä on esimerkkikoodi, joka näyttää, miten menetelmää setContextProvider käytetään.

// To set the custom context, pass the custom context object as input parameter to agent availability

    // provider as part of the logic, so there is no need to set custom context before this call.

    Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability({

        customContext : {

                'jwtToken': {'value':'token','isDisplayable':true},

                'Email': {'value':'test@test.com','isDisplayable':true},

                'client': {'value':'true','isDisplayable':true},

                'Emailing': {'value':'true','isDisplayable':true}

        }

    }

    );

käynnistä Chat
setContextProvider
Reaaliaikaisen keskustelun SDK-viite