Zum Hauptinhalt springen

PhoneServer-Anbieter

Das PhoneServer-Anbieter-Panel zeigt den Synchronisierungsstatus mit dem PhoneServer an. Dies hilft Ihnen, die Gesundheit der Anbieter zu überwachen und Verbindungsprobleme zu beheben.

Zugriff auf PhoneServer-Anbieter​

Das PhoneServer-Anbieter-Panel ist eine eigene Seite auf oberster Ebene. Öffnen Sie im Abschnitt Global der Seitenleiste Phone Server (erfordert die Rolle des Anbietermanagers).

PhoneServer-Anbieter

Die Seite hat drei Panels — Phone Server-Anbieter (Synchronisierungsstatus pro Anbieter), PhoneServer-Verbindungsgesundheit und Letzte Synchronisierungsereignisse (alle Anbieter) — sowie eine Erneut synchronisieren-Schaltfläche oben rechts, die alle STT- und TTS-Anbieter auf einmal neu synchronisiert.

PhoneServer-Verbindungsgesundheit​

Die PhoneServer-Verbindungsgesundheitstabelle zeigt alle PhoneServer an, die jemals mit der Plattform verbunden waren.

PhoneServer-Verbindungsgesundheit

Überwachung der Gesundheitsprüfung​

  • Nicht verbundene PhoneServer erscheinen in der Plattform-Gesundheitsprüfung unter /api/health
  • Dies ermöglicht die Überwachung von Verbindungsproblemen bei allen registrierten PhoneServern

Bereinigung von Verbindungen​

Wenn ein PhoneServer nicht mehr mit der Plattform kommunizieren soll (z. B. wurde er nur für eine Demo verwendet), können Sie ihn aus den Gesundheitsprüfungen entfernen, indem Sie auf die Löschtaste klicken. Dadurch wird verhindert, dass er in den Ergebnissen der Gesundheitsprüfung erscheint.

Verständnis der Anbietertabelle​

Die Tabelle zeigt alle STT- und TTS-Anbieter mit ihrem Synchronisierungsstatus an:

SpalteBeschreibung
TitelAnbietername mit einem Symbol, das STT (Mikrofon) oder TTS (Lautsprecher) anzeigt
TypSTT für Speech-to-Text, TTS für Text-to-Speech
StatusAktueller Synchronisierungsstatus
Letzte SyncZeitstempel der letzten erfolgreichen Synchronisierung oder "Nie", wenn nicht synchronisiert
FehlerFehlermeldung, wenn die Synchronisierung fehlgeschlagen ist

Synchronisierungsstatuswerte​

StatusAbzeichenfarbeBedeutung
SYNCEDGrünAnbieter ist erfolgreich mit PhoneServer synchronisiert
PENDINGGrauSynchronisierung läuft oder ist in der Warteschlange
FAILEDRotSynchronisierung fehlgeschlagen - Fehlermeldung überprüfen
DIRTYGelbKonfiguration geändert, erneute Synchronisierung erforderlich

Filterung von Anbietern​

Verwenden Sie die Filtertasten oben rechts, um anzuzeigen:

  • Alle - Alle STT- und TTS-Anbieter
  • STT - Nur Speech-to-Text-Anbieter
  • TTS - Nur Text-to-Speech-Anbieter

Synchronisierungsprozess​

Automatische Synchronisierung​

Anbieter werden automatisch synchronisiert, wenn:

  1. Ein neuer Anbieter erstellt wird
  2. Ein bestehender Anbieter aktualisiert wird
  3. Ein Anbieter für einen Bot unter Bot → Anbieter aktiviert wird
  4. PhoneServer nach einer Trennung wieder verbunden wird
  5. Die Konfiguration des Telefonkanals geändert wird

Jeder dieser Auslöser führt zu einer vollständigen Synchronisierung: Jeder aktivierte STT- und TTS-Anbieter des Mandanten wird zusammen mit allen Telefonkanalkonfigurationen an den PhoneServer gesendet, nicht nur der geänderte Anbieter. Anbieter, die für keinen Bot aktiviert sind, werden übersprungen — der PhoneServer erhält nur Anbieter, die ein Bot tatsächlich verwendet.

Die Synchronisierung erfordert einen verbundenen PhoneServer. Solange kein PhoneServer verbunden ist, werden Synchronisierungen nicht in die Warteschlange gestellt: Ein geänderter Anbieter bleibt als DIRTY ("Erneute Synchronisierung erforderlich") zurück. Das nächste Mal, wenn ein PhoneServer verbunden wird, erhält er automatisch eine vollständige Synchronisierung und diese Anbieter kehren zu SYNCED zurück.

Manuelle erneute Synchronisierung​

Um eine erneute Synchronisierung manuell auszulösen, klicken Sie oben rechts auf der Seite auf Erneut synchronisieren. Dadurch werden alle aktivierten STT- und TTS-Anbieter auf einmal neu synchronisiert. Das erneute Speichern eines Anbieters unter Anbieterverwaltung hat denselben Effekt.

Tipp: Verwenden Sie Erneut synchronisieren, wenn ein Anbieter nach Behebung des zugrunde liegenden Problems den Status "FAILED" anzeigt.

Hinweis: Erneut synchronisieren schlägt mit einem Fehler fehl, wenn kein PhoneServer verbunden ist. Überprüfen Sie zuerst die PhoneServer-Verbindungsgesundheitstabelle.

Fehlerbehebung bei Synchronisierungsproblemen​

Anbieter zeigt "FAILED"​

