📚 Documentação do Sistema
Visão geral da arquitetura, fluxos e guias de manutenção do iAN.
🔴 Reconectar WhatsApp
Quando o bot para de responder
⚠️ Recriar Instância
Quando reconexão não funciona
💡 Problemas Comuns
Soluções rápidas
URGENTEComo Reconectar o WhatsApp
⚠️ Quando usar: O bot parou de responder e você recebeu alerta de desconexão.
- 1
Acesse a Evolution API
Abra o painel da Evolution API no navegador:
https://thriller-rack-susan-dis.trycloudflare.com - 2
Faça login com a chave API
429683C4C977415CAAFCCE10F7D57E11 - 3
Encontre a instância "netcar-bot"
Clique na instância para ver os detalhes
- 4
Clique em "Connect" ou "Reconectar"
Um QR Code será exibido
- 5
Escaneie o QR Code
No celular: WhatsApp → Menu (3 pontos) → Aparelhos Conectados → Conectar Aparelho
- ✓
Pronto!
O status deve mudar para "CONNECTED" e o bot voltará a funcionar.
AVANÇADOComo Recriar a Instância (Quando Reconexão Falha)
⚠️ Quando usar: O passo acima não funcionou e aparece erro "SessionError" ou "No sessions".
- 1
Delete a instância atual
No painel da Evolution API, clique em "Delete" na instância netcar-bot
⚠️ Isso vai desconectar o WhatsApp temporariamente - 2
Crie uma nova instância
Clique em "New Instance" e use estas configurações:
Instance Name: netcar-botToken: (deixe vazio)Number: (deixe vazio) - 3
Configure o Webhook
Após criar, vá em "Settings" → "Webhook" e configure:
URL:https://netcar-worker.contato-11e.workers.dev/webhook/evolutionEvents: MESSAGES_UPSERT, MESSAGES_UPDATE, CONNECTION_UPDATEEnabled: ✅ Sim - 4
Conecte escaneando o QR Code
Clique em "Connect" e escaneie o QR Code com o WhatsApp do celular.
- ✓
Pronto!
A nova instância está configurada. O webhook será reconfigurado automaticamente pelo sistema.
💡 Problemas Comuns e Soluções
Bot não responde mas está conectado
Verifique se o número não está na blocklist. Vá em Configurações → Blocklist e remova se necessário.
QR Code não aparece
A Evolution API pode estar offline. Verifique se o servidor está rodando. A URL do Cloudflare Tunnel muda quando reinicia.
Erro "not-acceptable" ao enviar mensagem
A sessão do WhatsApp expirou. Reconecte seguindo o passo a passo acima.
Erro "SessionError: No sessions"
A instância precisa ser recriada. Siga o passo a passo "Recriar Instância" acima.
Bot responde lento (mais de 30 segundos)
Normal para respostas com imagens de carros. O sistema busca, processa e envia as imagens.
Arquitetura (Cloudflare Stack)
O sistema foi migrado completamente para a edge network da Cloudflare, eliminando a dependência do Supabase para maior performance e menor latência.
- Cloudflare Workers: Backend serverless que gerencia toda a lógica de negócios, webhooks do WhatsApp e integrações com IA.
- Cloudflare D1 (SQL): Banco de dados relacional distribuído para armazenar leads, vendedores, configurações e histórico de mensagens.
- Cloudflare KV: Armazenamento chave-valor de ultra-baixa latência para Blocklist e Cache.
- Cloudflare R2: Armazenamento de objetos para imagens dos vendedores e mídia, incluindo proxy de imagens com cache.
Fluxo de Atendimento
Entrada de Lead (WhatsApp)
Quando um cliente envia uma mensagem para o número da loja:
- O webhook da Evolution API recebe a mensagem e repassa para o Worker.
- O Worker verifica se o remetente está na Blocklist (KV). Se sim, ignora.
- Se for um novo lead, é criado no D1. (Opcional: Disparo de Webhook para CRM externo).
- A IA (OpenAI) analisa a mensagem para determinar a intenção e contexto.
- O sistema responde automaticamente ou encaminha para um vendedor.
🛠️ Precisa de Ajuda Técnica?
Se os passos acima não funcionarem, entre em contato com o suporte técnico.