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

Navigieren Sie zu Bot > Anbieter und scrollen Sie nach unten zum Abschnitt PhoneServer-Anbieter oder greifen Sie über die Anbieterseite darauf zu.

PhoneServer-Anbieter

PhoneServer-Verbindungsgesundheit

Die Tabelle zur PhoneServer-Verbindungsgesundheit zeigt alle PhoneServer an, die jemals mit der Plattform verbunden waren.

PhoneServer-Verbindungsgesundheit

Überwachung der Gesundheitsprüfung

  • Getrennte 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
VersucheAnzahl der Synchronisierungsversuche
FehlerFehlermeldung, wenn die Synchronisierung fehlgeschlagen ist
AktionenManuelle Resync-Taste

Synchronisierungsstatus-Werte

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. PhoneServer nach einer Trennung wieder verbunden wird
  4. Die Konfiguration des Telefonkanals geändert wird

Manuelle Resynchronisierung

Um eine manuelle Resynchronisierung auszulösen:

  1. Finden Sie den Anbieter in der Tabelle
  2. Klicken Sie auf die Resync-Taste (Kreis-Pfeil-Symbol) in der Spalte Aktionen
  3. Warten Sie, bis sich der Status aktualisiert

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


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 Bot > Anbieter und bearbeiten Sie den Anbieter
  3. Überprüfen und aktualisieren Sie die Anmeldeinformationen bei Bedarf
  4. Speichern Sie den Anbieter
  5. Klicken Sie auf Resync in der PhoneServer-Anbietertabelle

Anbieter bleibt auf "PENDING"

Dies kann anzeigen:

  • PhoneServer-Verbindungsprobleme
  • Hohe Serverauslastung
  • 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 im Telefonkanal-Header
  4. Wenn immer noch ausstehend, versuchen Sie eine manuelle Resynchronisierung

"Nie" in der Spalte Letzte Sync

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

  • Anbieter wurde gerade erstellt
  • Alle Synchronisierungsversuche sind fehlgeschlagen
  • PhoneServer hat sich noch nie verbunden

Schritte zur Behebung:

  1. Überprüfen Sie, ob der PhoneServer verbunden ist (überprüfen Sie den Telefonkanal-Header)
  2. Überprüfen Sie die Anbieterkonfiguration
  3. Klicken Sie auf Resync, um einen neuen Synchronisierungsversuch auszulösen

Mehrere fehlgeschlagene Versuche

Wenn die Versuche-Spalte eine hohe Zahl anzeigt (z. B. 5+):

  • Es könnte ein anhaltendes Konfigurationsproblem vorliegen
  • Die Anmeldeinformationen des Anbieters könnten ungültig sein
  • Der externe Dienst könnte nicht verfügbar sein

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 zurücksetzen, indem Sie den Anbieter bearbeiten und speichern

Verbindungsstatus

Der Verbindungsstatus des PhoneServers wird im Telefonkanal-Header angezeigt:

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

Wenn der PhoneServer getrennt ist:

  • Anbieter-Synchronisierungen werden in die Warteschlange gestellt
  • Telefonanrufe können nicht verarbeitet werden
  • Kontaktieren Sie Ihren Administrator

Anbieter-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 weiter Fehler beheben

Verwandte Dokumentation