Referència de l'SDK de xat en directe

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 .

Els mètodes JavaScript següents es poden utilitzar per fer diverses operacions amb el giny de xat en directe de l'Omnicanal per al Customer Service.

Mètodes

Mètode	Descripció
setContextProvider	Defineix el proveïdor de context per als canals de xat en directe. La funció proveïdor de context, quan s'invoca, retorna el context que s'utilitzarà per inicialitzar una sessió de xat.
getContextProvider	Recupera el proveïdor de context personalitzat establert actualment, si n'hi ha.
removeContextProvider	Suprimeix el proveïdor de context personalitzat establert actualment, si n'hi ha.
setAuthTokenProvider	Defineix el proveïdor de testimonis d'autenticació.
getAuthTokenProvider	Obté el proveïdor de testimonis d'autenticació establert actualment, si n'hi ha.
removeAuthTokenProvider	Suprimeix el proveïdor de testimonis d'autenticació establert actualment, si n'hi ha.
startChat	Obre un xat existent, si n'hi ha. En cas contrari, s'inicia un nou xat. Podeu utilitzar el customContext paràmetre del mètode per passar directament el context per inicialitzar la sessió de xat
startProactiveChat	Permet a les organitzacions interactuar amb els usuaris convidant-los automàticament a una conversa de xat en funció de les regles configurades.
closeChat	Finalitza la conversa entre l'agent i el client. També s'elimina la memòria cau del navegador relacionada amb la conversa.
getAgentAvailability	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.

Esdeveniments

Esdeveniment	Descripció
lcw:ready	Aquest esdeveniment es genera quan l'SDK del xat en directe està llest per utilitzar-se.
lcw:error	Aquest esdeveniment es genera en cas que es produeixi un error durant la vida útil d'un xat. Per obtenir informació sobre els codis d'error i els missatges d'error, vegeu la Referència de codis d'error per a l'Omnicanal per al Customer Service.
lcw:startChat	Aquest esdeveniment s'activa quan s'inicia un xat.
lcw:closeChat	Aquest esdeveniment s'activa quan es tanca un xat.
lcw:chatQueued	Aquest esdeveniment es genera quan es crea i s'inicia la conversa de xat.
lcw:chatRetrieved	Aquest esdeveniment es genera quan el sistema recupera una conversa de xat en curs de la memòria cau després de tornar a carregar o obrir una pàgina en una altra pestanya.
lcw:onClose	Aquest esdeveniment s'activa quan el client que interacciona amb el giny de xat tanca el giny.
lcw:onMinimize	Aquest esdeveniment s'activa quan el client interacciona amb el giny de xat minimitza el giny.
lcw:onMaximize	Aquest esdeveniment s'activa quan el client interacciona amb el giny de xat maximitza el giny.
lcw:onMessageReceived	Aquest esdeveniment s'activa quan el giny de xat rep un missatge nou.
lcw:onMessageSent	Aquest esdeveniment s'activa quan un client que interacciona amb el giny de xat envia un missatge nou.
lcw:threadUpdate	Aquest esdeveniment es genera mitjançant el xat en directe quan un agent finalitza una conversa.
lcw:getAgentAvailability	Aquest esdeveniment es genera quan el getAgentAvailability mètode retorna una resposta correcta.

Informació relacionada

Omnicanal per al Customer Service per a desenvolupadors