Verwenden repräsentativer Verfügbarkeits-APIs

Verwenden Sie die repräsentativen Verfügbarkeits-APIs, um Informationen zur Verfügbarkeit von Warteschlangen- und Kundendienstmitarbeitern in Dynamics 365 Contact Center abzurufen.

Sie können diese APIs in Situationen wie zum Beispiel verwenden:

  • Wenn KI-Agents laufende Unterhaltungen nur an jene Warteschlangen eskalieren müssen, wo Servicemitarbeiter verfügbar sind.
  • Sie möchten, dass Kunden Unterhaltungen nur initiieren, wenn sich die Warteschlangen innerhalb der Betriebszeiten befinden oder über verfügbare Vertreter verfügen.

Die repräsentativen Verfügbarkeits-APIs gelten für alle Kanäle, einschließlich VoIP, Live-Chat und digitaler Nachrichten.

Voraussetzungen

  • Ihnen ist die Omnichannel-Administratorrolle zugewiesen.

Einrichten eines Tokens für die API-Autorisierung

Um die repräsentativen Verfügbarkeits-APIs zu verwenden, müssen Sie ein Zugriffstoken generieren. Dieses Token fungiert als sichere Anmeldeinformationen, um die Identität Ihrer Anwendung zu authentifizieren und sie für den Zugriff auf bestimmte Dienstressourcen zu autorisieren.

Führen Sie die folgenden Schritte im portal Azure aus:

  1. Registern Sie Ihre Anwendung oder wechseln Sie zu Entra ID>App-Registrierungen, und wählen Sie dann Ihre Clientanwendung aus. Kopieren Sie die folgenden Werte:

    • Anwendungs-ID (Client)
    • Verzeichnis-ID (Mandant)

  2. Wählen Sie in Ihrer App-Registrierung API-Berechtigungen>"Berechtigung hinzufügen" aus.

  3. Wählen Sie in Request-API-BerechtigungenMicrosoft APIs und dann Dynamics CRM aus.

  4. Wählen Sie delegierte Berechtigungen und dann den user_impersonation Bereich aus.

  5. Wählen Sie Berechtigungen hinzufügen aus.

  6. Fügen Sie einen geheimen Clientschlüssel für Ihre Anwendung hinzu.

Important

Kopieren Sie den geheimen Wert sofort. Dieser Wert ist verschlüsselt und wird nach dem Verlassen der Seite nicht mehr angezeigt.

Führen Sie die folgende POST Anforderung aus, um das Token zu generieren. Ersetzen Sie die folgenden Werte.

Wert Description
tenant-Id Die Verzeichnis (Mandanten-) ID der App.
client_id Die Anwendungs-ID (Client-ID), die Ihrer App in Microsoft Entra ID zugewiesen ist.
client_secret Die geheime Zeichenfolge, die während der App-Registrierung generiert wurde.
resource Die URL Ihrer Dynamics 365 Umgebung, die die angeforderten Berechtigungen definiert. 
 
   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}

Die Antwort gibt ein JSON-Objekt mit dem Token zurück, das Sie im Autorisierungsheader Ihrer repräsentativen Verfügbarkeits-API-Aufrufe als Bearertoken verwenden können.

Repräsentative Verfügbarkeits-APIs

Die folgenden repräsentativen Verfügbarkeits-APIs sind verfügbar:

  • CCaaS_GetRepresentativeAvailabilityForConversation: Gibt die Verfügbarkeit von Warteschlangen- und Servicemitarbeitern während einer aktiven Unterhaltung mit einer gültigen Unterhaltungs-ID zurück. Weitere Informationen in CCaaS_GetRepresentativeAvailabilityForConversation
  • CCaaS_GetRepresentativeAvailabilityBeforeConversation: Gibt die Verfügbarkeit der Warteschlange und der Servicemitarbeiter zurück, bevor eine Unterhaltung mit dem Kunden beginnt. Weitere Informationen zum Thema CCaaS_GetRepresentativeAvailabilityBeforeConversation

CCaaS_GetRepresentativeAvailabilityForConversation
CCaaS_GetRepresentativeAvailabilityBeforeConversation

  • Last updated on