Compartilhar via


getConversations

O Omnichannel for Customer Service oferece um conjunto de recursos que ampliam o poder do Dynamics 365 Customer Service Enterprise para permitir que as organizações se conectem e interajam instantaneamente com clientes em canais de mensagens digitais. É necessária uma licença adicional para acessar o Omnichannel for Customer Service. Para obter mais informações, consulte as páginas Visão geral de preços do Dynamics 365 Customer Service e Plano de preços do Dynamics 365 Customer Service.

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

Sintaxe

Microsoft.Omnichannel.getConversations(input, correlationId);

Parâmetros

Parâmetro Tipo Description
entrada String Entrada JSON. Tem o seguinte formato:
{attributes, agentID, status, orderBy, createdBeforeDays}
em que:
  • attributesé uma matriz de strings contendo nomes de atributos de entidade
  • agentId é uma cadeia de caracteres que contém o identificador exclusivo do agente
  • status é uma matriz de strings com valores separados por vírgula
  • orderBy é uma matriz de objetos no formato:
    [{ attributeName: "<Attribute_Name>" descending:<Booleano>}]
  • 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 String Optional. Identificador exclusivo para log 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
  • Criado em

Example

O snippet de código a seguir busca a conversa em espera no momento para a ID do agente fornecida.

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 de SDK do chat ao vivo
Referência da API JavaScript do Omnicanal
getConversationId
linkToConversation
unlinkFromConversation
openConversation
sendMessageToConversation