Udostępnij przez

getAgentAvailability

Aplikacja Obsługa wielokanałowa klientów dla Dynamics 365 oferuje zestaw funkcji, które rozszerzają możliwości Dynamics 365 Customer Service Enterprise, aby umożliwić organizacjom natychmiastowe łączenie się i interakcję z klientami za pośrednictwem cyfrowych kanałów komunikacji. Do uzyskania dostępu do plików sieciOwych w celu obsługa klienta jest wymagana dodatkowa licencja. Aby uzyskać więcej informacji, zobacz omówienie cennika usługi Dynamics 365 Customer Service i strony cennika Dynamics 365 Customer Service.

Pobiera informacje o dostępności agenta dla kolejki na podstawie reguł rozsyłania. Deweloper obsługi wielokanałowej może użyć tego interfejsu API do określenia, czy opcja rozpoczęcia konwersacji powinna być widoczna dla klienta, a także do wyświetlenia informacji, takich jak czas oczekiwania i pozycja w kolejkach.

Uwaga / Notatka

  • Posłuchaj zdarzenia lcw:ready wywołanego przez czat na żywo przed wywołaniem metod SDK czatu na żywo. Metody czatu na żywo mogą być wywoływane po wywołaniu zdarzenia lcw:ready . To zdarzenie można wykrywać, dodając własny detektor zdarzeń do obiektu window.
  • Ta metoda może być wywoływana wiele razy po stronie klienta, gdy dane wejściowe klienta ulegną zmianie. Pamięć podręczna po stronie klienta jest odświeżana co 2 minuty lub po zmianie parametrów kontekstu klienta.
  • Ta metoda może być wywoływana tylko 100 razy na minutę na organizację. Jeśli przekroczysz limit, zostanie wyświetlony kod stanu odpowiedzi http 429 wskazujący, że wysłano zbyt wiele żądań w określonym czasie.

Składnia

Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability();

Parametry

Żaden

Wartość zwracana

Name Typ Description
queueId Sznurek Kolejka docelowa, do której żądanie jest kierowane na podstawie konfiguracji reguły routingu i danych wejściowych (podana jest wartość jednostki i kontekstu, które są częścią reguły routingu).
isQueueAvailable logiczny Wyświetla:
- PRAWDA, jeśli kolejka znajduje się w godzinach pracy.
- FALSE, jeśli kolejka znajduje się poza godzinami pracy.
StartTimeOfNextOperatingHour DateTime Czas rozpoczęcia (UTC) godzin pracy kolejki, jeśli znajduje się ona poza godzinami pracy. W godzinach pracy zwracana jest wartość 01-01-0001.
EndTimeOfNextOperatingHour DateTime Czas (UTC) zakończenia godzin pracy kolejki, jeśli znajduje się ona poza godzinami pracy. W godzinach pracy zwracana jest wartość 01-01-0001.
nexttransitiontime DateTime Czas (UTC), kiedy kolejka jest ponownie uruchomiona, jeśli znajduje się poza godzinami pracy. Czas, w którym kolejka nie działa, jest wyświetlany w godzinach pracy.
positionInQueue Number Stanowisko w kolejce dla klienta oczekującego za innymi klientami w tej samej kolejce.
isAgentAvailable logiczny Wyświetla:
- PRAWDA, jeśli agenci w kolejce są obecnie dostępni do przyjmowania żądań na podstawie skonfigurowanych reguł rozsyłania i przypisywania dla strumienia pracy. Interfejs API zwraca również wartość true, jeśli bot jest dołączony do strumienia pracy lub kolejki. Zalecamy, aby ten interfejs API nie był używany, gdy obecny jest bot.
- FALSE, jeśli agenci nie są dostępni do przyjmowania żądań.
averageWaitTime Number Średni czas oczekiwania w minutach dla klientów w kolejce docelowej na podstawie danych z ostatnich 48 godzin.

Example

window.addEventListener("lcw:ready", function handleLivechatReadyEvent(){
               // Gets the agent availability
               Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability();
});

Przekaż niestandardowe wartości kontekstu dla funkcji, aby upewnić się, że kontekst jest odbierany

Ta metoda wykonuje wewnętrzne wywołanie funkcji setContextProvider, a następnie wywołuje metodę getAgentAvailability synchronicznie, aby upewnić się, że kontekst jest ustawiony przed kontynuowaniem. Ze względu na asynchroniczny charakter funkcji, gdy są one używane oddzielnie, kontekst może nie być gotowy, gdy agent konsultingowy jest dostępny.

Uwaga / Notatka

Nie trzeba wywoływać metody setContextProvider przed wywołaniem metody getAgentAvailability.

Oto przykładowy kod, który pokazuje, jak używać tej setContextProvider metody.

// To set the custom context, pass the custom context object as input parameter to agent availability

    // provider as part of the logic, so there is no need to set custom context before this call.

    Microsoft.Omnichannel.LiveChatWidget.SDK.getAgentAvailability({

        customContext : {

                'jwtToken': {'value':'token','isDisplayable':true},

                'Email': {'value':'test@test.com','isDisplayable':true},

                'client': {'value':'true','isDisplayable':true},

                'Emailing': {'value':'true','isDisplayable':true}

        }

    }

    );

startCzat
setContextProvider
Odwołanie SDK czatu na żywo

  • Last updated on