Błędy i wsparcie

FAQ błędów: co znaczy komunikat i co z nim zrobić

Najczęstsze komunikaty panelu i API z przyczyną, rozwiązaniem i wskazaniem, kto je rozwiązuje.

Większość komunikatów ma proste obejście; gdy go brak, zgłoś błąd z panelu razem z identyfikatorem.

Lista jest generowana z kodu (fluxcrm/faq_bledow.py), a ten sam zbiór podpowiada rozwiązania w panelu i w czacie wsparcia.

Panel prosi o logowanie albo odpowiada 401

Kod odpowiedzi: 401

Przyczyna. Sesja wygasła (po dniach bez pracy albo po wylogowaniu z innego urządzenia) lub integracja używa błędnego klucza API.

Co zrobić. Zaloguj się ponownie. Dla integracji sprawdź nagłówek x-fluxcrm-klucz i to, czy klucz nie wygasł w Ustawieniach, Klucze API.

Kto rozwiązuje: ty.

Logowanie jest zablokowane po kilku nieudanych próbach

Kod odpowiedzi: 429

Przyczyna. Limit nieudanych logowań chroni konta przed zgadywaniem hasła. Blokada dotyczy adresu IP i mija sama.

Co zrobić. Odczekaj czas z nagłówka Retry-After (zwykle kilka minut). Jeśli to nie ty próbowałeś się logować, właściciel może zdalnie wylogować sesję w Ustawieniach, Bezpieczeństwo.

Kto rozwiązuje: ty.

Kod z aplikacji uwierzytelniającej (TOTP) jest odrzucany

Kod odpowiedzi: 401

Przyczyna. Kod zależy od czasu telefonu. Przy rozjechanym zegarze albo starym sekrecie kod nie pasuje.

Co zrobić. Włącz automatyczny czas w telefonie i wpisz świeży kod. Gdy nadal nie działa, właściciel wyłącza i włącza 2FA konta w Ustawieniach, Konta zespołu. Właściciel może też użyć passkey.

Kto rozwiązuje: właściciel instancji.

Komunikat o braku dostępu do modułu albo tylko odczycie

Kod odpowiedzi: 403

Przyczyna. Rola konta (własna albo wbudowana: odczyt, handlowiec) nie pozwala na tę akcję.

Co zrobić. Poproś właściciela o zmianę roli w Ustawieniach, Role. Akcje ustawień, kont i kluczy wykonuje tylko właściciel.

Kto rozwiązuje: właściciel instancji.

Funkcja jest wyłączona w tej instancji

Kod odpowiedzi: 403

Przyczyna. Funkcje opcjonalne (marketing, dzwonki, agenci AI itd.) są wyłączane per instancja plikiem instancja.toml albo flagą.

Co zrobić. Właściciel sprawdza stan w GET /api/funkcje i włącza funkcję flagą albo usuwa ją z listy wylaczone w instancja.toml.

Kto rozwiązuje: właściciel instancji.

Za wiele żądań: zwolnij

Kod odpowiedzi: 429

Przyczyna. Limity żądań na minutę chronią instancję przed pętlą w integracji albo skryptem.

Co zrobić. Odczekaj Retry-After sekund. Integracja powinna ograniczyć częstość; właściciel zmienia limity w Ustawieniach, Bezpieczeństwo.

Kto rozwiązuje: właściciel instancji.

Panel działa tylko do odczytu (tryb awaryjny)

Kod odpowiedzi: 503

Przyczyna. Właściciel albo automat włączył tryb awaryjny, np. na czas odtwarzania kopii albo awarii bazy.

Co zrobić. Czytaj dane normalnie, zmiany poczekają. Właściciel wyłącza tryb w Ustawieniach, Diagnostyka, gdy przyczyna ustąpi.

Kto rozwiązuje: właściciel instancji.

Błąd serwera z identyfikatorem (id błędu)

Kod odpowiedzi: 500

Przyczyna. Nieoczekiwany wyjątek po stronie serwera. Każdy ma identyfikator, a szczegóły (bez danych osobowych) zapisuje dziennik błędów.

Co zrobić. Kliknij Zgłoś błąd w panelu (dołączy się zrzut i identyfikator) albo przekaż identyfikator wsparciu. Właściciel widzi błąd w GET /api/bledy_serwera?id=...

Kto rozwiązuje: wsparcie FluxLab.

Baza danych niedostępna albo zajęta

Kod odpowiedzi: 503

