Dieser API-Endpunkt gibt die berechnete geschätzte Wartezeit (Estimated Wait Time, EWT) pro Warteschlange zurück.
Dies kann für benutzerdefinierte EWT-Anzeigen für Supportkanäle auf Webseiten oder in mobilen Apps außerhalb des Contact Center AI Platform (CCAI Platform) SDK oder für benutzerdefinierte Benachrichtigungen oder Trigger verwendet werden.
Beispielanfrage
URL: http://{subdomain}.{domain}/apps/api/v1/wait_times
Parameter
| ID | Feldname | Typ | Erforderlich | Beschreibung | Werte | Hinweise |
|---|---|---|---|---|---|---|
| 1 | menu_id | id | Nein | In der Antwort werden alle Menüs (Warteschlangen) im Untermenü dieses Menüs gefiltert, einschließlich des Menüs selbst. | Stammmenü (Standard) Bestimmtes Menü | Wenn nichts übergeben wird, wird die gesamte Warteschlangenstruktur zurückgegeben. |
| 2 | channel_type | enum | Nein | Gibt Menüs eines bestimmten Kanals zurück | voice_call chat | Optionaler Parameter |
| 3 | menu_type | enum | Nein | Gibt Menüs bestimmter Typen zurück | ivr_menu mobile_menu web_menu Alle (Standard) |
optional |
| 4 | wait[from] | int | Nein | Gibt Datensätze zurück, wenn sie eine Wartezeit haben, die größer als der Wert ist. | Bestätigung:Nur positive Intention | |
| 5 | wait[to] | int | Nein | Gibt Datensätze zurück, wenn die Wartezeit kleiner als der Wert ist | Bestätigung:Nur positive Intention | |
| 6 | lang | enum | Ja | Warteschlangenstruktur zum Abrufen des EWT | Beispiel: „en“, „es“, „fr“, „de“ „it“ „ja“ „ko“ „pt“ "pt-BR" "sv" |
Antworten
| ID | Feldname | Typ | Erforderlich | Beschreibung |
|---|---|---|---|---|
| 1 | menu_id | id | Ja | Fremdschlüssel für den API-Endpunkt „/menus“ |
| 2 | wait | GANZZAHL | Ja | Wartezeit in Minuten |
| 3 | Materialisierter Pfad | String | Ja | Materialisierter Pfad, wie er in der /menus API gefunden wird |
Beispiel
http://{subdomain}.{domain}/apps/api/v1/wait_times?lang=en&menu_id=10
[
{
"menu_id": 10,
"menu_type": "ivr_menu",
"voice_call": 120,
"materialized_path": "Subscription",
"logged_in_agents": 3,
"available_agents": 0,
"breakthrough_agents": 1
}
]
Statuscode:200
Die geschätzte Wartezeit für die Menü-ID 10 beträgt 120 Sekunden (oder 2 Minuten).