Utiliser des API de disponibilité représentatives

Utilisez les API de disponibilité représentatives pour récupérer des informations sur la disponibilité de la file d’attente et du représentant du service client dans Dynamics 365 Contact Center.

Vous pouvez utiliser ces API dans des scénarios tels que :

  • Lorsque les agents IA doivent remonter les conversations en cours à ces files d’attente uniquement lorsque les représentants du service sont disponibles.
  • Vous souhaitez que les clients initient des conversations uniquement lorsque les files d’attente sont dans les heures d’exploitation ou que des représentants sont disponibles.

Les API de disponibilité représentatives s’appliquent à tous les canaux, y compris la voix, la conversation en direct et la messagerie numérique.

Prerequisites

  • Vous avez le rôle d’administrateur Omnichannel attribué.

Configurer le jeton pour l’autorisation d’API

Pour utiliser les API de disponibilité représentatives, vous devez générer un jeton d’accès. Ce jeton agit comme des informations d’identification sécurisées pour authentifier l’identité de votre application et l’autoriser à accéder à des ressources de service spécifiques.

Procédez comme suit dans le portail Azure :

  1. Registrer votre application ou accéder à Entra ID>inscriptions d'applications, puis sélectionnez votre application cliente. Copiez les valeurs suivantes :

    • ID d’application (client)
    • ID de l’annuaire (locataire)

  2. Dans l’inscription de votre application, sélectionnez Autorisations d’API>Ajouter une autorisation.

  3. Dans Enquester les autorisations de l’API, sélectionnez Microsoft API onglet, puis sélectionnez Dynamics CRM.

  4. Sélectionnez Autorisations déléguées, puis sélectionnez l’étendue user_impersonation .

  5. Sélectionnez Ajouter des autorisations.

  6. Ajoutez une clé secrète client pour votre application.

Important

Copiez immédiatement la valeur secrète. Cette valeur est chiffrée et n’est plus affichée après avoir quitté la page.

Pour générer le jeton, exécutez la requête suivante POST . Remplacez les valeurs suivantes.

Valeur Description
tenant-Id ID de répertoire (instance) de l’application.
client_id ID d’application (client) affecté à votre application dans Microsoft Entra ID.
client_secret Chaîne secrète générée lors de l’inscription de l’application.
resource URL de votre environnement de Dynamics 365, définissant les autorisations demandées. 
 
   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 réponse retourne un objet JSON avec le jeton que vous pouvez utiliser dans l’en-tête d’autorisation de vos appels d’API de disponibilité représentatifs en tant que jeton du porteur.

API de disponibilité représentatives

Les API de disponibilité représentatives suivantes sont disponibles :

  • CCaaS_GetRepresentativeAvailabilityForConversation : retourne la disponibilité de la file d’attente et du représentant du service pendant une conversation active avec un ID de conversation valide. En savoir plus dans CCaaS_GetRepresentativeAvailabilityForConversation
  • CCaaS_GetRepresentativeAvailabilityBeforeConversation : retourne la file d’attente et la disponibilité du représentant du service avant le démarrage d’une conversation avec le client. En savoir plus dans CCaaS_GetRepresentativeAvailabilityBeforeConversation

CCaaS_GetRepresentativeAvailabilityForConversation
CCaaS_GetRepresentativeAvailabilityBeforeConversation

  • Last updated on