Del via

getAgentTilgjengelighet

Omnikanal for Customer Service har en rekke funksjoner som utvider kraften i Dynamics 365 Customer Service Enterprise, slik at organisasjoner kan koble seg til og komme i kontakt med kundene på tvers av digitale meldingskanaler. En tilleggslisens kreves for å få tilgang til Omnikanal for Customer Service. Hvis du vil ha mer informasjon, kan du se sidene Prisoversikt for Dynamics 365 Customer Service og Prisplan for Dynamics 365 Customer Service.

Henter agenttilgjengeligheten for en kø basert på rutingsreglene. Omnikanalutvikleren kan bruke denne API-en til å avgjøre om alternativet for å starte samtale skal være synlig for kunden, og også for å vise informasjon som ventetid og plassering i køer.

Note

  • Lytt etter lcw:ready-hendelsen som skapes av en live chat før du kaller SDK-metodene for live chat. Live chat-metodene kan startes etter at lcw:ready-hendelsen er utløst. Du kan lytte etter denne hendelsen ved å legge til din egen hendelseslytter på vindusobjektet.
  • Denne metoden kan kalles flere ganger fra klientsiden når kundeinndata endres. Hurtigbufferen på klientsiden oppdateres hvert 2.
  • Denne metoden kan bare kalles 100 ganger per minutt per organisasjon. Hvis du overskrider grensen, ser du http 429-svarstatuskoden som indikerer at du sendte for mange forespørsler i løpet av en angitt tidsperiode.

Syntaks

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

Parametere

None

Returverdi

Navn Type Description
queueId String Målkøen der forespørselen rutes basert på rutingsregelkonfigurasjon og inndata (verdien for enhet og kontekst som er en del av rutingsregelen er angitt).
isQueueAvailable boolsk Viser:
- TRUE hvis køen er innenfor åpningstiden.
- FALSE hvis køen er utenfor åpningstiden.
StartTimeOfNextOperatingHour DateTime Starttidspunktet (UTC) for åpningstidene for køen hvis det er utenfor åpningstidene. I løpet av driftstiden returneres en verdi på 01-01-0001.
EndTimeOfNextOperatingHour DateTime Tidspunktet (UTC) når åpningstiden slutter for køen hvis det er utenfor åpningstiden. I løpet av driftstiden returneres en verdi på 01-01-0001.
nexttransitiontime DateTime Tidspunktet (UTC) når køen er i drift igjen hvis den er utenfor åpningstiden. Tidspunktet da køen ikke er i drift, vises i åpningstiden.
positionInQueue Nummer Posisjonen i kø for en kunde som venter bak andre kunder i samme kø.
isAgentAvailable boolsk Viser:
- SANN hvis agenter i køen for øyeblikket er tilgjengelige for å ta imot forespørsler basert på konfigurerte rutings- og tilordningsregler for arbeidsflyten. API-en returnerer også sann hvis en robot er knyttet til arbeidsflyten eller en kø. Vi anbefaler at denne API-en ikke brukes når en robot er til stede.
- FALSE hvis agenter ikke er tilgjengelige for å ta imot forespørsler.
averageWaitTime Nummer Gjennomsnittlig ventetid i minutter for kunder i målkøen basert på data fra de siste 48 timene.

Eksempel

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

Send egendefinerte kontekstverdier for funksjonen for å sikre at kontekst mottas

Denne metoden utfører et internt kall til setContextProvider-funksjonen og kaller deretter getAgentAvailability synkront for å sikre at konteksten er angitt før du fortsetter. På grunn av den asynkrone naturen til funksjonene når de brukes separat, kan det hende at konteksten ikke er klar når konsulentagenten er tilgjengelig.

Note

Du trenger ikke å kalle setContextProvider-metoden før du kaller getAgentAvailability.

Her er en eksempelkode som viser hvordan du setContextProvider bruker metoden.

// 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}

        }

    }

    );

startChat
setContextProvider
SDK-referanse for direkte chat

  • Last updated on