Condividi tramite

getConversations

Multicanale per Customer Service offre una suite di funzionalità che estendono le funzionalità avanzate di Dynamics 365 Customer Service Enterprise per consentire alle organizzazioni di connettersi e interagire immediatamente con i clienti attraverso i canali di messaggistica digitale. È necessaria una licenza aggiuntiva per accedere a Multicanale per Customer Service. Per altre informazioni, vedere le pagine Panoramica dei prezzi di Dynamics 365 Customer Service e Piano tariffario di Dynamics 365 Customer Service.

Questa funzione può essere utilizzata per recuperare un elenco di record di conversazione (msdyn_ocliveworkitem) per un agente.

Sintassi

Microsoft.Omnichannel.getConversations(input, correlationId);

Parametri

Parametro TIPO Description
ingresso String Input JSON. Ha il seguente formato:
{attributes, agentID, status, orderBy, createdBeforeDays}
dove:
  • attributesè un array di stringhe contenenti i nomi degli attributi dell'entità
  • agentId è una stringa contenente un identificatore univoco per l'agente
  • status è un array di stringhe con valori separati da virgole
  • orderBy è un array di oggetti nel formato:
    [{ attributeName: "<Attribute_Name>" descending:<Booleano>}]
  • createdBeforeDaysè il numero di giorni trascorsi dalla creazione della conversazione

È agentId l'unica variabile di input richiesta e il resto è facoltativo.
correlationId String Optional. Identificatore univoco per la registrazione dei dati di telemetria.

Valore restituito

Restituisce una promessa risolta o rifiutata in base al risultato dell'operazione.

Annotazioni

Anche se il chiamante non passa alcun attributo nell'input, la funzione restituisce i record con gli attributi predefiniti seguenti:

  • msdyn_ocliveworkitemid
  • msdyn_liveworkstreamid
  • msdyn_lastsessionid
  • Codice di stato
  • Creato il

Example

Il frammento di codice seguente recupera la conversazione attualmente in attesa per l'ID agente specificato.

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

Riferimento SDK Live Chat
Informazioni di riferimento sull'API JavaScript multicanale
getConversationId
linkToConversation
unlinkFromConversation
openConversation
sendMessageToConversation

  • Last updated on