Zum Hauptinhalt springen

Grundeinstellungen

Der Tab "Grundeinstellungen" enthält allgemeine Konfigurationen des Telefonkanals, einschließlich Aufnahmeoptionen, Anruflimits und Regeln zur Telefonblockierung.

Allgemeine Einstellungen​

Allgemeine Einstellungen

Aufnahme​

Steuert, ob das Gespräch zwischen dem Anrufer und dem Bot aufgezeichnet wird.

OptionBeschreibung
NieDas Bot-Gespräch wird nie aufgezeichnet
Auf AnfrageDie Aufnahme kann während des Anrufs programmatisch mit tracker_api.enable_recording() aktiviert werden
ImmerDas Bot-Gespräch wird immer automatisch aufgezeichnet

Aufnahme nach einer Livechat-Übergabe​

Diese Einstellung gilt nicht, nachdem der Anruf mit tracker_api.livechat_phone_handover() an einen Live-Agenten übergeben wurde. Die Aufnahme des Anrufers und des Agenten wird separat, pro Übergabe, mit den Parametern record_caller und record_agent konfiguriert:

WertBeschreibung
manual (Standard)Der Agent kann während des Anrufs eine Aufnahme im Livechat starten und stoppen
alwaysDas gesamte Gespräch wird ab dem Moment aufgezeichnet, in dem der Agent antwortet
neverDer Teilnehmer kann nicht aufgezeichnet werden, nicht einmal manuell durch den Agenten
tracker_api.livechat_phone_handover(
    record_caller='never',
    record_agent='never',
)

Da der Standard manual ist, können Agenten übergebene Anrufe aufzeichnen, selbst wenn Aufnahme auf Nie gesetzt ist. Geben Sie never explizit an, wenn übergebene Anrufe nicht aufgezeichnet werden dürfen.

Hinweis: Aufnahmeeinstellungen können gesetzlichen Anforderungen in Ihrer Gerichtsbarkeit unterliegen. Stellen Sie sicher, dass Sie die geltenden Gesetze bezüglich Anrufaufzeichnung und Benutzerzustimmung einhalten.

Anruf-IDs​

Erforderliches Feld, wenn der Telefonkanal aktiviert ist.

Anruf-IDs identifizieren, welche Telefonleitungen zu diesem Bot geleitet werden. Geben Sie eine oder mehrere Telefonnummern oder Kennungen ein, die Ihr Telefonsystem zur Anrufweiterleitung verwendet.

  • Das Format hängt von der Konfiguration Ihres Telefonsystems ab
  • Mehrere Anruf-IDs können hinzugefügt werden, um Anrufe von verschiedenen Leitungen zu bearbeiten

Maximale Gesamtanzahl von Turns​

Maximale Anzahl von Gesprächswechseln (Benutzer-Bot-Austausch), die in einem einzigen Anruf erlaubt sind. Wenn überschritten, beendet der Bot das Gespräch.

  • Standard: 50 Turns
  • Anwendungsfall: Verhindern von endlosen Gesprächen oder Missbrauch

Maximale Turn-Länge​

Maximale Länge (in Sekunden) für einen einzelnen Turn. Wenn ein Benutzer länger als dieses Limit spricht, beendet der Bot das Gespräch.

  • Standard: 60 Sekunden
  • Anwendungsfall: Verhindern sehr langer Monologe

SIP-Header​

SIP-Header, die aus der eingehenden INVITE-Anfrage extrahiert und beim Gesprächsbeginn an den Voicebot übergeben werden. Diese Header sind in Ihren Flows für Routing oder Kontext verfügbar.

  • Geben Sie Header-Namen ohne das Präfix X- ein
  • Header sind in den Metadaten des Gesprächs verfügbar

Standardnachrichten​

Wartungsmodus Telefon

Konfigurieren Sie die Standardnachrichten, die Anrufer in bestimmten Situationen hören werden.

Fehlermeldung​

Erforderliches Feld - Nachricht, die Anrufern abgespielt wird, wenn:

  • Ein technischer Fehler während des Anrufs auftritt
  • Ein Sicherheitsabbruch durchgeführt wird
  • Der Anruf durch Blockierungsregeln blockiert wurde

