myContactCenterManuel

acdHub — vérifier l'ouverture et la disponibilité

Utiliser les requêtes d'ouverture et les calendriers des compétences sur un site via le hub SignalR acdHub.

Point de terminaison : /acdHub. Créez une connexion SignalR distincte pour ce hub. Transmettez le nom de la compétence dans skill.

Méthode Arguments Retour
IsOpen skill état d’ouverture booléen
IsManualOpen skill état booléen de l’ouverture manuelle
IsCalendarOpen skill état booléen selon les horaires d’ouverture
IsHolidayOpen skill état booléen selon les jours fériés
NextOpenDate skill, testTime prochaine ouverture ; la valeur par défaut "0001-01-01T00:00:00" de testTime utilise l’heure du serveur
GetHolidaysiCalendar skill calendrier des jours fériés au format texte iCalendar
GetHolidaysvCalendar skill calendrier des jours fériés au format texte vCalendar
GetBusinessHoursiCalendar skill horaires au format texte iCalendar
GetBusinessHoursvCalendar skill horaires au format texte vCalendar

Exemple après le chargement de la bibliothèque SignalR :

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 ? "Ouvert" : "Fermé";
await acd.stop();

Placez cet exemple dans un module JavaScript ou une fonction asynchrone. Le site doit posséder un élément avec l’identifiant serviceStatus.

L’ouverture ne signifie pas qu’un agent est immédiatement libre. Considérez l’affichage comme une indication ponctuelle et tenez compte des horaires d’ouverture.

Autres méthodes et limites

Le hub contient également GetNumberOfQualifiedAgents(skill, language, skillQualificationType), GetNumberOfAvailableAgents avec les mêmes arguments et GetNumberOfAgents(skill, language, available, useEscalatableAgentsOnly, skillQualificationType). Chacune renvoie un entier. Le type de qualification est une valeur numérique de SkillQualificationType. Dans la version documentée, Chat = 5 et WebCallback = 6.

GetNumberOfConversations(skill, language, conversationState, conversationType) renvoie un nombre. Le code applique les filtres par étapes : un filtre d’état sans filtre de type correspondant est ignoré. Transmettez explicitement les valeurs par défaut pour les arguments non filtrés ; les arguments SignalR omis ne deviennent pas automatiquement des paramètres par défaut.

Les méthodes existantes GetAVGWaitTime, GetAVGConnectTime et GetAVGTime s’appellent elles-mêmes dans la version documentée. Ne les utilisez pas pour un affichage sur le site. Elles ne fournissent pas de requêtes fiables sur les moyennes dans cette version.

    ↑ ↓ sélectionner · Entrée ouvrir · Échap fermer