O widget não aparece

Se o widget de chat do Conviro não aparecer no seu website, percorra esta lista de verificação passo a passo.

1. Verificar o Embed Code

• Aceda a Dashboard -> Assistants -> O seu bot -> Embed Code.
• Copie o snippet mais recente e confirme que está colocado corretamente no seu HTML.
• A tag script tem de ser colocada antes da tag de fecho \</body\> (e não no \<head\>).
• Confirme que não há erros de escrita nem caracteres em falta.

2. Verificar a Public Key

• No embed code, confirme que o valor publicKey corresponde à chave apresentada no Dashboard.
• As public keys começam por pk_.
• Se gerou novamente a chave, atualize o embed code no seu website.

3. Verificar a lista de domínios permitidos

• Aceda a Dashboard -> Assistants -> O seu bot -> Channels.
• Certifique-se de que o domínio do seu website consta na lista Allowed Domains.
• Inclua todas as variantes: example.com, www.example.com e localhost para desenvolvimento.
• Não inclua o protocolo (https://) – apenas o nome do domínio.

4. Confirmar que o bot está ativo

• Aceda a Dashboard -> Assistants.
• O estado do seu bot tem de ser Active (indicador verde).
• Se estiver em pausa ou inativo, clique para o ativar.

5. Verificar erros de JavaScript

• Abra o seu website num browser.
• Prima F12 (ou clique com o botão direito -> Inspect) para abrir as Developer Tools.
• Abra o separador Console.
• Procure erros relacionados com o Conviro ou com o widget:
• Widget init failed – problema na public key ou no domínio
• 403 Forbidden – o domínio não está na lista de domínios permitidos
• 404 Not Found – o URL do script do widget está incorreto
• net::ERR_BLOCKED_BY_CLIENT – um bloqueador de anúncios está a bloquear o script

6. Desativar bloqueadores de anúncios

Os bloqueadores de anúncios (uBlock Origin, AdBlock Plus, Brave Shields) podem bloquear o script do widget.

• Desative temporariamente o bloqueador de anúncios e recarregue a página.
• Se o widget aparecer, adicione o seu domínio à lista de permissões nas definições do bloqueador de anúncios.

7. Verificar a cache

• Se utiliza um plugin de cache (WP Super Cache, Cloudflare, etc.), limpe a cache depois de adicionar o embed code.
• Experimente carregar a página numa janela anónima/privada do browser para contornar a cache.

8. Verificar scripts em conflito

• Outros widgets de chat ou bibliotecas JavaScript podem entrar em conflito com o Conviro.
• Verifique na Console se existem erros de outros scripts.
• Experimente remover temporariamente outros widgets de chat para isolar o problema.

9. Content Security Policy (CSP)

Se o seu site tiver uma Content Security Policy restritiva, poderá ser necessário permitir:

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

10. Continua sem funcionar?

Se nada do que foi indicado acima resolver o problema:

• Tire uma captura de ecrã dos erros da Console.
• Anote o URL do seu website, o browser e o sistema operativo.
• Contacte o suporte através de [email protected] com estes detalhes.