CCaaS_GetRepresentativeAvailabilityForConversation

Use a API CCaaS_GetRepresentativeAvailabilityForConversation para obter a fila e a disponibilidade do representante de serviço durante uma conversa ativa com um ID de conversa válido.

Por exemplo, quando um cliente que está a conversar com um agente IVR ou IA solicita escalonamento a um representante de serviço, o agente de IA liga a esta API para determinar a disponibilidade do representante de serviço e encaminhar a conversa com base na resposta.

Detalhes do pedido

URL

/\<orgurl\>/api/data/v9.2/CCaaS\_ GetRepresentativeAvailabilityForConversation

Método

POST

Versão

1.0

Cabeçalhos de solicitação

Nome Descrição
Authorization Obrigatório. Token portador do Microsoft Entra ID para o chamador da API na instância do Centro de Contacto. Saiba mais em Token de configuração para autorização de API

Corpo do pedido de amostra

Descrição Pedido de amostra
Determina a fila e a disponibilidade de representantes para uma conversa ativa. curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer token' \ --data '{ "ApiVersion": "1.0", "ConversationId": "2f2508bd-b58e-4982-b142-651e36dc8df3" }'
Determine a disponibilidade da fila e dos representantes para uma conversa onde as regras de rota para fila precisam de mais elementos de contexto. curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer token' \ --data '{ "ApiVersion": "1.0", "ConversationId": "cf21df54-6d64-4aea-b668-405b8aa42b07", "CustomContextItems": "{\"contextItem1\": {\"value\": \"contextItemValue1\", \"isDisplayable\": true, \"datatype\": \"DataType1\"}, \"contextItem2\": {\"value\": \"contextItemValue2\", \"isDisplayable\": true, \"datatype\": \"DataType2\"}}" }'
A regra aplica-se ao item de contexto Inquérito (tipo: Texto, valor: Índia) curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer <Token>' \ --header 'Content-Type: application/json' \ --data '{ "ApiVersion": "1.0", "ConversationId": "94c002c8-b14e-4a0e-8069-78dcf0d6c208", "CustomContextItems": "{\"Survey\": {\"value\": \"India\", \"isDisplayable\": true, \"datatype\": \"192350000\"}}" }'

Observação

  • No corpo do pedido, CustomContextItems é uma string com os elementos de contexto usados nas regras de rota para fila. A lista de exemplos de itens de contexto:

    {
  "contextItemName1": {
    "value": "contextItemValue1",
    "isDisplayable": true,
    "datatype": "DataType1"
  },
  "contextItemName2": {
    "value": "contextItemValue2",
    "isDisplayable": true,
    "datatype": "DataType2"
  }
}

  • isDisplayable indica se o elemento de contexto é exibido no ecrã. Este valor é Verdadeiro ou Falso.

  • datatype só pode ser Texto = 192350000 ou Inteiro = 192350001

Resposta

Se for bem-sucedido, este método devolve um código de resposta de 200 OK. O método também devolve os seguintes códigos de estado.

Estado HTTP Descrição
400 Pedido Mau (Parâmetros de entrada errados)
401 Não autorizado
404 Recurso não encontrado
429 Limite de taxa (pedidos a mais)
405 API não permitida
500 Erro interno do servidor

Valores de resposta

Nome Type Descrição
queueId String A fila alvo onde o pedido é encaminhado com base nas configurações das regras de encaminhamento e nos dados de entrada, como valores de entidades e contexto, que fazem parte da regra de encaminhamento.
isQueueDisponível booleano Mostra TRUE se a fila estiver dentro do horário de funcionamento. FALSE se a fila estiver fora do horário de funcionamento.
Hora de Início da Próxima Hora de Funcionamento DateTime A hora de início (UTC) do horário de funcionamento da fila, caso esta esteja atualmente fora do horário de funcionamento. Retorna a 01-01-0001 durante o horário de funcionamento.
Hora de Término da Próxima Operação DateTime A hora (UTC) em que o horário de funcionamento termina para a fila, caso esta esteja atualmente fora do horário de funcionamento. Retorna a 01-01-0001 durante o horário de funcionamento.
nextTransitionTime DateTime A hora (UTC) em que a fila está operacional novamente se estiver fora do horário de funcionamento. Durante o horário de funcionamento, aparece quando a fila deixa de funcionar.
positionInQueue Number Posição na fila para um cliente que está atrás de outros na mesma fila.
isAgentAvailable booleano Apresenta:
  • VERDADE se os representantes de serviço na fila estiverem atualmente disponíveis para receber pedidos com base nas regras de encaminhamento e atribuição do fluxo de trabalho.
  • FALSE se os representantes do serviço não estiverem disponíveis para aceitar pedidos.
TempoDeEspera Médio Number Tempo médio de espera em minutos para os clientes na fila alvo.
TempoDeEsperaMédioEmSegundos Números Tempo médio de espera em segundos para os clientes na fila alvo.
NúmeroDeEspecialistasDisponíveisNa Fila Números O número de representantes de atendimento atualmente disponíveis para aceitar conversas na fila específica.

Resposta de exemplo

{  
"@odata.context": "https://<org-url>/api/data/v9.2/\$metadata#Microsoft.Dynamics.CRM.CCaaS_GetRepresentativeAvailabilityForConversationResponse",  
"NextTransitionTime": "9999-12-31T23:59:59Z",
"NumberOfExpertsAvailableInQueue": 5,
"AverageWaitTimeInSeconds": 45  
"PositionInQueue": 1,  
"AverageWaitTime": null,  
"StartTimeOfNextOperatingHour": "0001-01-01T00:00:00Z",  
"EndTimeOfNextOperatingHour": "0001-01-01T00:00:00Z",  
"QueueId": "85e55877-f27a-e911-a81a-000d3a1ca610",  
"IsAgentAvailable": true,  
"IsQueueAvailable": true  
}

Utilizar APIs de disponibilidade representativa
CCaaS_GetRepresentativeAvailabilityBeforeConversation

  • Last updated on