Använda API:er för representativ tillgänglighet

Använd API:erna för representativ tillgänglighet för att hämta information om kö- och kundtjänstrepresentanternas tillgänglighet i Dynamics 365 Contact Center.

Du kan använda dessa API:er i scenarier som:

  • När AI-agenter behöver eskalera pågående konversationer till de köer där endast tjänstrepresentanter är tillgängliga.
  • Du vill att kunderna endast ska initiera konversationer när köerna är inom drifttimmarna eller har tillgängliga representanter.

API:erna för representativ tillgänglighet gäller för alla kanaler, inklusive röst- och livechatt och digitala meddelanden.

Förutsättningar

  • Du har rollen som Omnichannel-administratör tilldelats.

Konfigurera token för API-auktorisering

Om du vill använda API:erna för representativ tillgänglighet måste du generera en åtkomsttoken. Den här token fungerar som en säker autentiseringsuppgift för att autentisera programmets identitet och ge den behörighet att komma åt specifika tjänstresurser.

Utför följande steg i portalen Azure:

  1. Registrera ditt program eller gå till Entra ID>App registrations och välj sedan klientprogrammet. Kopiera följande värden:

    • Applikations-ID (klientens ID)
    • Katalog-ID (hyresgäst)

  2. I appregistreringen väljer du API-behörigheter>Lägg till en behörighet.

  3. I Request API-behörigheter väljer du fliken Microsoft API:er och väljer sedan Dynamics CRM.

  4. Välj Delegerade behörigheter och välj sedan omfånget user_impersonation .

  5. Välj Lägg till behörigheter.

  6. Lägg till en klienthemlighet för ditt program.

Important

Kopiera det hemliga värdet omedelbart. Det här värdet är krypterat och visas inte igen när du har lämnat sidan.

Kör följande POST begäran för att generera token. Ersätt följande värden.

Value Beskrivning
tenant-Id Appens katalog-ID (tenants-ID).
client_id Program-ID:t (klient) som tilldelats din app i Microsoft Entra ID.
client_secret Den hemliga sträng som genererades under appregistreringen.
resource URL:en för din Dynamics 365 miljö, som definierar de begärda behörigheterna. 
 
   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}

Svaret returnerar ett JSON-objekt med den token som du kan använda i auktoriseringshuvudet för dina API-anrop för representativ tillgänglighet som en ägartoken.

API:er för representativ tillgänglighet

Följande representativa tillgänglighets-API:er är tillgängliga:

CCaaS_GetRepresentativeAvailabilityForConversation
CCaaS_GetRepresentativeAvailabilityBeforeConversation

  • Last updated on