Usare le API di disponibilità rappresentative

Usare le API di disponibilità rappresentative per recuperare informazioni sulla disponibilità della coda e del rappresentante del servizio clienti in Dynamics 365 Commerce.

È possibile usare queste API in scenari come:

  • Quando gli agenti di intelligenza artificiale devono inoltrare le conversazioni in corso solo alle code dove sono disponibili gli operatori.
  • Si vuole che i clienti avviino conversazioni solo quando le code sono entro ore lavorative o hanno rappresentanti disponibili.

Le API di disponibilità rappresentative sono applicabili a tutti i canali, tra cui voce, live chat e messaggistica digitale.

Prerequisiti

  • È stato assegnato il ruolo di amministratore Omnichannel.

Configurare il token per l'autorizzazione API

Per usare le API di disponibilità rappresentative, è necessario generare un token di accesso. Questo token funge da credenziale sicura per autenticare l'identità dell'applicazione e autorizzarla ad accedere a risorse di servizio specifiche.

Seguire questa procedura nel portale Azure:

  1. Registrare l'applicazione o passare a Entra ID>Registrazioni app e quindi selezionare l'applicazione client. Copia i valori seguenti:

    • ID applicazione (client)
    • ID della directory (tenant)

  2. Nella registrazione dell'app selezionare Autorizzazioni> APIAggiungi un'autorizzazione.

  3. In Request API permissions selezionare Microsoft API scheda e quindi selezionare Dynamics CRM.

  4. Selezionare Autorizzazioni delegate e quindi selezionare l'ambito user_impersonation .

  5. Seleziona Aggiungi autorizzazioni.

  6. Aggiungere un segreto client per l'applicazione.

Importante

Copia il valore segreto immediatamente. Questo valore viene crittografato e non viene visualizzato di nuovo dopo aver lasciato la pagina.

Per generare il token, eseguire la richiesta seguente POST . Sostituire i valori seguenti.

Value Descrizione
tenant-Id ID del directory (tenant) dell'app.
client_id ID dell'applicazione (client) assegnato alla tua app in Microsoft Entra ID.
client_secret Stringa privata generata durante la registrazione dell'app.
resource URL dell'ambiente Dynamics 365, che definisce le autorizzazioni richieste. 
 
   curl --request POST \
   --url https://login.windows.net/{tenant-Id}/oauth2/token \
   --header 'Content-Type: multipart/form-data' \

   --header 'User-Agent: insomnia/10.1.0' \
   --cookie 'fpc=ApQqO0OrCftGhsPOawVKHv6SxOiUAgAAHN3YN8OAAAA; x-ms-gateway-slice=estsfd; stsservicecookie=estsfd' \
   --form grant_type=client_credentials \
   --form client_id={ApplicationIdFromAppRegistration} \
   --form 'client_secret={secretSavedInPreviousStep}' \
   --form resource={OrgUrl}

La risposta restituisce un oggetto JSON con il token che è possibile usare nell'intestazione di autorizzazione delle chiamate dell'API di disponibilità rappresentativa come token di connessione.

API di disponibilità rappresentative

Sono disponibili le API di disponibilità rappresentative seguenti:

  • CCaaS_GetRepresentativeAvailabilityForConversation: restituisce la disponibilità della fila e del rappresentante del servizio clienti durante una conversazione attiva con un ID conversazione valido. Altre informazioni in CCaaS_GetRepresentativeAvailabilityForConversation
  • CCaaS_GetRepresentativeAvailabilityBeforeConversation: restituisce la disponibilità della coda e del rappresentante del servizio prima dell'avvio di una conversazione con il cliente. Scopri di più in CCaaS_GetRepresentativeAvailabilityBeforeConversation

CCaaS_GetRepresentativeAvailabilityForConversation
CCaaS_GetRepresentativeAvailabilityBeforeConversation

  • Last updated on