Widget się nie wyświetla

Jeśli widget czatu Conviro nie pojawia się na Twojej stronie, przejdź krok po kroku przez tę listę kontrolną.

1. Sprawdź Embed Code

• Przejdź do Dashboard -> Assistants -> Twój bot -> Embed Code.
• Skopiuj najnowszy snippet i upewnij się, że jest poprawnie umieszczony w Twoim HTML.
• Tag skryptu musi znaleźć się przed zamykającym tagiem \</body\> (a nie w \<head\>).
• Upewnij się, że nie ma literówek ani brakujących znaków.

2. Sprawdź Public Key

• W embed code sprawdź, czy wartość publicKey zgadza się z kluczem widocznym w Dashboard.
• Public key zaczynają się od pk_.
• Jeśli klucz został wygenerowany ponownie, zaktualizuj embed code na swojej stronie.

3. Sprawdź listę dozwolonych domen

• Przejdź do Dashboard -> Assistants -> Twój bot -> Channels.
• Upewnij się, że domena Twojej strony znajduje się na liście Allowed Domains.
• Dodaj wszystkie warianty: example.com, www.example.com oraz localhost na potrzeby developmentu.
• Nie podawaj protokołu (https://) – tylko nazwę domeny.

4. Potwierdź, że bot jest aktywny

• Przejdź do Dashboard -> Assistants.
• Status Twojego bota musi być Active (zielony wskaźnik).
• Jeśli jest wstrzymany lub nieaktywny, kliknij, aby go aktywować.

5. Sprawdź błędy JavaScript

• Otwórz swoją stronę w przeglądarce.
• Naciśnij F12 (lub kliknij prawym przyciskiem -> Inspect), aby otworzyć Developer Tools.
• Przejdź na kartę Console.
• Poszukaj błędów związanych z Conviro lub widgetem:
• Widget init failed – problem z public key lub domeną
• 403 Forbidden – domeny nie ma na liście dozwolonych domen
• 404 Not Found – nieprawidłowy adres URL skryptu widgetu
• net::ERR_BLOCKED_BY_CLIENT – blokada reklam blokuje skrypt

6. Wyłącz blokady reklam

Blokady reklam (uBlock Origin, AdBlock Plus, Brave Shields) mogą blokować skrypt widgetu.

• Tymczasowo wyłącz blokadę reklam i odśwież stronę.
• Jeśli widget się pojawi, dodaj swoją domenę do białej listy w ustawieniach blokady reklam.

7. Sprawdź pamięć podręczną

• Jeśli używasz wtyczki cache’ującej (WP Super Cache, Cloudflare itp.), wyczyść pamięć podręczną po dodaniu embed code.
• Spróbuj otworzyć stronę w oknie przeglądarki incognito/prywatnym, aby ominąć pamięć podręczną.

8. Sprawdź konflikty skryptów

• Inne widgety czatu lub biblioteki JavaScript mogą kolidować z Conviro.
• Sprawdź w Console błędy pochodzące z innych skryptów.
• Spróbuj tymczasowo usunąć inne widgety czatu, aby zawęzić problem.

9. Content Security Policy (CSP)

Jeśli Twoja strona ma restrykcyjną Content Security Policy, może być konieczne zezwolenie na:

• script-src: cdn.conviro.io
• connect-src: api.conviro.io
• frame-src: cdn.conviro.io

10. Nadal nie działa?

Jeśli żaden z powyższych kroków nie rozwiązuje problemu:

• Zrób zrzut ekranu błędów z Console.
• Zanotuj adres URL swojej strony, przeglądarkę i system operacyjny.
• Skontaktuj się z pomocą techniczną pod adresem [email protected], podając te informacje.