Najczęstsze błędy

Ten przewodnik opisuje najczęstsze błędy, które mogą wystąpić podczas korzystania z Conviro, oraz sposoby ich rozwiązania.

HTTP 401 -- Unauthorized

Znaczenie: Twój klucz API lub token sesji jest nieprawidłowy albo wygasł.

Przyczyny i rozwiązania:

• Nieprawidłowy klucz API -- sprawdź klucz w Dashboard -> Settings -> API Keys
• Klucz API został unieważniony -- wygeneruj nowy klucz i zaktualizuj swoją integrację
• Sesja wygasła -- wyloguj się z panelu i zaloguj ponownie
• Brak nagłówka Authorization -- upewnij się, że Twoje żądanie do API zawiera Authorization: Bearer sk_your_key

HTTP 403 -- Forbidden

Znaczenie: Nie masz uprawnień dostępu do tego zasobu.

Przyczyny i rozwiązania:

• Domena niedozwolona -- dodaj domenę swojej witryny w Dashboard -> Assistants -> Your Bot -> Channels -> Allowed Domains
• Osiągnięto limit planu -- próbujesz użyć funkcji niedostępnej w Twoim obecnym planie (np. WhatsApp w planie Starter)
• Ograniczenie roli -- Twoja rola w zespole (Agent) może nie mieć uprawnień do tej czynności; poproś osobę z rolą Admin lub Owner
• Bot jest nieaktywny -- aktywuj bota w Dashboard -> Assistants

HTTP 404 -- Not Found

Znaczenie: Żądany zasób nie istnieje.

Przyczyny i rozwiązania:

• Nieprawidłowy endpoint -- sprawdź poprawne adresy URL w dokumentacji API pod adresem /developers
• Usunięty zasób -- chatbot, sesja lub kontakt został usunięty
• Literówka w ID -- sprawdź identyfikator zasobu w adresie URL żądania

HTTP 429 -- Too Many Requests (limit żądań)

Znaczenie: Przekroczono limit żądań do API przewidziany w Twoim planie.

Przyczyny i rozwiązania:

• Sprawdź nagłówki limitu żądań w odpowiedzi:

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

• Zmniejsz częstotliwość żądań -- dodaj opóźnienia lub grupuj operacje
• Przejdź na wyższy plan -- wyższe plany mają wyższe limity żądań
• Buforuj odpowiedzi -- unikaj wielokrotnego wysyłania tego samego żądania

Limity żądań według planu:

Błędy CORS

Znaczenie: Przeglądarka blokuje żądanie cross-origin.

Objaw: W konsoli przeglądarki pojawia się błąd w rodzaju Access to XMLHttpRequest has been blocked by CORS policy.

Przyczyny i rozwiązania:

• Domena widżetu jest niedozwolona -- dodaj swoją domenę do listy Allowed Domains
• Mieszana treść -- jeśli widżet ładuje się przez HTTPS, upewnij się, że Twoja witryna również używa HTTPS (a nie HTTP)
• Zakłócenia proxy lub CDN -- sprawdź, czy Twój CDN nie usuwa nagłówków CORS

Nieudane dostarczenia webhooków

Znaczenie: Conviro wysłało webhook, ale Twój serwer nie odpowiedział kodem statusu 2xx.

Przyczyny i rozwiązania:

• Serwer nie działa -- sprawdź, czy endpoint webhooka działa i jest dostępny
• Przekroczony limit czasu -- Conviro czeka na odpowiedź 10 sekund. Upewnij się, że Twój endpoint odpowiada szybko
• Problem z certyfikatem SSL -- Twój endpoint musi mieć ważny certyfikat SSL (certyfikaty samopodpisane nie są akceptowane)
• Blokada zapory sieciowej -- dodaj zakres adresów IP Conviro do listy dozwolonych w swojej zaporze
• Nieprawidłowy adres URL -- zweryfikuj adres URL webhooka w Dashboard -> Settings -> Webhooks

Zasady ponawiania: Conviro ponawia nieudane webhooki 3 razy z wykładniczym opóźnieniem (1 min, 5 min, 30 min). Po 3 niepowodzeniach webhook zostaje oznaczony jako nieudany, a Ty otrzymujesz powiadomienie e-mail.

Dzienniki dostarczania sprawdzisz w Dashboard -> Settings -> Webhooks -> Delivery Log.

Osiągnięto limit wiadomości

Znaczenie: Wykorzystano wszystkie miesięczne wiadomości.

Przyczyny i rozwiązania:

• Free/Starter -- rozmowy zostają wstrzymane do następnego okresu rozliczeniowego. Przejdź na wyższy plan, aby uzyskać więcej wiadomości.
• Pro/Growth -- włącz rozliczanie przekroczeń w Dashboard -> Settings -> Billing, aby automatycznie dokupować dodatkowe pakiety wiadomości.
• Sprawdź zużycie -- monitoruj swoje zużycie w Dashboard -> AI Usage.

Ogólne wskazówki

• W przypadku błędów po stronie klienta zawsze sprawdzaj konsolę przeglądarki (F12).
• Przy błędach API przeanalizuj treść odpowiedzi -- zwykle zawiera opisowy komunikat o błędzie.
• Sprawdź stronę statusu Conviro, aby dowiedzieć się o trwających awariach lub pracach serwisowych.
• Jeśli nie uda Ci się rozwiązać problemu, napisz na [email protected], podając szczegóły błędu, identyfikator żądania (jeśli jest dostępny) oraz kroki umożliwiające odtworzenie problemu.