Brug repræsentative tilgængeligheds-API'er

Brug API'erne for repræsentativ tilgængelighed til at hente oplysninger om tilgængelighed af kø og kundeservicerepræsentant i Dynamics 365 Contact Center.

Du kan bruge disse API'er i scenarier som:

  • Når AI-agenter kun har brug for at eskalere igangværende samtaler til disse køer, hvor tjenesterepræsentanter er tilgængelige.
  • Du ønsker, at kunderne kun skal starte samtaler, når køerne er inden for driftstimerne eller har tilgængelige repræsentanter.

De repræsentative tilgængeligheds-API'er gælder for alle kanaler, herunder tale, livechat og digitale beskeder.

Forudsætninger

  • Du har fået tildelt administratorrollen Omnichannel.

Konfigurer token til API-godkendelse

Hvis du vil bruge API'erne til repræsentativ tilgængelighed, skal du generere et adgangstoken. Dette token fungerer som sikre legitimationsoplysninger for at godkende dit programs identitet og give det tilladelse til at få adgang til bestemte tjenesteressourcer.

Benyt følgende fremgangsmåde på portalen Azure:

  1. Registrer dit program eller gå til Entra ID>App registrations, og vælg derefter dit klientprogram. Kopiér følgende værdier:

    • Program-id (klient)
    • Mappe-id (lejer)

  2. I din appregistrering skal du vælge API-tilladelser>Tilføj en tilladelse.

  3. I Anmodning om API-tilladelser skal du vælge Microsoft API'er fane og derefter vælge Dynamics CRM.

  4. Vælg Delegerede tilladelser, og vælg user_impersonation derefter området.

  5. Vælg Tilføj tilladelser.

  6. Tilføj en klienthemmelighed for dit program.

Vigtigt!

Kopiér den hemmelige værdi med det samme. Denne værdi krypteres og vises ikke igen, når du forlader siden.

Kør følgende POST anmodning for at generere tokenet. Erstat følgende værdier.

Value Description
tenant-Id Mappe-id'et (lejeren) for appen.
client_id Det program-id (klient), der er tildelt din app i Microsoft Entra ID.
client_secret Den hemmelige streng, der genereres under appregistrering.
resource URL-adressen til dit Dynamics 365 miljø, der definerer de ønskede tilladelser. 
 
   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 returnerer et JSON-objekt med det token, som du kan bruge i godkendelsesheaderen for api'en for din repræsentants tilgængelighed, som et ihændehavertoken.

Api'er for repræsentativ tilgængelighed

Følgende repræsentative tilgængeligheds-API'er er tilgængelige:

CCaaS_GetRepresentativeAvailabilityForConversation
CCaaS_GetRepresentativeAvailabilityBeforeConversation

  • Last updated on