Przyczyna. Długi zapis (import, kopia) albo problem z dyskiem. Instancja ponawia operację, więc zwykle mija w kilkanaście sekund.

Co zrobić. Poczekaj i ponów. Jeśli komunikat wraca, właściciel sprawdza Diagnostykę (miejsce na dysku, kopie) i zgłasza sprawę jako krytyczną.

Kto rozwiązuje: wsparcie FluxLab.

Formularz odrzuca dane (422 błędne pola)

Kod odpowiedzi: 422

Przyczyna. Serwer sprawdził pola i znalazł błąd (zły format, pusta wartość wymagana, za długa treść).

Co zrobić. Odpowiedź wskazuje pola w kluczu pola. Popraw je i zapisz ponownie; żadne dane nie zostały zmienione.

Kto rozwiązuje: ty.

Poczta nie trafia do CRM

Przyczyna. Najczęściej wygasłe hasło aplikacji skrzynki, zmiana hasła poczty, wyłączony IMAP albo wygasły token Google (aplikacja w trybie testowym zrywa token co 7 dni).

Co zrobić. Sprawdź Ustawienia, Źródła: stan ostatniego importu. Popraw hasło aplikacji albo połącz Gmaila ponownie. Import rusza sam w ciągu kilkunastu minut; właściciel dostaje powiadomienie o błędzie importu.

Kto rozwiązuje: właściciel instancji.

Mail z CRM nie dochodzi albo ląduje w spamie

Przyczyna. Brak rekordów SPF, DKIM albo DMARC domeny, złe hasło SMTP albo adres odbity przez serwer odbiorcy.

Co zrobić. Właściciel odpala kontrolę w Ustawienia, Poczta, Dostarczalność: raport pokazuje brakujące rekordy i odbicia. Adresy z twardym odbiciem trafiają na listę blokad.

Kto rozwiązuje: właściciel instancji.

Dzwonek na telefonie doradcy nie dzwoni

Przyczyna. Dyżur wyłączony, brak zgody na powiadomienia, doradca poza godzinami pracy albo z wpisaną nieobecnością, funkcja dzwonków wyłączona.

Co zrobić. W aplikacji Dzwonek sprawdź dyżur i zgodę na powiadomienia. Właściciel widzi zdrowie aplikacji i może zlecić diagnostykę telefonu w oknie Wsparcie.

Kto rozwiązuje: właściciel instancji.

Formularz ze strony nie tworzy szans

Kod odpowiedzi: 401

Przyczyna. Zły albo zmieniony sekret formularza, nieaktywne źródło formularz albo przeglądarka odrzuciła żądanie z powodu originu.

Co zrobić. Porównaj sekret ze strony z plikiem sekretu instancji, sprawdź zrodla w instancja.toml i dozwolone_originy. Przewodnik: formularz.

Kto rozwiązuje: właściciel instancji.

Nie można dodać konta: limit planu

Kod odpowiedzi: 409

Przyczyna. Plan instancji ogranicza liczbę aktywnych kont (Pilotaż 3, Gotowy CRM 25, Z integracjami 200) albo licencja wygasła.

Co zrobić. Wyłącz nieużywane konto albo przejdź na wyższy plan. Wygasłą licencję odnawia FluxLab.

Kto rozwiązuje: właściciel instancji.

Test odtwarzania kopii zakończył się błędem

Przyczyna. Brak miejsca na dysku, uszkodzony plik kopii albo zmiana katalogu kopii.

Co zrobić. Właściciel sprawdza Diagnostyka, Kopie. Sprawa jest krytyczna, bo bez działającej kopii nie ma RPO: zgłoś ją od razu.

Kto rozwiązuje: wsparcie FluxLab.

Funkcje AI nie odpowiadają

Przyczyna. AI jest domyślnie wyłączone (ADR 0006), brak klucza modelu albo dostawca chwilowo niedostępny. Bez AI reszta panelu działa normalnie.

Co zrobić. Właściciel włącza AI i podaje klucz w Ustawieniach. Gdy dostawca nie odpowiada, panel pokazuje wersję bez AI, a zadania wrócą po ponowieniu.

Kto rozwiązuje: właściciel instancji.

Panel pokazuje stare dane albo stary wygląd po aktualizacji

Przyczyna. Przeglądarka trzyma poprzednią wersję panelu w pamięci podręcznej (Service Worker).

Co zrobić. Odśwież stronę dwa razy (Ctrl+Shift+R). Aplikacja zainstalowana na telefonie aktualizuje się po zamknięciu i ponownym otwarciu.

Kto rozwiązuje: ty.