Korzystanie z interfejsów API dotyczących dostępności przedstawiciela

Skorzystaj z interfejsów API dotyczących dostępności przedstawiciela, aby uzyskać informacje o dostępności kolejek i przedstawicieli działu obsługi klienta w Dynamics 365 Contact Center.

Te interfejsy API można używać w scenariuszach, takich jak:

  • Gdy agenci AI muszą przekierować trwające rozmowy wyłącznie do tych kolejek, w których dostępni są przedstawiciele działu obsługi.
  • Chcesz, aby klienci inicjowali rozmowy tylko wtedy, gdy kolejki są dostępne w godzinach pracy lub są dostępni przedstawiciele.

Reprezentatywne API dostępności są dostępne dla wszystkich kanałów.

Note

  • Interfejsy API dostępności przedstawicieli nie uwzględniają obsługi przepełnienia kolejki ani konfiguracji routingu opartej na procentach zdefiniowanej na poziomie strumienia pracy. W przypadku dopasowania wielu reguł typu „trasa do kolejki” interfejs API zwracają wyniki na podstawie pierwszej dopasowanej kolejki.
  • Metryki kolejki, takie jak średni czas oczekiwania i pozycja w kolejce, odświeżają się niemal w czasie rzeczywistym. Wskaźniki związane z przedstawicielami, takie jak dostępność przedstawicieli oraz liczba dostępnych przedstawicieli w kolejce, odświeżają się mniej więcej co pięć minut. Konfiguracja kolejek, podobnie jak godziny pracy, odświeża się co 10 minut.

Wymagania wstępne

  • Masz przypisaną rolę administratora omnichannel.

Konfigurowanie tokenu na potrzeby autoryzacji interfejsu API

Aby korzystać z reprezentatywnych interfejsów API dostępności, należy wygenerować token dostępu. Ten token działa jako bezpieczne poświadczenie w celu uwierzytelniania tożsamości aplikacji i autoryzowania go w celu uzyskania dostępu do określonych zasobów usługi.

Wykonaj następujące kroki w portalu Azure:

  1. Registerowanie aplikacji lub przejdź do Entra ID>Rejestracje aplikacji, a następnie wybierz aplikację kliencą. Skopiuj następujące wartości:

    • Identyfikator aplikacji (klienta)
    • Identyfikator katalogu (dzierżawy)

  2. W rejestracji aplikacji wybierz pozycję Uprawnienia interfejsu API>Dodaj uprawnienie.

  3. W obszarze Żądaj uprawnień API wybierz kartę Microsoft APIs, a następnie wybierz Dynamics CRM.

  4. Wybierz pozycję Uprawnienia delegowane, a następnie wybierz user_impersonation zakres.

  5. Wybierz opcję Dodaj uprawnienia.

  6. Dodaj tajemnicę klienta dla aplikacji.

Ważna

Skopiuj tajną wartość natychmiast. Ta wartość jest szyfrowana i nie jest wyświetlana ponownie po opuszczeniu strony.

Aby wygenerować token, uruchom następujące POST żądanie. Zastąp następujące wartości.

Value Description
tenant-Id Identyfikator katalogu (dzierżawy) aplikacji.
client_id Identyfikator aplikacji (klienta) przypisany w Microsoft Entra ID do Twojej aplikacji.
client_secret Tajny ciąg znaków wygenerowany podczas rejestracji aplikacji.
resource Adres URL środowiska Dynamics 365 definiujący żądane uprawnienia. 
 
   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}

Odpowiedź zwraca obiekt JSON zawierający token, który można wykorzystać w nagłówku autoryzacji podczas wywoływania interfejsu API dostępności przedstawiciela jako token elementu nośnego.

Przykładowe interfejsy API dostępności zasobów

Dostępne są następujące interfejsy API dotyczące dostępności przedstawiciela:

  • CCaaS_GetRepresentativeAvailabilityForConversation: zwraca informacje o kolejce i dostępności przedstawicieli działu obsługi podczas trwającej rozmowy na podstawie prawidłowego identyfikatora rozmowy. Więcej informacji znajdziesz w CCaaS_GetRepresentativeAvailabilityForConversation
  • CCaaS_GetRepresentativeAvailabilityBeforeConversation: zwraca dostępność kolejki i przedstawiciela działu obsługi klienta przed rozpoczęciem rozmowy z klientem. Dowiedz się więcej: CCaaS_GetRepresentativeAvailabilityBeforeConversation

CCaaS_GetRepresentativeAvailabilityForConversation
CCaaS_UzyskajDostępnośćPrzedstawicielaPrzedRozmową

  • Last updated on