Problemas comuns e como resolver
Nível: Iniciante
Tempo de leitura: 8 min
Antes de tudo, confira em status.wevi.chat se algum serviço está com incidente. Se for um problema do nosso lado, basta aguardar a normalização.
O agente não responde
Sintoma: o usuário envia uma mensagem e nada acontece, ou o chat trava.
Causas e soluções:
Chave de API inválida ou ausente Acesse Minha conta → Integrações de IA e verifique se a chave do provedor selecionado está ativa. Tente salvar novamente para validar.
Modelo selecionado indisponível Alguns modelos têm janelas de manutenção ou requerem acesso especial. Troque temporariamente para outro modelo (ex: Claude Sonnet ou GPT-4o Mini) e teste.
Agente em status "Inativo" ou "Rascunho" Verifique o status do agente em Agentes. Apenas agentes com status Ativo respondem no chat público.
Limite de uso atingido Verifique o plano da sua organização em Minha conta → aba Organização. Se o limite de conversas do período foi atingido, considere migrar de plano.
O agente responde errado ou de forma genérica
Sintoma: as respostas não refletem o negócio, são vagas ou ignoram a base de conhecimento.
Causas e soluções:
Prompt muito curto ou sem escopo definido Revise o prompt do agente. Inclua quem o agente é, o que ele faz, o que ele não faz e como deve se comportar em situações específicas. Veja exemplos em: Como configurar o prompt do agente →
Base de conhecimento não processada Abra o agente e vá na aba Inteligência. Verifique se os arquivos estão com status Processado. Se algum arquivo ficar preso em Processando..., remova e faça o upload novamente.
Arquivo com conteúdo ilegível PDFs gerados a partir de scans de imagem (sem camada de texto) não podem ser lidos. Converta para um PDF com texto selecionável antes de subir.
Configuração de retrieval muito restritiva Se o agente busca poucos trechos de documentos, pode não encontrar a informação certa. Aumente o Chunks no contexto (RAG) na aba Inteligência, seção Parâmetros do agente.
Arquivo da base de conhecimento não processa
Sintoma: o arquivo fica preso em Processando... sem nunca exibir Processado.
Causas e soluções:
Chave OpenAI ausente ou inválida O processamento de documentos (RAG) exige a API da OpenAI. Verifique em Minha conta → Integrações de IA se a chave OpenAI está ativa.
Arquivo acima de 20MB O limite por arquivo é de 20MB. Divida documentos grandes em partes menores antes de subir.
Formato não suportado Formatos aceitos: PDF, TXT, Markdown, HTML, Word (.doc e .docx). Arquivos em outros formatos (Excel, imagens, apresentações) precisam ser convertidos antes do upload.
PDF com proteção de senha Arquivos protegidos por senha não podem ser lidos. Remova a proteção antes de enviar.
WhatsApp não está recebendo mensagens
Sintoma: as mensagens enviadas pelo WhatsApp não chegam ao agente.
Causas e soluções:
Token de acesso expirado Tokens do WhatsApp Business API têm prazo de validade. Acesse Conectores → WhatsApp e atualize o token de acesso com um novo gerado no painel da Meta.
Webhook não configurado corretamente No painel da Meta, verifique se a URL do webhook e o token de verificação estão exatamente como mostrado nas configurações do WhatsApp na Wevi. Qualquer diferença interrompe o recebimento.
Agente não vinculado à conexão WhatsApp A conexão WhatsApp precisa estar associada a um agente ativo. Verifique em Conectores → WhatsApp se o agente está selecionado.
Número não aprovado pela Meta Números em processo de aprovação ou com restrições na Meta não recebem mensagens. Consulte o status do número diretamente no Meta Business Manager.
O áudio enviado pelo usuário não é transcrito
Sintoma: o agente não entende mensagens de voz ou responde como se não tivesse recebido nada.
Causa: a transcrição de áudio usa a API Whisper da OpenAI. Se a chave OpenAI estiver ausente ou inválida, o áudio não é transcrito e o agente recebe uma mensagem padrão indicando falha.
Solução: verifique a chave OpenAI em Minha conta → Integrações de IA.
O convite de equipe não chegou por e-mail
Sintoma: o membro convidado não recebeu o e-mail de convite.
Soluções:
- Peça para verificar a pasta de spam
- Confirme que o e-mail foi digitado corretamente
- Acesse Minha conta → aba Equipe, encontre o convite pendente e copie o link de acesso direto para enviar manualmente
O link de convite expira em 7 dias. Se expirado, remova o convite e envie novamente.
A integração com Google parou de funcionar
Sintoma: o agente não consegue acessar Google Calendar, Gmail ou Sheets.
Causa mais comum: o token OAuth expirou ou foi revogado pelo Google.
Solução: acesse Conectores, localize a conta Google afetada e reconecte. O processo leva menos de um minuto e restaura o acesso.
Não encontrou o problema aqui?
Se o problema não está nessa lista, entre em contato com o suporte da Wevi pelo chat ou e-mail. Informe:
- O nome do agente afetado
- A descrição do comportamento esperado e do comportamento atual
- Se possível, o ID da conversa onde o problema ocorreu
Isso acelera muito o diagnóstico.