Geben Sie eine Nachricht ein, die mit Text-zu-Sprache abgespielt wird. Diese Nachricht sollte den Anrufer darüber informieren, dass der Dienst vorübergehend nicht verfügbar ist.

Beispiel: Entschuldigen Sie bitte, aber aktuell ist der Service nicht verfügbar.

Wartungsmodus-Nachricht​

Nachricht, die Anrufern abgespielt wird, wenn der Bot im Wartungsmodus ist.

Geben Sie eine Nachricht ein, die mit Text-zu-Sprache abgespielt wird. Diese Nachricht sollte den Anrufer darüber informieren, dass der Dienst aufgrund von Wartungsarbeiten nicht verfügbar ist.

Beispiel: Entschuldigen Sie bitte, aber aktuell ist der Service aufgrund von Wartungsarbeiten nicht verfügbar.

Nachricht bei Erreichen des Anruflimits​

Nachricht, die Anrufern abgespielt wird, wenn Ihr Bot die maximale Anzahl gleichzeitiger Anrufe erreicht hat und derzeit keine weiteren annehmen kann.

Geben Sie eine Nachricht ein, die mit Text-zu-Sprache abgespielt wird und den Anrufer darüber informiert, dass alle Leitungen derzeit belegt sind und er es in Kürze erneut versuchen sollte.

Beispiel: Alle unsere Leitungen sind derzeit belegt. Bitte versuchen Sie es in ein paar Minuten erneut.

Hinweis: Die Anzahl der Anrufe, die Ihr Bot gleichzeitig bearbeiten kann, wird für jede Umgebung separat konfiguriert, sodass sie von einer Umgebung zur anderen unterschiedlich sein kann. Wenden Sie sich an Ihren Administrator, wenn Sie das Limit für Ihre Umgebung erfahren oder ändern möchten.

Wartungsnachricht-Umschalter​

Steuert, ob die Wartungsmodus-Nachricht an Anrufer abgespielt wird oder stattdessen ein technischer Fehlercode zurückgegeben wird.

ZustandVerhalten
AktiviertSpielt die oben definierte benutzerdefinierte Wartungsnachricht für den Anrufer ab
DeaktiviertGibt einen SIP-Abbruchursachencode an das ursprüngliche Telefonsystem zurück, anstatt eine Nachricht abzuspielen

Technische Details (Deaktivierter Zustand)​

Wenn der Umschalter deaktiviert ist, beendet der Telefonserver den Anruf mit einem SIP-Abbruchursachencode anstelle der Wartungsnachricht. Dies ist nützlich für:

  • Komplexe Bereitstellungen, bei denen vorgelagerte Systeme (PBX, IVR, Anrufrouter) Wartungszustände programmatisch handhaben müssen
  • Automatisierte Failover-Szenarien, bei denen das anrufende System den Anruf basierend auf dem Abbruchcode woanders hinleiten sollte
  • Überwachungs- und Alarmsysteme, die Anrufdispositionscodes verfolgen

Die aktuelle Implementierung gibt Abbruchursache 21 (CALL_REJECTED) zurück, was dem ursprünglichen Telefonsystem signalisiert, dass der Anruf absichtlich abgelehnt wurde.

Wichtig:

  • Die Wartungsnachricht wird mit dem Telefonserver synchronisiert, wenn Sie auf Speichern klicken
  • Es kann bis zu 60 Sekunden dauern, bis Änderungen nach dem Speichern aktiv werden
  • Weitere Informationen zum Wartungsmodus finden Sie unter Bot-Einstellungen

Telefonblockierungseinstellungen​

Telefonblockierungseinstellungen

Die Telefonblockierung ermöglicht es Ihnen, bestimmte Anrufer daran zu hindern, Ihren Bot zu erreichen.

Hinweis: Das Format der Telefonnummern muss dem Format entsprechen, das der verbundene Telefonserver erhält (z. B. führende 0049, +49, 49).

Blockierte Telefonnummern​

Eine Liste spezifischer Telefonnummern, die daran gehindert werden, den Bot anzurufen.

  • Geben Sie vollständige Telefonnummern ein
  • Anrufe von diesen Nummern werden abgelehnt

