Estimated Wait Time API
Übersicht
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 | Die Antwort filtert alle Menüs (Warteschlangen) im Untermenü dieses Menüs, einschließlich dieses Menüs. | 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 die Wartezeit größer als der Wert ist. | Bestätigung:Nur positive Intentionen | |
| 5 | wait[to] | int | Nein | Gibt Datensätze zurück, wenn die Wartezeit unter dem Wert liegt | Bestätigung:Nur positive Intentionen | |
| 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 wurde |
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).
Mehrere mobile Apps (MMA)
Übersicht
Das Mobile (Pro) SDK kann in mehrere verschiedene mobile Apps eingebunden werden.
Sie können technische Einstellungen, Warteschlangenstrukturen und das Routing für jede App separat festlegen, wenn Sie zwei verschiedene iOS- und Android-Apps haben, eine für Kunden und eine für Mitarbeiter.
Administrator-Konfiguration
Option zum Aktivieren des Multi Mobile App-Modus (MMA), um vorhandene oder neue mobile Apps zu verwalten
In-App-Warteschlangenverwaltung pro mobiler App: Definieren Sie unterschiedliche Warteschlangenstrukturen und Agentenzuweisungen pro mobiler App.
Sprachen und Nachrichten:Definieren Sie für jede Kombination aus mobiler App und Sprache separate In-App-Nachrichten.
PSTN-Fallback zur IVR-Warteschlange pro mobiler App:Weisen Sie jeder mobilen App eine IVR-Warteschlange der obersten Ebene für Fallback-Anrufe zu, wenn VoIP-Anrufe nicht möglich sind.
Leitfaden
Schritt 1: SDK-Integration
Binden Sie unsere neuesten iOS- und/oder Android-SDKs in Ihre mobilen Apps ein.
Szenario 1: Einzelne App mit vorhandener SDK-Integration
Es wird empfohlen, aber nicht unbedingt benötigt, unser SDK in Ihrer mobilen App zu aktualisieren. Die Konfiguration für PSTN-Fallback und Schwellenwerte für die Datenverbindung über das CCAI Platform-Portal ist jedoch nur über SDK v0.30+ verfügbar.
Szenario 2: Neues SDK einbinden Integrieren Sie unser aktuelles SDK in Ihre mobilen Apps.
Schritt 2: Menüstruktur der mobilen App-Warteschlange
Szenario 1: Vorhandene mobile Warteschlangenstruktur: Ändern Sie Ihre vorhandene Warteschlangenstruktur, indem Sie die gesamte Struktur für Ihre vorhandene App in ein einzelnes neues Warteschlangenmenü der obersten Ebene verschieben.
Gehen Sie zu Einstellungen > Warteschlange > Mobil und klicken Sie auf Bearbeiten/Ansehen.
Klicken Sie auf Bearbeiten, um den Bildschirm zum Bearbeiten der Struktur der mobilen Warteschlange aufzurufen.
Erstellen Sie für jede mobile App separate Warteschlangenstrukturen der obersten Ebene.
Szenario 2: Neue mobile App
Erstellen Sie die Menüstruktur für die mobile Warteschlange. Erstellen Sie zuerst eine Warteschlange der obersten Ebene für jede mobile App und fügen Sie dann die app-spezifischen Warteschlangenstrukturen in das Menü jeder Warteschlange der obersten Ebene ein.
Schritt 3: MMA-App-Konfiguration
Szenario 1: Bestehende mobile App
Gehen Sie zu Einstellungen > Entwicklereinstellungen.
Wenn Sie eine vorhandene App konfiguriert haben, wird der Bereich „Mobile Apps“ angezeigt:
Wenn Sie Ihre vorhandene App für den MMA-Modus vorbereiten möchten, klicken Sie auf das Symbol Bearbeiten (Stift) und füllen Sie die erforderlichen Felder im Fenster Mobile App bearbeiten aus.
Name der mobilen App (erforderlich): Muss ein eindeutiger Name für alle zuvor definierten mobilen Apps sein.
Mobile Identifier iOS / Android – mindestens eine dieser Kennungen ist erforderlich
Geben Sie die Kennungen der mobilen App ein. Ohne die richtigen Kennungen funktionieren Benachrichtigungen und die SmartAction-Funktion (über den Agent-Aufrufadapter) nicht.
Es muss mindestens eine Kennung (Betriebssystem oder Android) definiert werden.
Dieselbe Kennung kann sowohl für iOS als auch für Android verwendet werden.
Dieselbe Kennung kann nicht für mehrere mobile Apps verwendet werden.
Wenn Sie möchten, dass Kundenservicemitarbeiter eine SMS zum Herunterladen Ihrer App senden können, stellen Sie die Einstellung auf Ein.
Geben Sie die entsprechenden URLs für den App Store und den Play Store ein.
Fallback-Telefonnummer: muss die Landesvorwahl enthalten, z.B. in den USA: 1 714 450 5656
Wenn das mobile SDK erkennt, dass die Datenverbindung für einen bestimmten Anruf den konfigurierten Mindestschwellenwert (siehe unten) nicht erfüllt, wird der Anruf über das öffentliche Telefonnetz (PSTN) mit der hier definierten Nummer weitergeleitet.
Grenzwert für Fallback-Telefonnummer (erforderlich, wenn eine PSTN-Nummer angegeben ist): Ein Grenzwert, der auf dem Zustand der Datennetzwerkverbindung des Anrufers basiert und bestimmt, ob ein Anruf über VoIP oder über die PSTN-Fallback-Telefonnummer erfolgen soll.
Gültiger Bereich: 0 bis 1. Ein hoher Grenzwert wie 0,98 bedeutet, dass ein Anruf über das PSTN erfolgt, sofern die Datenverbindung nicht sehr gut ist. Ein Grenzwert von 0 würde die Anrufe auch bei relativ schlechter Datenverbindung über VoIP starten, was wahrscheinlich zu einer geringeren Anrufqualität führen würde. Bei einem Grenzwert von 1 werden alle Anrufe über das PSTN initiiert.
Wenn die Datennetzwerkverbindung einen VOIP-Anruf einfach nicht unterstützen kann, erfolgt der PSTN-Fallback auch dann, wenn der Wert auf 0 gesetzt ist.
PSTN-Anrufe von außerhalb der App nicht zulassen:Markieren Sie dieses Kästchen, wenn Sie PSTN-Fallback-Anrufe auf Anrufe beschränken möchten, die über das Mobile SDK erfolgen.
Wenn diese Option aktiviert ist, werden Anrufer, die einen direkten Anruf von außerhalb der App starten, zu einer benutzerdefinierten Nachricht weitergeleitet und der Anruf wird automatisch beendet, nachdem die Nachricht abgespielt wurde.
Alle Anrufe über die mobile App (bei entsprechender Datenverbindung) umfassen den benutzerdefinierten Datenfluss von der App zum CRM / Kundenservicemitarbeiter.
Push-Benachrichtigungen (erforderlich): Zertifikats-PEM-Datei (iOS), FCM (Android) Schlüssel
Prüfen Sie, ob die PEM-Datei hinzugefügt wurde, wenn die iOS-Kennung angegeben ist.
FCM-Schlüssel hinzufügen, wenn eine Android-ID angegeben ist
Konfigurieren Sie die Einstellungen für Push-Benachrichtigungen anhand der Readme-Dateien.
Szenario 2: Erste mobile App hinzufügen
Gehen Sie zu Einstellungen > Entwicklereinstellungen und scrollen Sie zum Bereich Mobile Apps.
Klicken Sie auf Mobile App hinzufügen und füllen Sie das Pop-up-Fenster für die Konfiguration der mobilen App wie oben beschrieben aus.
Klicken Sie zum Speichern auf Senden.
Liste der mobilen Apps – Status der konfigurierten App – nicht der In-App-Warteschlange zugewiesen
Wenn der Status der mobilen App eine inaktive Ein / Aus-Schaltfläche und ein Warnsymbol zeigt, besteht die einzige verfügbare Option darin, mit dem nächsten Schritt fortzufahren und die mobile App einer In-App-Warteschlange zuzuweisen.
Schritt 4: Struktur der In-App-Warteschlange – Zuweisung des direkten Zugriffspunkts (Direct Access Point, DAP) für mobile Apps
Definieren Sie für jede mobile App dedizierte Warteschlangen der obersten Ebene für Mobilgeräte.
Damit eine mobile App unter Einstellungen > Entwicklereinstellungen aktiviert werden kann, muss sie in der Menüstruktur der mobilen Warteschlange als DAP (Direct Access Point) vom Typ „Mobile App“ zugewiesen sein.
Gehen Sie zu Einstellungen > Warteschlange > In-App > Bearbeiten / Ansehen.
Klicken Sie auf eine Queue der obersten Ebene.
Scrollen Sie in den Einstellungen des Warteschlangenmenüs zum Abschnitt „Direktzugriffspunkt“.
Klicken Sie auf den Link Direkten Zugriffspunkt erstellen.
Wählen Sie Mobile App als Zugriffspunkttyp aus. Diese Option ist nur für Warteschlangenmenüs der obersten Ebene verfügbar. Wenn sie nicht angezeigt wird, prüfen Sie, ob sich über der ausgewählten Warteschlange eine andere Warteschlange befindet.
Benennen Sie den Zugangspunkt.
Wählen Sie die mobile App aus, der Sie diese Warteschlangenstruktur zuweisen möchten.
Jede mobile App kann nur einmal als DAP in der gesamten In-App-Warteschlangenstruktur angewendet werden. Eine mobile App, die bereits einer anderen Warteschlange der obersten Ebene zugewiesen wurde, kann nicht für eine andere Warteschlange der obersten Ebene ausgewählt werden.
Klicke zum Speichern auf Erstellen.
Wiederholen Sie den Vorgang, um jeder Warteschlangenübersicht der obersten Ebene eine DAP für mobile Apps zuzuweisen, wenn Sie mehrere Apps haben.
Details
Die Auswertung von In-App-Warteschlangen-DAPs folgt der bestehenden Priorität. Nutzersegment- und allgemeine DAPs werden vor mobilen Apps ausgewertet.
Achtung: Die Logik für die Geräteauswahl muss den übergeordneten Warteschlangen für die Geräteauswahl entsprechen und darf Endnutzer nicht aufgrund einer anderen Geräteauswahl beispielsweise von MMA A zur übergeordneten Warteschlange B weiterleiten.
Schritt 5: Zuweisung von DAP für mobile Apps zum IVR-Warteschleifenmenü
PSTN-Fallbackanrufe, die von einer bestimmten mobilen App generiert werden, können an einen konfigurierten DAP für mobile Apps im IVR-Menü gesendet werden. Es werden speziell für mobile Apps entwickelte Mitteilungen angewendet.
Ähnlich wie eine mobile App über DAP einem Menü für die Warteschlange für Mobilgeräte auf oberster Ebene zugewiesen wird, kann eine mobile App über einen DAP vom Typ „Mobile App“ einer IVR-Warteschlange zugewiesen werden.
Rufen Sie Einstellungen > Warteschlange > IVR | Bearbeiten / Ansehen auf.
Klicken Sie auf eine Queue der obersten Ebene.
Scrollen Sie in den Einstellungen des Warteschlangenmenüs zum Abschnitt „Direktzugriffspunkt“.
Klicken Sie auf den Link Direkten Zugriffspunkt erstellen.
Wählen Sie Mobile App als Zugriffspunkttyp aus. Diese Option ist nur für Warteschlangenmenüs der obersten Ebene verfügbar.
Benennen Sie den Zugangspunkt.
Wählen Sie die mobile App aus, der Sie diese Warteschlangenmenüstruktur zuweisen möchten.
Jede mobile App kann nur einmal als DAP in der gesamten IVR-Warteschlangenstruktur angewendet werden. Eine mobile App, die bereits einer anderen Warteschlange der obersten Ebene zugewiesen wurde, kann nicht für eine andere Warteschlange der obersten Ebene ausgewählt werden.
Klicke zum Speichern auf Erstellen.
Grenzfall: Wählen von „0“
Bei PSTN-Fallback-Szenarien für IVR kann ein Endnutzer anfangs zur Spitze der IVR-Warteschlangenstruktur navigieren, indem er einmal oder je nach Position in der Warteschlange die erforderliche Anzahl von Malen die Ziffer „0“ drückt.
Das lässt sich vermeiden, indem Sie das Routing für „0 wählen“ pro Warteschlange aktualisieren. So können Sie verhindern, dass ein Nutzer versehentlich die mobile Warteschlange erreicht.
Schritt 6: Mitteilungen einrichten
Auf der Seite Einstellungen > Nachrichten und Sprachen können Sie die folgenden Nachrichten für jede mobile App anpassen:
Nachricht außerhalb der Geschäftszeiten
Akustische Nachrichten
- Damit hörbare Mitteilungen pro App angegeben werden können, muss die DAP für mobile Apps (für jede mobile App) auf die entsprechenden IVR-Menü-Apps angewendet werden. Siehe Schritt 5 – Zuweisung von DAP für mobile Apps zum IVR-Warteschlangenmenü.
Mailboxnachricht
IVR-Nachrichten (mit Ausnahme der Nachrichten zum Kaufvorgang)
Benutzerdefinierte Rückrufbenachrichtigungen
Wichtig:Die Drop-down-Auswahl für den Channel regelt automatisch alle Nachrichtenkonfigurationen, die sowohl im Abschnitt „Mobile- und Web-SDK“ als auch im Abschnitt „Audible Messages“ für die ausgewählte mobile App aufgeführt sind. Es gibt jedoch folgende Ausnahmen:
IVR-Meldungen zum Kaufvorgang
Alle IVR-spezifischen Nachrichten können nur für Englisch konfiguriert werden.
Schritt 7: Aktivierung der mobilen App
Gehen Sie zu Einstellungen > Entwicklereinstellungen.
Kehren Sie zum Abschnitt zur Verwaltung von mobilen Apps zurück. Der Schalter für die mobile App „Aus / Aktivieren“ ist jetzt aktiviert.
Stellen Sie den Schalter auf Aktiv, um die mobile App zu aktivieren.
Aktivierte App: Eine vorhandene mobile App wird auf den MMA-Modus umgestellt.
Nach der Aktivierung:
Neue Apps: Alle neuen Apps werden automatisch im MMA-Modus generiert.
Zusätzliche Apps: Auf dieser Seite können Sie mehrere Apps definieren und verwalten.
Schritt 8: Push-Benachrichtigungen testen
Sie können jetzt die Push-Benachrichtigungsfunktion für jede mobile App einzeln testen. Über ein Drop-down-Menü kann der Administrator/Entwickler die mobile App auswählen, mit der der Test durchgeführt werden soll.
Änderungen bei aktiviertem MMA-Modus
Änderungen an den Portaleinstellungen
Nachdem Sie Ihre mobile App auf MMA umgestellt oder Ihre erste MMA-App erstellt haben, werden die folgenden Änderungen angewendet:
Der Bereich Einstellungen > Betriebsmanagement > SMS-Links senden wird von der Seite entfernt. Diese Konfiguration ist dann über das Pop-up-Fenster für die Konfiguration der mobilen App zugänglich.
In-App-Warteschlangenstruktur: Möglichkeit, einer Warteschlange auf oberster Ebene einen DAP für mobile Apps zuzuweisen.
Einstellungen > Sprachen & Mitteilungen: Die Möglichkeit, bestimmte Mitteilungen für jede mobile App auszuwählen, wird hinzugefügt.
IVR-Warteschlangenstruktur: Möglichkeit, einer DAP für mobile Apps Warteschlangen der obersten Ebene für die englische Sprache zuzuweisen.
Einstellungen > Entwicklereinstellungen > Push-Benachrichtigungen testen: Es wird ein Drop-down-Menü für mobile Apps hinzugefügt. Wählen Sie die entsprechende App aus, für die Sie das Senden von Benachrichtigungen testen möchten.
Agent Call Adapter: Es wurde eine Liste zur Auswahl von Apps hinzugefügt, über die Links zum Installieren und Öffnen der App per SMS gesendet werden können.
Änderungen am Ablauf von mobilen Sitzungen
Sitzungsablauf im mobilen Menü mit aktiviertem MMA-Modus
Anrufe / Chats: Wenn der MMA-Modus aktiviert ist, werden alle eingehenden Anrufe und Chats direkt der entsprechenden mobilen App zugewiesen, die über die Mobile App DAP im Menü der Warteschlange auf höchster Ebene zugewiesen wurde.
Mobile SDK-Menü: Wenn eine mobile App einer In-App-Warteschlange der obersten Ebene zugewiesen und aktiviert wurde, ruft das SDK nur Menüelemente in dem zugewiesenen In-App-Menü der obersten Ebene ab, dem es über DAP zugewiesen wurde.
Sprachen:Die Sprachen der mobilen Warteschlange werden automatisch angewendet.
Änderungen an Agent-Adaptern und Aktionen
Sitzungsübertragungen
Für Sitzungsübertragungen gelten die folgenden Regeln:
Weiterleitungen an die Warteschlange
Sitzungen, die von „Mobile App A“ stammen, können nur über die Benutzeroberfläche für die Übertragung des Agent-Anrufadapters an (Unter-)Warteschlangen innerhalb der übergeordneten Warteschlange dieser App übertragen werden. Ein Kundenservicemitarbeiter, der eine Sitzung für die mobile App A an eine andere Warteschlange weiterleiten möchte, kann nur Folgendes tun:
Zielwarteschlangen ansehen in der übergeordneten Ausgangswarteschlange, z. B. der übergeordneten Warteschlange von „Mobile App A“.
Wählen Sie in der ursprünglichen übergeordneten Warteschlange eine Zielwarteschlange aus.
An Agenten weiterleiten: Eine Sitzung kann an jeden verfügbaren Agenten weitergeleitet werden, auch an Agenten, die keiner Warteschlange in der übergeordneten Warteschlange „Mobile App A“ zugewiesen sind.
- Überlegungen zur Folgeübertragung = dieselben Regeln wie für den ursprünglichen Übertragungs-Agent, Warteschlangenoptionen
SMS-Nachrichten vom Typ „App installieren“ / „App öffnen“ senden
In den folgenden Szenarien muss der Kundenservicemitarbeiter das entsprechende Mobilgerät auswählen, bevor er die App-Informationen per SMS senden kann, d.h. „SMS zum Installieren senden“ und „SMS zum Öffnen der App senden“ für:
Ausgehende Anrufe
IVR-Anrufe
Wenn im Agent-Adapter mehrere mobile Apps konfiguriert wurden und der Agent entweder einen ausgehenden Anruf tätigt oder einen eingehenden IVR-Anruf bearbeitet, wird ihm nach Auswahl einer der SmartActions „SMS zum Installieren / Öffnen der App senden“ ein zweiter Bildschirm angezeigt, auf dem er die entsprechende mobile App auswählen kann. In der Liste werden die Namen der aktiven, konfigurierten mobilen Apps angezeigt.
Linker Bildschirm der mobilen App – verschiedene SMS-/SmartAction-Optionen
Rechter Bildschirm der mobilen App: Die Option „SMS zum Installieren der App senden“ ist ausgewählt. Der Kundenservicemitarbeiter wählt dann die entsprechende App aus. In dieser Liste werden die tatsächlich konfigurierten App-Namen angezeigt, z. B. „App1“ und „App2“ in diesem Beispiel.