getAgentAvailability

Multicanle para Customer Service ofrece un conxunto de capacidades que amplían o poder de Dynamics 365 Customer Service Enterprise para permitir ás organizacións conectarse instantáneamente e interactuar cos seus clientes a través de canles como o chat en directo e SMS. Requírese unha licenza adicional para acceder á Multicanle para Customer Service. Para obter máis información, consulte as páxinas Visión xeral dos prezos de Dynamics 365 Customer Service e Plan de prezos de Dynamics 365 Customer Service .

Recupera a dispoñibilidade do axente para unha cola en función das regras de enrutamento. O desenvolvedor omnicanal pode usar esta API para determinar se a opción de inicio da conversa debe ser visible para o cliente e tamén para mostrar información como o tempo de espera e a posición nas colas.

Nota

  • Escoita o evento lcw:ready suscitado por un chat en directo antes de chamar aos métodos SDK de chat en directo. Os métodos de chat en directo pódense invocar despois de que se levante o evento lcw:ready . Pode escoitar este evento engadindo o seu propio oínte de eventos no obxecto da xanela.
  • Este método pode ser chamado varias veces desde o lado do cliente cando a entrada do cliente cambia. A caché do lado do cliente actualízase cada 2 minutos ou cando cambian os parámetros do contexto do cliente.
  • Este método só se pode chamar 100 veces por minuto por organización. Se supera o límite, verá o código de estado de resposta http 429 que indica que enviou demasiadas solicitudes nun período de tempo específico.

Sintaxe

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

Parámetros

Nada

Valor de devolución

Nome Type Descripción
queueId Cadea A cola de destino onde se encamiña a solicitude en función da configuración da regra de enrutamento e os datos de entrada (proporcionouse o valor da entidade e o contexto que forman parte da regra de enrutamento).
isQueueAvailable booleano Pantallas:
- TRUE se a cola está dentro do horario de funcionamento.
- FALSO se a cola está fóra do horario de funcionamento.
StartTimeOfNextOperatingHour DataHora A hora de inicio (UTC) do horario de funcionamento da cola se está fóra do horario de funcionamento. Durante o horario de funcionamento, devólvese un valor de 01-01-0001.
EndTimeOfNextOperatingHour DataHora A hora (UTC) na que remata o horario de funcionamento para a cola se está fóra do horario de funcionamento. Durante o horario de funcionamento, devólvese un valor de 01-01-0001.
nexttransitiontime DataHora A hora (UTC) na que a cola está operativa de novo se está fóra do horario de funcionamento. A hora na que a cola non está operativa móstrase durante o horario de funcionamento.
positionInQueue Número A posición en cola para un cliente que espera detrás doutros clientes na mesma cola.
isAgentAvailable booleano Pantallas:
- TRUE se os axentes na cola están actualmente dispoñibles para aceptar solicitudes baseadas en regras de enrutamento e asignación configuradas para o fluxo de traballo. A API tamén devolve true se un bot está unido ao fluxo de traballo ou a unha cola. Recoméndase que esta API non se utilice cando está presente un bot.
- FALSO se os axentes non están dispoñibles para aceptar solicitudes.
averageWaitTime Número Tempo medio de espera en minutos para os clientes na cola de destino baseado nos datos das últimas 48 horas.

Exemplo

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

Pasar valores de contexto personalizados para a función para asegurarse de que se recibe o contexto

Este método realiza unha chamada interna á función setContextProvider e, a continuación, chama a getAgentAvailability de forma sincrona, para asegurarse de que o contexto está establecido antes de continuar. Debido á natureza asíncrona das funcións cando se usan por separado, o contexto pode non estar listo cando o axente consultor estea dispoñible.

Nota

Non é necesario chamar ao método setContextProvider antes de chamar a getAgentAvailability.

Aquí tes unha mostra de código que mostra como usar o setContextProvider método.

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

        }

    }

    );

Iniciar Chat
setContextProvider
Referencia do SDK do chat en directo

  • Última actualización o