> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suasofia.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Problemas do Widget Web

> Solucione problemas comuns do widget web e questões de integração

Soluções para problemas comuns do widget web.

## Widget Não Aparecendo

**Verifique:**

* Código de incorporação colocado antes da tag de fechamento `</body>`
* Limpar cache do navegador (Ctrl+Shift+R ou Cmd+Shift+R)
* Testar em janela privada/incógnita
* Verificar se o plano inclui acesso ao widget web
* Verificar console do navegador (F12) para erros JavaScript
* Re-copiar código de incorporação da configuração do widget

## Voz Não Funcionando

**HTTPS Obrigatório:**
Funcionalidade de voz requer HTTPS. Sites HTTP só podem usar modo chat.

**Verifique:**

* Site usa HTTPS (certificado SSL)
* Navegador tem permissão de microfone
* Microfone funciona em outras aplicações
* Usando navegador moderno (Chrome, Firefox, Safari, Edge)
* Nenhuma VPN ou firewall bloqueando WebRTC

## Chat Não Funcionando

**Verifique:**

* Console do navegador (F12) para erros
* Assistente está configurado corretamente
* Testar assistente com [Chat de Teste](/ai-assistants/test-chat)
* Revisar conversa na página de [Conversas](/conversations/overview)
* Recarregar página para resetar estado do widget

## Problemas do Formulário Pré-Chat

**Verifique:**

* Campos do formulário configurados nas configurações do widget
* Campos do formulário têm tanto nome quanto label
* Configurações do widget foram salvas
* Nomes dos campos coincidem exatamente com as variáveis do assistente
* Limpar cache do navegador e testar em incógnita

## Problemas de Exibição e Estilo

**Verifique:**

* Configuração de posição do widget
* CSS do site pode sobrescrever estilos do widget
* Mudar cor primária para melhor visibilidade
* Verificar se elementos da página cobrem o widget (z-index)
* Testar em dispositivos móveis reais

## Configuração Não Atualizando

**Verifique:**

* Clicar botão "Salvar configurações do widget"
* Copiar novo código de incorporação após salvar
* Substituir código de incorporação antigo no seu site
* Limpar cache do navegador (Ctrl+Shift+R)
* Testar em janela privada/incógnita

## Problemas WordPress/CMS

**Verifique:**

* Usar bloco/widget HTML Personalizado (não editor visual)
* Adicionar código de incorporação antes da tag de fechamento `</body>`
* Limpar cache do plugin de cache
* Desabilitar temporariamente plugins de segurança se necessário

## Ainda Tendo Problemas?

1. Verificar console do navegador (F12) para erros
2. Testar em modo incógnita
3. Tentar navegador diferente
4. Testar assistente com [Chat de Teste](/ai-assistants/test-chat)
5. Contatar suporte com captura de tela do console do navegador

## Documentação Relacionada

* [Configuração do Widget Web](/ai-assistants/web-widget)
* [Interface de Chat de Teste](/ai-assistants/test-chat)
* [Visualizando Conversas](/conversations/viewing-and-managing)