Partage via


getConversations

Omnicanal pour Customer Service contient une suite de capacités qui étendent la puissance de Dynamics 365 Customer Service Enterprise pour permettre aux organisations de se connecter et d’interagir instantanément avec leurs clients sur les canaux de messagerie numérique. Une licence supplémentaire est requise pour accéder à Omnichannel pour Customer Service. Pour plus d’informations, voir les pages Vue d’ensemble de la tarification de Dynamics 365 Customer Service et Plan de tarification de Dynamics 365 Customer Service.

Cette fonction peut être utilisée pour récupérer une liste d’enregistrements de conversation (msdyn_ocliveworkitem) pour un agent.

Syntaxe

Microsoft.Omnichannel.getConversations(input, correlationId);

Paramètres

Paramètre Type Descriptif
saisie Chaîne Entrée JSON. Il a le format suivant :
{attributes, agentID, status, orderBy, createdBeforeDays}
où :
  • attributesest un tableau de chaînes contenant des noms d’attributs d’entité
  • agentId est une chaîne contenant l’identificateur unique de l’agent
  • status est un tableau de chaînes de caractères avec des valeurs séparées par des virgules
  • orderBy est un tableau d’objets au format :
    [{ attributeName: « <Attribute_Name> » descending:<booléen>}]
  • createdBeforeDaysest le nombre de jours écoulés depuis la création de la conversation

C’est agentId la seule variable d’entrée obligatoire et les autres sont facultatives.
correlationId Chaîne Optional. Identificateur unique pour la journalisation des données de télémétrie.

Valeur retournée

Renvoie une promesse résolue ou rejetée en fonction du résultat de l’opération.

Note

Même si l’appelant ne transmet aucun attribut dans l’entrée, la fonction renvoie les enregistrements avec les attributs par défaut suivants :

  • msdyn_ocliveworkitemid
  • msdyn_liveworkstreamid
  • msdyn_lastsessionid
  • StatusCode
  • CreatedOn

Example

L’extrait de code suivant récupère la conversation en attente de l’ID d’agent donné.

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

Référence du SDK de conversation instantanée en direct
Référence de l’API JavaScript omnicanale
getConversationId
linkToConversation
unlinkFromConversation
openConversation
sendMessageToConversation