Bruk representative tilgjengelighets-API-er

Bruk de representative tilgjengelighets-API-ene til å hente informasjon om tilgjengelighet for kø- og kundeservicerepresentant i Dynamics 365 Contact Center.

Du kan bruke disse API-ene i scenarioer som:

  • Når AI-agenter trenger å eskalere pågående samtaler til disse køene bare der tjenesterepresentanter er tilgjengelige.
  • Du vil at kunder bare skal starte samtaler når køene er innen driftstid eller har tilgjengelige representanter.

De representative tilgjengelighets-API-ene gjelder for alle kanaler, inkludert tale, direkte chat og digitale meldinger.

Forutsetninger

  • Du har tilordnet administratorrollen Omnichannel.

Konfigurere token for API-godkjenning

Hvis du vil bruke API-er for representativ tilgjengelighet, må du generere et tilgangstoken. Dette tokenet fungerer som en sikker legitimasjon for å godkjenne programmets identitet og godkjenne den for å få tilgang til bestemte tjenesteressurser.

Gjør følgende i Azure-portalen:

  1. Registrer programmet eller gå til Entra ID>App registrations, og velg deretter klientprogrammet. Kopier følgende verdier:

    • Program-ID (klient)
    • Katalog-ID (leier)

  2. Velg API-tillatelser>Legg til en tillatelse i appregistreringen.

  3. I Request API-tillatelser velger du Microsoft API-fanen, og deretter velger du Dynamics CRM.

  4. Velg delegerte tillatelser, og velg deretter omfanget user_impersonation .

  5. Velg Legg til tillatelser.

  6. Legg til en klienthemmelighet for programmet.

Viktig!

Kopier den hemmelige verdien umiddelbart. Denne verdien krypteres og vises ikke på nytt når du forlater siden.

Hvis du vil generere tokenet, kjører du følgende POST forespørsel. Erstatt følgende verdier.

Verdi Beskrivelse
tenant-Id Katalog-ID (tenant) for appen.
client_id Program-ID-en (klient) som er tilordnet appen i Microsoft Entra ID.
client_secret Den hemmelige strengen som ble generert under appregistrering.
resource URL-adressen til det Dynamics 365 miljøet, som definerer de forespurte tillatelsene. 
 
   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 tokenet som du kan bruke i autorisasjonshodet for API-en for representativ tilgjengelighet, som et Bearer-token.

API-er for representativ tilgjengelighet

Følgende representative tilgjengelighets-API-er er tilgjengelige:

CCaaS_GetRepresentativeAvailabilityForConversation
CCaaS_GetRepresentativeAvailabilityBeforeConversation

  • Last updated on