Compartir vía


getConversations

La Plataforma omnicanal para Customer Service ofrece un conjunto de funciones que extienden la potencia de Dynamics 365 Customer Service Enterprise con el que las organizaciones pueden conectarse e interactuar de forma instantánea con sus clientes en distintos canales de mensajería digital. Se necesitan una licencia adicional para acceder a la Plataforma omnicanal para Customer Service. Para más información, consulte las páginas Descripción general de precios de Dynamics 365 Customer Service y Plan de precios de Dynamics 365 Customer Service.

Esta función se puede utilizar para obtener una lista de registros de conversación (msdyn_ocliveworkitem) para un agente.

Syntax

Microsoft.Omnichannel.getConversations(input, correlationId);

Parámetros

Parámetro Tipo Description
entrada String Entrada JSON. Tiene el siguiente formato:
{attributes, agentID, status, orderBy, createdBeforeDays}
donde:
  • attributeses una matriz de cadenas que contienen nombres de atributos de entidad
  • agentId es una cadena que contiene un identificador único para el agente
  • status es una matriz de cadenas con valores separados por comas
  • orderBy es una matriz de objetos en el formato:
    [{ attributeName: "<Attribute_Name>" descending:<Booleano>}]
  • createdBeforeDayses el número de días transcurridos desde que se creó la conversación

Es agentId la única variable de entrada requerida y el resto son opcionales.
correlationId String Optional. Identificador único para el registro de telemetría.

Valor devuelto

Devuelve una promesa resuelta o rechazada en función del resultado de la operación.

Nota:

Incluso si el autor de la llamada no pasa ningún atributo en la entrada, la función devuelve los registros con los siguientes atributos predeterminados:

  • msdyn_ocliveworkitemid
  • msdyn_liveworkstreamid
  • msdyn_lastsessionid
  • Código de estado
  • CreadoOn

Example

El siguiente fragmento de código recupera la conversación en espera para el ID de agente dado.

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); 
    }
);

Referencia de las SDK de chat activo
Referencia de la API de JavaScript omnicanal
getConversationId
linkToConversation
desvincularDesdeConversación
openConversation
enviarMensajeToConversación