Partilhar via

getConversas

A aplicação Omnicanal para Customer Service oferece um conjunto de capacidades que expande o poder do Dynamics 365 Customer Service Enterprise para permitir que as organizações se liguem e participem instantaneamente com os clientes através de canais de mensagens digitais. É necessária uma licença adicional para aceder ao Omnicanal para Customer Service. Para mais informações, consulte as páginas Descrição geral dos preços do Dynamics 365 Customer Service e Plano de preços do Dynamics 365 Customer Service.

Esta função pode ser usada para buscar uma lista de registros de conversação (msdyn_ocliveworkitem) para um agente.

Sintaxe

Microsoft.Omnichannel.getConversations(input, correlationId);

Parâmetros

Parâmetro Tipo Description
dados introduzidos Cordão Entrada JSON. Tem o seguinte formato:
{attributes, agentID, status, orderBy, createdBeforeDays}
em que:
  • attributesé uma matriz de cadeias de caracteres que contém nomes de atributos de entidade
  • agentId é uma cadeia de caracteres que contém identificador exclusivo para o agente
  • status é uma matriz de cadeias de caracteres com valores separados por vírgulas
  • orderBy é uma matriz de objetos no formato:
    [{ attributeName: "<Attribute_Name>" descending:<Boolean>}]
  • createdBeforeDaysé o número de dias desde que a conversa foi criada

A agentId é a única variável de entrada necessária e o resto é opcional.
correlationId Cordão Opcional. Identificador exclusivo para registro de telemetria.

Valor de retorno

Retorna uma promessa resolvida ou rejeitada com base no resultado da operação.

Observação

Mesmo que o chamador não passe nenhum atributo na entrada, a função retorna os registros com os seguintes atributos padrão:

  • msdyn_ocliveworkitemid
  • msdyn_liveworkstreamid
  • msdyn_lastsessionid
  • Código de status
  • CriadoemOn

Example

O trecho de código a seguir busca a conversa atualmente aguardando o ID do agente fornecido.

var input = { 
    "attributes": [
        "msdyn_title",
        "msdyn_channel"
        ],
    "agentId": "2b330c52-6844-4d36-8e05-03c78c9681dc",
    "status": [3], 
    "orderBy": [
        { 
            "attributeName": "createdon",
            "descending": true
        }
    ]
};
Microsoft.Omnichannel.getConversations(input).then(result => {
    console.log("result is as:", result); 
    }, (error) => {
        console.log("error is as:", error); 
    }
);

Referência SDK do chat em direto
Referência da API JavaScript omnichannel
getConversationId
linkToConversation
desvincularFromConversation
abrirConversação
sendMessageToConversation

  • Last updated on