CCaaS_GetRepresentativeAvailabilityForConversation

Utilizza l'API CCaaS_GetRepresentativeAvailabilityForConversation per ottenere la disponibilità della coda e del rappresentante 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 IA 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

Metodo

POST

Versione

1.0

Intestazioni richieste

Nome Descrizione
Autorizzazione Obbligatorio. Token di connessione Microsoft Entra ID per il chiamante API nell'istanza di Contact Center. Per altre informazioni, vedere Configurare il token per l'autorizzazione API

Corpo della richiesta di esempio

Descrizione Esempio di richiesta
Determina 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" }'
Determina la disponibilità di code e rappresentanti in una conversazione in cui le regole Distribuisci a coda 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 Boolean Visualizza TRUE se la coda è entro l'orario di funzionamento. FALSE se la coda è al di fuori dell'orario operativo.
StartTimeOfNextOperatingHour 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 DateTime Ora (UTC) di 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.
nexttransitiontime 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 Boolean Visualizza:
  • TRUE se i rappresentanti del servizio nella coda sono attualmente disponibili per accettare richieste in base alle regole di distribuzione e assegnazione per il flusso di lavoro.
  • 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