Freigeben über

getConversations

Omnichannel for Customer Service bietet eine Reihe von Funktionalitäten, die die Möglichkeiten von Dynamics 365 Customer Service Enterprise erweitern und es Unternehmen ermöglichen, über digitale Nachrichtenkanäle sofort mit ihren Kunden in Kontakt zu treten und sich mit ihnen zu engagieren. Für den Zugriff auf Omnichannel for Customer Service ist eine zusätzliche Lizenz erforderlich. Weitere Informationen finden Sie auf den Seiten Dynamics 365 Customer Service Preisübersicht und Dynamics 365 Customer Service Preisplan.

Diese Funktion kann verwendet werden, um eine Liste von Konversationsdatensätzen (msdyn_ocliveworkitem) für einen Agenten abzurufen.

Syntax

Microsoft.Omnichannel.getConversations(input, correlationId);

Die Parameter

Parameter Typ Description
Eingabe String JSON-Eingabe. Er hat das folgende Format:
{attributes, agentID, status, orderBy, createdBeforeDays}
wobei:
  • attributesist ein Array von Zeichenfolgen, die Namen von Entitätsattributen enthalten.
  • agentId ist eine Zeichenfolge, die eine eindeutige Kennung für den Agenten enthält
  • status ist ein Array von Zeichenfolgen mit durch Trennzeichen getrennten Werten
  • orderBy ist ein Array von Objekten im Format:
    [{ attributeName: "<Attribute_Name>" descending:<Boolescher>}]
  • createdBeforeDaysist die Anzahl der Tage, seit die Konversation erstellt wurde.

Das agentId ist die einzige erforderliche Eingabevariable, der Rest ist optional.
correlationId String Wahlfrei. Eindeutiger Bezeichner für die Telemetrieprotokollierung.

Rückgabewert

Gibt eine aufgelöste oder abgelehnte Zusage basierend auf dem Ergebnis des Vorgangs zurück.

Hinweis

Auch wenn der Aufrufer keine Attribute in der Eingabe übergibt, gibt die Funktion die Datensätze mit den folgenden Standardattributen zurück:

  • msdyn_ocliveworkitemid
  • msdyn_liveworkstreamid
  • msdyn_lastsessionid
  • Statuscode
  • CreatedOn

Example

Der folgende Codeausschnitt ruft die aktuell wartende Konversation für die angegebene Agent-ID ab.

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

Livechat SDK Referenz
Referenz zur Omnichannel-JavaScript-API
getConversationId
linkToConversation
unlinkFromConversation
openKonversation
sendMessageToConversation

  • Last updated on