myContactCenterHandbuch

acdHub — Öffnung und Verfügbarkeit abfragen

Öffnungsabfragen und Kalender für Wissensgebiete über den SignalR-acdHub auf einer Website verwenden.

Endpunkt: /acdHub. Stellen Sie dafür eine eigene SignalR-Verbindung her. Übergeben Sie bei skill den Namen des Wissensgebiets.

Methode Argumente Rückgabe
IsOpen skill boolescher Öffnungszustand
IsManualOpen skill boolescher Zustand der manuellen Öffnung
IsCalendarOpen skill boolescher Zustand gemäß Geschäftszeiten
IsHolidayOpen skill boolescher Zustand gemäß Feiertagen
NextOpenDate skill, testTime nächster Öffnungszeitpunkt; "0001-01-01T00:00:00" als Standardwert für testTime verwendet die Serverzeit
GetHolidaysiCalendar skill Feiertagskalender als Text im iCalendar-Format
GetHolidaysvCalendar skill Feiertagskalender als Text im vCalendar-Format
GetBusinessHoursiCalendar skill Geschäftszeiten im iCalendar-Format
GetBusinessHoursvCalendar skill Geschäftszeiten im vCalendar-Format

Beispiel, nachdem die SignalR-Bibliothek geladen wurde:

const acd = new signalR.HubConnectionBuilder()
    .withUrl("https://kontakt.example.org/acdHub")
    .build();
await acd.start();
const isOpen = await acd.invoke("IsOpen", "Support");
document.getElementById("serviceStatus").textContent =
    isOpen ? "Geöffnet" : "Geschlossen";
await acd.stop();

Dieses Beispiel gehört in ein JavaScript-Modul oder eine asynchrone Funktion; die Website benötigt ein Element mit der ID serviceStatus.

Öffnung bedeutet nicht, dass sofort ein Agent frei ist. Behandeln Sie die Anzeige als Momentaufnahme und berücksichtigen Sie die Geschäftszeiten.

Weitere Methoden und Grenzen

Der Hub enthält außerdem GetNumberOfQualifiedAgents(skill, language, skillQualificationType), GetNumberOfAvailableAgents mit denselben Argumenten und GetNumberOfAgents(skill, language, available, useEscalatableAgentsOnly, skillQualificationType); Rückgabe ist jeweils eine Ganzzahl. Der Qualifikationstyp ist ein numerischer Wert der SkillQualificationType-Enumeration. Im dokumentierten Stand gilt Chat = 5 und WebCallback = 6.

GetNumberOfConversations(skill, language, conversationState, conversationType) liefert eine Anzahl. Die Filter werden im Code stufenweise angewendet: Ein Zustandsfilter ohne passenden Typfilter wird nicht berücksichtigt. Für ungefilterte Argumente müssen die entsprechenden Standardwerte explizit übermittelt werden; ausgelassene Argumente sind bei SignalR keine automatischen Standardparameter.

Die ebenfalls vorhandenen Methoden GetAVGWaitTime, GetAVGConnectTime und GetAVGTime rufen sich im hier dokumentierten Stand selbst auf. Verwenden Sie sie nicht für eine Website-Anzeige. Sie liefern in diesem Stand keine verlässliche Mittelwertabfrage.

    ↑ ↓ auswählen · Eingabe öffnen · Esc schließen