Representatieve beschikbaarheids-API's gebruiken

Gebruik de api's voor representatieve beschikbaarheid om informatie op te halen over de beschikbaarheid van wachtrij- en klantenservicevertegenwoordigers in Dynamics 365 Contact Center.

U kunt deze API's gebruiken in scenario's zoals:

  • Wanneer AI-agents doorlopende gesprekken naar die wachtrijen moeten escaleren, alleen waar servicevertegenwoordigers beschikbaar zijn.
  • U wilt dat klanten alleen gesprekken starten wanneer de wachtrijen binnen kantooruren vallen of als er vertegenwoordigers beschikbaar zijn.

De representatieve beschikbaarheids-API's zijn van toepassing op alle kanalen, waaronder spraak, live chat en digitale berichten.

Vereiste voorwaarden

  • U hebt de rol Omnichannel-beheerder toegewezen.

Token instellen voor API-autorisatie

Als u de representatieve beschikbaarheids-API's wilt gebruiken, moet u een toegangstoken genereren. Dit token fungeert als een veilige referentie om de identiteit van uw toepassing te verifiëren en deze te autoriseren voor toegang tot specifieke servicebronnen.

Voer de volgende stappen uit in de Azure portal:

  1. Register van uw toepassing of ga naar Entra ID>App-registraties en selecteer vervolgens uw clienttoepassing. Kopieer de volgende waarden:

    • Applicatie (cliënt) ID
    • Directory (huurder) ID

  2. Selecteer API-machtigingen>toevoegen in uw app-registratie.

  3. Selecteer in API-machtigingen aanvragen de tab Microsoft API's en selecteer vervolgens Dynamics CRM.

  4. Selecteer Gedelegeerde machtigingen en selecteer vervolgens het user_impersonation bereik.

  5. Selecteer Machtigingen toevoegen.

  6. Voeg een clientgeheim toe voor uw toepassing.

Important

Kopieer de geheime waarde onmiddellijk. Deze waarde is versleuteld en wordt niet opnieuw weergegeven nadat u de pagina hebt verlaten.

Voer de volgende POST aanvraag uit om het token te genereren. Vervang de volgende waarden.

Waarde Beschrijving
tenant-Id De directory-id (tenant) van de app.
client_id De toepassings-id (client) die is toegewezen aan uw app in Microsoft Entra ID.
client_secret De geheime tekenreeks die is gegenereerd tijdens de app-registratie.
resource De URL van uw Dynamics 365-omgeving, waarmee de aangevraagde machtigingen worden gedefinieerd. 
 
   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}

Het antwoord retourneert een JSON-object met het token dat u kunt gebruiken in de autorisatieheader van uw representatieve beschikbaarheids-API-aanroepen als bearer-token.

Api's voor representatieve beschikbaarheid

De volgende representatieve beschikbaarheids-API's zijn beschikbaar:

  • CCaaS_GetRepresentativeAvailabilityForConversation: retourneert de beschikbaarheid van de wachtrij en servicevertegenwoordiger tijdens een actief gesprek met een geldige gespreks-id. Meer informatie vindt u in CCaaS_GetRepresentativeAvailabilityForConversation
  • CCaaS_GetRepresentativeAvailabilityBeforeConversation: retourneert de beschikbaarheid van de wachtrij en servicevertegenwoordiger voordat een gesprek met de klant wordt gestart. Meer informatie is te vinden in CCaaS_GetRepresentativeAvailabilityBeforeConversation.

CCaaS_GetRepresentativeBeschikbaarheidVoorGesprek
CCaaS_GetRepresentativeAvailabilityBeforeConversation

  • Last updated on