Beispiel: +4912345678901

Blockierte Präfixe​

Eine Liste von Telefonnummernpräfixen, die blockiert sind. Jede Nummer, die mit diesen Präfixen beginnt, wird abgelehnt.

  • Nützlich zum Blockieren ganzer Vorwahlen oder Ländercodes
  • Geben Sie das Präfix ohne Platzhalter ein

Beispiel: 0049 blockiert alle Nummern, die mit 0049 beginnen

Blockierte Telefonnummernbereiche​

Eine Liste von Telefonnummernbereichen, die blockiert sind. Nummern, die in diese Bereiche fallen, werden abgelehnt.

  • Geben Sie Bereiche im von Ihrem Telefonsystem erwarteten Format ein
  • Nützlich zum Blockieren großer Nummernblöcke

Beispiel: 4912345670000 - 4912345679999 blockiert alle Nummern in diesem Bereich

Überwachung​

Die Überwachungsfunktion ermöglicht es Ihnen, regelmäßige Statusaktualisierungen über Ihren Telefonkanal an einen externen Überwachungsendpunkt zu senden. Dies ist nützlich für Gesundheitsprüfungen und betriebliche Überwachung.

Überwachungseinstellungen

Live-Überwachung aktivieren​

Steuert, ob Live-Überwachungsdaten regelmäßig an einen externen Endpunkt gesendet werden.

OptionBeschreibung
AktiviertÜberwachungsanfragen werden in dem festgelegten Intervall an die konfigurierte URL gesendet
DeaktiviertEs werden keine Live-Überwachungsdaten gesendet

Live-Überwachungs-URL​

Die HTTP(S)-Endpunkt-URL, an die Live-Überwachungsdaten über GET-Anfragen gesendet werden, wobei Status und Nachricht als Abfrageparameter gesendet werden.

  • Muss eine gültige HTTP- oder HTTPS-URL sein
  • Ihr Endpunkt sollte auf regelmäßige Anfragen vorbereitet sein

Beispiel: https://your-monitoring-url.com/endpoint

Live-Überwachungsintervall in Sekunden​

Das Zeitintervall (in Sekunden) zwischen jeder Live-Überwachungsanfrage.

Standard: 60 Sekunden

Vorfallüberwachung aktivieren​

Steuert, ob Vorfallüberwachungsdaten regelmäßig an einen externen Endpunkt gesendet werden.

OptionBeschreibung
AktiviertVorfallüberwachungsanfragen werden in dem festgelegten Intervall an die konfigurierte URL gesendet
DeaktiviertEs werden keine Vorfallüberwachungsdaten gesendet

Vorfallüberwachungs-URL​

Die HTTP(S)-Endpunkt-URL, an die Vorfallüberwachungsdaten über GET-Anfragen gesendet werden, wobei Status und Nachricht als Abfrageparameter gesendet werden.

  • Muss eine gültige HTTP- oder HTTPS-URL sein
  • Ihr Endpunkt sollte auf regelmäßige Anfragen vorbereitet sein

Beispiel: https://your-monitoring-url.com/endpoint

Vorfallüberwachungsintervall in Sekunden​

Das Zeitintervall (in Sekunden) zwischen jeder Vorfallüberwachungsanfrage.

Standard: 60 Sekunden

Hinweis:

  • Jeder Überwachungsendpunkt muss vom Telefonserver aus zugänglich sein
  • Fehlgeschlagene Überwachungsanfragen werden nicht erneut versucht, sondern beim nächsten Intervall erneut versucht
  • Live- und Vorfallüberwachung können unabhängig voneinander aktiviert werden

Änderungen speichern​

Nach der Konfiguration Ihrer Einstellungen:

  1. Klicken Sie auf die Schaltfläche Speichern oben rechts
  2. Warten Sie, bis der Synchronisierungsstatus Synchronisiert anzeigt
  3. Überprüfen Sie, ob der Verbunden-Status beibehalten wird

Hinweis: Änderungen an den Telefonblockierungseinstellungen werden sofort nach Abschluss der Synchronisierung wirksam.

Verwandte Dokumentation​