Häufige Ursachen:

  • Ungültige API-Anmeldeinformationen - Überprüfen Sie, ob Ihr API-Schlüssel korrekt ist
  • Netzwerkverbindung - Überprüfen Sie, ob die API des Anbieters erreichbar ist
  • Konfigurationsfehler - Überprüfen Sie die Anbietereinstellungen
  • Dienstunterbrechung - Überprüfen Sie die Statusseite des Anbieters

Schritte zur Behebung:

  1. Überprüfen Sie die Fehler-Spalte auf Details
  2. Navigieren Sie zu Anbieterverwaltung und bearbeiten Sie den Anbieter
  3. Überprüfen und aktualisieren Sie die Anmeldeinformationen bei Bedarf
  4. Speichern Sie den Anbieter — das Speichern löst bereits eine erneute Synchronisierung aus
  5. Wenn sich der Status nicht ändert, klicken Sie auf Erneut synchronisieren

Anbieter bleibt auf "PENDING"​

PENDING bedeutet, dass der Anbieter an den PhoneServer gesendet wurde, aber keine Bestätigung zurückkam. Dies kann darauf hinweisen:

  • Der PhoneServer wurde während der Synchronisierung getrennt
  • Hohe Serverlast
  • Netzwerkverzögerung

Schritte zur Behebung:

  1. Warten Sie einen Moment, bis die Synchronisierung abgeschlossen ist
  2. Aktualisieren Sie die Seite
  3. Überprüfen Sie den Verbindungsstatus des PhoneServers in der PhoneServer-Verbindungsgesundheitstabelle
  4. Wenn immer noch ausstehend, klicken Sie auf Erneut synchronisieren

"Nie" in der Spalte Letzte Synchronisierung​

Der Anbieter wurde noch nie erfolgreich synchronisiert. Dies bedeutet typischerweise:

  • Anbieter wurde gerade erstellt
  • Anbieter ist für keinen Bot aktiviert, daher wird er nie an den PhoneServer gesendet
  • Alle Synchronisierungsversuche sind fehlgeschlagen
  • PhoneServer hat sich nie verbunden

Schritte zur Behebung:

  1. Überprüfen Sie, ob der PhoneServer verbunden ist (überprüfen Sie die PhoneServer-Verbindungsgesundheitstabelle)
  2. Überprüfen Sie, ob der Anbieter für mindestens einen Bot unter Bot → Anbieter aktiviert ist
  3. Überprüfen Sie die Anbieterkonfiguration
  4. Klicken Sie auf Erneut synchronisieren, um einen neuen Synchronisierungsversuch auszulösen

Anbieter kehrt immer wieder zu "FAILED" zurück​

Wenn ein Anbieter nach jeder erneuten Synchronisierung erneut fehlschlägt:

  • Es kann ein anhaltendes Konfigurationsproblem vorliegen
  • Die Anmeldeinformationen des Anbieters sind möglicherweise ungültig
  • Der externe Dienst ist möglicherweise nicht verfügbar

Schritte zur Behebung:

  1. Überprüfen Sie, ob der externe Dienst betriebsbereit ist
  2. Überprüfen Sie alle Anmeldeinformationen des Anbieters doppelt
  3. Testen Sie den Anbieter in der eigenen Konsole des externen Dienstes
  4. Nach der Behebung durch Bearbeiten und Speichern des Anbieters zurücksetzen

Verbindungsstatus​

Der Verbindungsstatus des PhoneServers wird in der Kopfzeile des Telefonkanals angezeigt:

StatusBedeutung
VerbundenPhoneServer ist verbunden und kann Anrufe verarbeiten
GetrenntKeine Verbindung zum PhoneServer
FehlerEs ist ein Verbindungsfehler aufgetreten

Wenn der PhoneServer getrennt ist:

  • Anbietersynchronisierungen werden übersprungen und automatisch erneut ausgeführt, sobald er wieder verbunden ist
  • Telefonanrufe können nicht verarbeitet werden
  • Kontaktieren Sie Ihren Administrator

Anbieterspezifische Fehlermeldungen​

Häufige Fehlermeldungen und deren Bedeutungen:

FehlerBedeutungLösung
STT-Verarbeitung fehlgeschlagenSTT-Dienst hat die Konfiguration abgelehntÜberprüfen Sie API-Schlüssel und Spracheinstellungen
Fehler beim Empfang der TTS-AntwortTTS-Dienst hat einen Fehler zurückgegebenÜberprüfen Sie Anmeldeinformationen und Spracheinstellungen
VerbindungstimeoutKonnte den Anbieter nicht erreichenÜberprüfen Sie die Netzwerkverbindung
Ungültige AnmeldeinformationenAPI-Schlüssel ist falsch oder abgelaufenAktualisieren Sie die API-Anmeldeinformationen
Nicht unterstützte SpracheSprachcode wird nicht unterstütztÜberprüfen Sie die unterstützten Sprachen des Anbieters

Beste Praktiken​

Mehrere Anbieter​

  • Konfigurieren Sie Backup-Anbieter desselben Typs
  • Wenn ein Anbieter ausfällt, wechseln Sie in den Telefonkanaleinstellungen zum Backup
  • Verschiedene Anbieter haben unterschiedliche Stärken (Qualität vs. Latenz vs. Kosten)

Nach Konfigurationsänderungen​

  • Überprüfen Sie immer den Synchronisierungsstatus nach Änderungen der Anbietereinstellungen
  • Warten Sie auf den Status "SYNCED", bevor Sie die Telefonfunktionalität testen
  • Wenn die Synchronisierung fehlschlägt, überprüfen Sie die Fehlerdetails, bevor Sie weitere Schritte zur Fehlerbehebung unternehmen

Verwandte Dokumentation​