getAgentAvailability

La Plataforma omnicanal per al Customer Service ofereix un conjunt de capacitats que amplien el potencial del Dynamics 365 Customer Service Enterprise per permetre a les organitzacions connectar-se i interactuar de manera immediata amb els seus clients a través de canals de missatgeria digital. Cal una llicència addicional per accedir a la Plataforma omnicanal per al Customer Service. Per obtenir més informació, vegeu les pàgines Informació general del Dynamics 365 Customer Service i Pla de preus del Dynamics 365 Customer Service .

Recupera la disponibilitat de l'agent per a una cua en funció de les regles d'encaminament. El desenvolupador omnicanal pot utilitzar aquesta API per determinar si l'opció d'inici de conversa ha de ser visible per al client i també per mostrar informació com el temps d'espera i la posició a les cues.

Nota

  • Escolteu l'esdeveniment lcw:ready generat per un xat en directe abans de trucar als mètodes de l'SDK de xat en directe. Els mètodes de xat en directe es poden invocar després que s'aixequi l'esdeveniment lcw:ready . Podeu escoltar aquest esdeveniment afegint el vostre propi oient d'esdeveniments a l'objecte window.
  • Aquest mètode es pot cridar diverses vegades des del costat del client quan canvia l'entrada del client. La memòria cau del costat del client s'actualitza cada 2 minuts o quan canvien els paràmetres de context del client.
  • Aquest mètode només es pot trucar 100 vegades per minut per organització. Si supereu el límit, veureu el codi d'estat de resposta http 429 que indica que heu enviat massa sol·licituds en un període de temps especificat.

Sintaxi

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

Paràmetres

Cap

Valor retornat

Nom Type Descripció
queueId Corda La cua de destinació on s'encamina la sol·licitud en funció de la configuració de la regla d'encaminament i les dades d'entrada (es proporciona el valor de l'entitat i el context que formen part de la regla d'encaminament).
isQueueAvailable booleà Mostra:
- TRUE si la cua està dins de l'horari de funcionament.
- FALS si la cua està fora de l'horari d'obertura.
StartTimeOfNextOperatingHour DataHora L'hora d'inici (UTC) de l'horari de funcionament de la cua si és fora de l'horari d'obertura. Durant l'horari de funcionament, es retorna un valor de 01-01-0001.
EndTimeOfNextOperatingHour DataHora L'hora (UTC) en què finalitza l'horari de funcionament de la cua si és fora de l'horari d'obertura. Durant l'horari de funcionament, es retorna un valor de 01-01-0001.
nexttransitiontime DataHora L'hora (UTC) en què la cua torna a estar operativa si està fora de l'horari d'obertura. L'hora en què la cua no està operativa es mostra durant l'horari d'obertura.
positionInQueue Nombre La posició a la cua d'un client que espera darrere d'altres clients de la mateixa cua.
isAgentAvailable booleà Mostra:
- TRUE si els agents de la cua estan disponibles per acceptar sol·licituds basades en les regles d'encaminament i assignació configurades per a la seqüència de treball. L'API també retorna true si un bot està connectat a la seqüència de treball o a una cua. Recomanem que no s'utilitzi aquesta API quan hi hagi un bot.
- FALSE si els agents no estan disponibles per acceptar sol·licituds.
averageWaitTime Nombre Temps d'espera mitjà en minuts per als clients de la cua de destinació en funció de les dades de les últimes 48 hores.

Exemple

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

Passar valors de context personalitzats per a la funció per assegurar-se que es rep el context

Aquest mètode realitza una crida interna a la funció setContextProvider i, a continuació, crida getAgentAvailability de manera sincrònica, per assegurar-se que el context està definit abans de continuar. A causa de la naturalesa asíncrona de les funcions quan s'utilitzen per separat, és possible que el context no estigui llest quan l'agent de consultoria estigui disponible.

Nota

No cal que crideu el mètode setContextProvider abans de cridar getAgentAvailability.

Aquí teniu un codi d'exemple que mostra com utilitzar el setContextProvider mètode.

// 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':'mae.gibbins@contoso.com','isDisplayable':true},

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

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

        }

    }

    );

startChat
setContextProvider
Referència de l'SDK de xat en directe

  • Last updated on