DisponibilitàRappresentantePerConversazione_CCaaS

Usa l'API CCaaS_GetRepresentativeAvailabilityForConversation per ottenere la disponibilità della coda e dell'agente del servizio durante una conversazione attiva con un ID conversazione valido.

Ad esempio, quando un cliente che chatta con un agente IVR o AI richiede un'escalation a un rappresentante del servizio clienti, l'agente AI invoca questa API per determinare la disponibilità del rappresentante del servizio clienti e instradare la conversazione in base alla risposta.

Dettagli della richiesta

URL

/\<orgurl\>/api/data/v9.2/CCaaS\_ GetRepresentativeAvailabilityForConversation

Method

POST

Versione

1.0

Header di richiesta

Nome Descrizione
Authorization Obbligatorio. Microsoft Entra ID token di connessione per il chiamante API nell'istanza del Centro contatti. Per altre informazioni, vedere Configurare il token per l'autorizzazione API

Corpo della richiesta di esempio

Descrizione Esempio di richiesta
Verifica la disponibilità delle code e dei rappresentanti per una conversazione attiva. curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer token' \ --data '{ "ApiVersion": "1.0", "ConversationId": "2f2508bd-b58e-4982-b142-651e36dc8df3" }'
Determinare la disponibilità di code e rappresentanti in una conversazione in cui le regole route-to-queue necessitano di più elementi di contesto. curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer token' \ --data '{ "ApiVersion": "1.0", "ConversationId": "cf21df54-6d64-4aea-b668-405b8aa42b07", "CustomContextItems": "{\"contextItem1\": {\"value\": \"contextItemValue1\", \"isDisplayable\": true, \"datatype\": \"DataType1\"}, \"contextItem2\": {\"value\": \"contextItemValue2\", \"isDisplayable\": true, \"datatype\": \"DataType2\"}}" }'
La regola si trova nell'elemento di contesto Survey (tipo: Testo, valore: India) curl --request POST \ --url https://<org-url>/api/data/v9.2/CCaaS_GetRepresentativeAvailabilityForConversation \ --header 'Authorization: Bearer <Token>' \ --header 'Content-Type: application/json' \ --data '{ "ApiVersion": "1.0", "ConversationId": "94c002c8-b14e-4a0e-8069-78dcf0d6c208", "CustomContextItems": "{\"Survey\": {\"value\": \"India\", \"isDisplayable\": true, \"datatype\": \"192350000\"}}" }'

Annotazioni

  • Nel corpo della richiesta, CustomContextItems è presente una stringa con gli elementi di contesto usati nelle regole route-to-queue. Elenco di esempi di elementi di contesto:

    {
  "contextItemName1": {
    "value": "contextItemValue1",
    "isDisplayable": true,
    "datatype": "DataType1"
  },
  "contextItemName2": {
    "value": "contextItemValue2",
    "isDisplayable": true,
    "datatype": "DataType2"
  }
}

  • isDisplayable indica se l'elemento di contesto viene visualizzato sullo schermo. Questo valore è True o False.

  • datatype può essere solo Text = 192350000 o Integer = 192350001

risposta

In caso di esito positivo, questo metodo restituisce un codice di risposta 200 OK. Il metodo restituisce anche i codici di stato seguenti.

Stato HTTP Descrizione
400 Richiesta crollata (parametri di input errati)
401 Non autorizzata
404 Risorsa non trovata
429 Limite di frequenza (Troppe richieste)
405 API non consentita
500 Errore interno del server

Valori risposta

Nome Tipo Descrizione
queueId string Coda di destinazione in cui la richiesta viene instradata in base alle configurazioni delle regole di routing e ai dati di input, ad esempio valori di entità e contesto che fanno parte della regola di routing.
isQueueAvailable Booleano Visualizza TRUE se la coda è entro l'orario di funzionamento. FALSE se la coda è al di fuori dell'orario operativo.
OraInizioProssimaOraOperativa DateTime Ora di inizio (UTC) dell'orario di funzionamento per la coda se è attualmente al di fuori dell'orario operativo. Restituisce 01-01-0001 durante l'orario di funzionamento.
EndTimeOfNextOperatingHour (OraFineProssimaOraOperativa) DateTime Ora (UTC) alla fine dell'orario di funzionamento per la coda, se è attualmente al di fuori dell'orario operativo. Restituisce 01-01-0001 durante l'orario di funzionamento.
prossimotempotrasizione DateTime L'ora (UTC) in cui la coda è di nuovo operativa se è al di fuori dell'orario di apertura. Durante l'orario di funzionamento, visualizza quando la coda diventa non operativa.
positionInQueue Number Posizione in coda per un cliente in attesa di altri nella stessa coda.
isAgentAvailable Booleano Visualizza:
  • TRUE se gli operatori nella coda sono attualmente disponibili per accettare richieste in base alle regole di instradamento e assegnazione per il workstream.
  • FALSE se i rappresentanti del servizio non sono disponibili per accettare richieste.
tempo medio di attesa Number Tempo medio di attesa in minuti per i clienti nella coda di destinazione.
TempoMedioAttesaInSecondi Numeri Tempo medio di attesa in secondi per i clienti nella coda di destinazione.
NumeroDiEspertiDisponibiliInCoda Numeri Numero di rappresentanti del servizio attualmente disponibili per accettare conversazioni nella coda di destinazione.

Risposta di esempio

{  
"@odata.context": "https://<org-url>/api/data/v9.2/\$metadata#Microsoft.Dynamics.CRM.CCaaS_GetRepresentativeAvailabilityForConversationResponse",  
"NextTransitionTime": "9999-12-31T23:59:59Z",
"NumberOfExpertsAvailableInQueue": 5,
"AverageWaitTimeInSeconds": 45  
"PositionInQueue": 1,  
"AverageWaitTime": null,  
"StartTimeOfNextOperatingHour": "0001-01-01T00:00:00Z",  
"EndTimeOfNextOperatingHour": "0001-01-01T00:00:00Z",  
"QueueId": "85e55877-f27a-e911-a81a-000d3a1ca610",  
"IsAgentAvailable": true,  
"IsQueueAvailable": true  
}

Usare le API di disponibilità rappresentative
CCaaS_GetRepresentativeAvailabilityBeforeConversation

  • Last updated on