Häufige Fehler

Dieser Leitfaden behandelt die häufigsten Fehler, die bei der Nutzung von Conviro auftreten können, und deren Behebung.

HTTP 401 -- Unauthorized

Bedeutung: Ihr API-Schlüssel oder Sitzungstoken ist ungültig oder abgelaufen.

Ursachen & Lösungen:

• API-Schlüssel ist falsch -- überprüfen Sie den Schlüssel unter Dashboard -> Settings -> API Keys
• API-Schlüssel wurde widerrufen -- erstellen Sie einen neuen Schlüssel und aktualisieren Sie Ihre Integration
• Sitzung abgelaufen -- melden Sie sich vom Dashboard ab und wieder an
• Authorization-Header fehlt -- stellen Sie sicher, dass Ihre API-Anfrage Authorization: Bearer sk_your_key enthält

HTTP 403 -- Forbidden

Bedeutung: Sie haben keine Berechtigung für den Zugriff auf diese Ressource.

Ursachen & Lösungen:

• Domain nicht freigegeben -- fügen Sie die Domain Ihrer Website unter Dashboard -> Assistants -> Your Bot -> Channels -> Allowed Domains hinzu
• Plan-Limit erreicht -- Sie versuchen, eine Funktion zu nutzen, die in Ihrem aktuellen Plan nicht verfügbar ist (z. B. WhatsApp mit Starter)
• Rollenbeschränkung -- Ihre Teamrolle (Agent) hat für diese Aktion möglicherweise keine Berechtigung; wenden Sie sich an einen Admin oder Owner
• Bot ist inaktiv -- aktivieren Sie den Bot unter Dashboard -> Assistants

HTTP 404 -- Not Found

Bedeutung: Die angeforderte Ressource existiert nicht.

Ursachen & Lösungen:

• Falscher Endpunkt -- prüfen Sie die API-Dokumentation unter /developers auf die korrekten URLs
• Gelöschte Ressource -- der Chatbot, die Sitzung oder der Kontakt wurde gelöscht
• Tippfehler in der ID -- überprüfen Sie die Ressourcen-ID in der URL Ihrer Anfrage

HTTP 429 -- Too Many Requests (Rate Limiting)

Bedeutung: Sie haben das API-Rate-Limit Ihres Plans überschritten.

Ursachen & Lösungen:

• Prüfen Sie die Rate-Limit-Header in der Antwort:

X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

• Anfragehäufigkeit reduzieren -- fügen Sie Wartezeiten ein oder fassen Sie Vorgänge zusammen
• Plan upgraden -- höhere Pläne haben höhere Rate-Limits
• Antworten zwischenspeichern -- vermeiden Sie es, dieselbe Anfrage wiederholt zu senden

Rate-Limits nach Plan:

CORS-Fehler

Bedeutung: Der Browser blockiert eine Cross-Origin-Anfrage.

Symptom: In der Browser-Konsole erscheint eine Fehlermeldung wie Access to XMLHttpRequest has been blocked by CORS policy.

Ursachen & Lösungen:

• Widget-Domain nicht freigegeben -- fügen Sie Ihre Domain zur Liste Allowed Domains hinzu
• Gemischte Inhalte -- stellen Sie sicher, dass Ihre Website HTTPS (nicht HTTP) verwendet, wenn das Widget über HTTPS geladen wird
• Proxy- oder CDN-Störung -- prüfen Sie, ob Ihr CDN die CORS-Header entfernt

Fehlgeschlagene Webhook-Zustellungen

Bedeutung: Conviro hat einen Webhook gesendet, aber Ihr Server hat nicht mit einem 2xx-Statuscode geantwortet.

Ursachen & Lösungen:

• Server ist offline -- prüfen Sie, ob Ihr Webhook-Endpunkt läuft und erreichbar ist
• Zeitüberschreitung -- Conviro wartet 10 Sekunden auf eine Antwort. Stellen Sie sicher, dass Ihr Endpunkt schnell antwortet
• Problem mit dem SSL-Zertifikat -- Ihr Endpunkt muss über ein gültiges SSL-Zertifikat verfügen (selbstsignierte Zertifikate werden nicht akzeptiert)
• Firewall blockiert -- nehmen Sie den IP-Bereich von Conviro in die Whitelist Ihrer Firewall auf
• Falsche URL -- überprüfen Sie die Webhook-URL unter Dashboard -> Settings -> Webhooks

Wiederholungsrichtlinie: Conviro wiederholt fehlgeschlagene Webhooks 3-mal mit exponentiellem Backoff (1 Min., 5 Min., 30 Min.). Nach 3 Fehlversuchen wird der Webhook als fehlerhaft markiert und Sie erhalten eine E-Mail-Benachrichtigung.

Die Zustellprotokolle finden Sie unter Dashboard -> Settings -> Webhooks -> Delivery Log.

Nachrichtenlimit erreicht

Bedeutung: Sie haben alle Nachrichten Ihres Monatskontingents verbraucht.

Ursachen & Lösungen:

• Free/Starter -- Konversationen werden bis zum nächsten Abrechnungszeitraum pausiert. Wechseln Sie für mehr Nachrichten zu einem höheren Plan.
• Pro/Growth -- aktivieren Sie die Abrechnung von Zusatzkontingenten unter Dashboard -> Settings -> Billing, um automatisch zusätzliche Nachrichtenpakete zu erwerben.
• Verbrauch prüfen -- überwachen Sie Ihren Verbrauch unter Dashboard -> AI Usage.

Allgemeine Tipps

• Prüfen Sie bei clientseitigen Fehlern immer die Browser-Konsole (F12).
• Sehen Sie sich bei API-Fehlern den Antworttext an -- er enthält in der Regel eine aussagekräftige Fehlermeldung.
• Prüfen Sie die Conviro-Statusseite auf laufende Störungen oder Wartungsarbeiten.
• Wenn Sie das Problem nicht lösen können, schreiben Sie an [email protected] mit den Fehlerdetails, der Request-ID (falls vorhanden) und den Schritten zur Reproduktion.