Del via

getAgentTilgængelighed

Omnikanal til Customer Service tilbyder en række funktioner, der kan udvide styrken i Dynamics 365 Customer Service Enterprise til at gøre det muligt for organisationer at oprette umiddelbar forbindelse og kommunikere med deres kunder på tværs af digitale meddelelseskanaler. Der skal bruges en ekstra licens for at få adgang til Omnikanal til Customer Service. Du kan finde flere oplysninger på siderne Dynamics 365 Customer Service-prisoversigt og Dynamics 365 Customer Service-prissætningsplan.

Henter helpdesk-medarbejderens tilgængelighed for en kø baseret på rutereglerne. Omnikanal-udvikleren kan bruge denne API til at bestemme, om indstillingen Start samtale skal være synlig for kunden, og også til at vise oplysninger som ventetid og placering i køer.

Notat

  • Lyt efter lcw:ready-begivenheden , der udløses af en livechat, før du kalder SDK-metoderne til livechat. Live chat-metoderne kan påberåbes, efter at lcw:ready-begivenheden er udløst. Du kan lytte efter denne begivenhed ved at tilføje din egen begivenhedslytter til vinduesobjektet.
  • Denne metode kan kaldes flere gange fra klientsiden, når kundeinput ændres. Cachen på klientsiden opdateres hvert 2. minut, eller når parametrene for kundekonteksten ændres.
  • Denne metode kan kun kaldes 100 gange i minuttet pr. organisation. Hvis du overskrider grænsen, vises http 429-svarstatuskoden, der angiver, at du har sendt for mange anmodninger inden for et bestemt tidsrum.

Syntaks

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

Parametre

None

Returværdi

Navn Type Beskrivende tekst
queueId String Den destinationskø, hvor anmodningen distribueres baseret på konfiguration af ruteregel og inputdata (værdien af objektet og konteksten, som er en del af rutereglen, angives).
isQueueAvailable Boolean Viser:
- SAND, hvis køen er inden for åbningstiden.
- FALSK, hvis køen er uden for åbningstiden.
StartTimeOfNextOperatingHour DateTime Starttidspunktet (UTC) for åbningstiden for køen, hvis det er uden for åbningstiden. I driftstiden returneres en værdi på 01-01-0001.
EndTimeOfNextOperatingHour DateTime Det tidspunkt (UTC), hvor åbningstiden slutter for køen, hvis det er uden for åbningstiden. I driftstiden returneres en værdi på 01-01-0001.
nexttransitiontime DateTime Det tidspunkt (UTC), hvor køen er i drift igen, hvis det er uden for åbningstiden. Det tidspunkt, hvor køen ikke er i drift, vises i åbningstiden.
positionInQueue Nummer Positionen i kø for en kunde, der venter bag andre kunder i samme kø.
isAgentAvailable Boolean Viser:
- SAND, hvis helpdesk-medarbejdere i køen i øjeblikket er tilgængelige til at modtage anmodninger baseret på konfigurerede rute- og tildelingsregler for arbejdsstrømmen. API'en returnerer også sand, hvis en robot er knyttet til arbejdsstrømmen eller en kø. Vi anbefaler, at denne API ikke bruges, når der er en bot til stede.
- FALSK, hvis agenter ikke er tilgængelige til at tage imod anmodninger.
averageWaitTime Nummer Gennemsnitlig ventetid i minutter for kunder i destinationskøen baseret på data fra de seneste 48 timer.

Eksempel

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

Overfør brugerdefinerede kontekstværdier for funktionen for at sikre, at konteksten modtages

Denne metode udfører et internt kald til funktionen setContextProvider og kalder derefter getAgentAvailability synkront for at sikre, at konteksten er angivet, før du fortsætter. På grund af funktionernes asynkrone karakter, når de bruges separat, er konteksten muligvis ikke klar, når konsulentagenten er tilgængelig.

Notat

Du behøver ikke at kalde metoden setContextProvider, før du kalder getAgentAvailability.

Her er en eksempelkode, der viser, hvordan du bruger setContextProvider 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
Reference til SDK for live-chat

  • Last updated on