Documentação do Sistema

Visão geral da arquitetura, fluxos e funcionalidades do iAN (Intelligent Auto Negotiator).

1. 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 Blacklist e Cache.
  • Cloudflare R2: Armazenamento de objetos para imagens dos vendedores e mídia.

2. Fluxo de Atendimento

Entrada de Lead (WhatsApp)

Quando um cliente envia uma mensagem para o número da loja:

  1. O webhook da Evolution API recebe a mensagem e repassa para o Worker.
  2. O Worker verifica se o remetente está na Blacklist (KV). Se sim, ignora.
  3. Se for um novo lead, é criado no D1.
  4. A IA (OpenAI) analisa a mensagem para determinar a intenção e contexto.
  5. O sistema responde automaticamente ou encaminha para um vendedor.

3. Funcionalidades do Painel

🚀 Dashboard & Pipeline

Visualização Kanban dos leads em tempo real. Arraste e solte para mudar status. Acompanhe a "Temperatura" do lead baseada na análise de sentimento da IA.

👥 Gestão de Equipe

Cadastre vendedores com foto e WhatsApp. O sistema pode distribuir leads automaticamente (Round Robin) ou permitir "Stickiness" (cliente volta para o mesmo vendedor).

🚫 Blacklist

Bloqueie números indesejados instantaneamente. A verificação é feita em milissegundos na Edge.

🤖 Bot Mode

Ative ou desative a IA globalmente. Útil para assumir o controle manual em horários específicos.

4. Manutenção e Suporte

Para questões técnicas, logs de auditoria ou ajustes finos nos prompts da IA, contate o administrador do sistema. As atualizações são feitas via CI/CD (GitHub Actions) com deploy automático para Cloudflare Pages (Frontend) e Workers (Backend).