Automação de Atendimento via WhatsApp

O problema ou oportunidade

Pequenas e médias empresas atendem clientes pelo WhatsApp de forma manual, sem histórico organizado e sem alertas automáticos quando algo falha. O objetivo do projeto é automatizar esse atendimento para várias empresas ao mesmo tempo, mantendo os dados de cada uma isolados.

O que a solução faz

A automação recebe mensagens pela API oficial do WhatsApp (Meta Cloud API) usando um único aplicativo Meta para vários números de clientes. Cada mensagem é roteada para o cliente certo, mantém seu próprio histórico de conversa e recebe uma resposta gerada pela API da Claude, usando uma chave de API própria por cliente.

Principais funcionalidades

• Recebimento de mensagens do WhatsApp via Meta Cloud API, com um único aplicativo atendendo vários números de clientes
• Roteamento por cliente (por número de telefone), com isolamento confirmado de prompt e histórico entre clientes diferentes
• Histórico de conversa multi-turno por contato
• Deduplicação de reenvio de mensagens (retry) feito pela própria Meta, evitando respostas duplicadas
• Geração de resposta pela API da Claude (Anthropic), com uma chave de API por cliente
• Alertas automáticos para número de telefone não cadastrado ou erro de autenticação da IA, sem expor segredos nos registros de log
• Orquestração dos fluxos de automação via n8n, hospedado pelo próprio projeto (sem depender de ferramentas pagas de terceiros)

Como a inteligência artificial foi utilizada

• A própria IA da Claude (Anthropic) é o motor de resposta do produto
• ChatGPT, Claude e Codex apoiaram a criação dos workflows do n8n, o desenho do esquema do banco de dados e a documentação operacional

Arquitetura resumida

Meta Cloud API recebe as mensagens do WhatsApp e as envia, via webhook, para um workflow do n8n atrás de um proxy Caddy (com HTTPS automático via Let's Encrypt). O n8n consulta e grava em um banco PostgreSQL (clientes, mensagens, configurações, alertas e eventos de webhook) e chama a API da Claude para gerar a resposta de cada cliente. Tudo roda em Docker Compose em um único servidor.

Estado atual

Testado ponta a ponta com dados fictícios: verificação de webhook, roteamento multi-cliente com isolamento confirmado, histórico de conversa, deduplicação de reenvio e alertas de erro. O envio real de mensagens e a resposta real da IA ainda dependem da verificação do WhatsApp Business no Meta Business Manager e da configuração final de DNS/certificado em produção — por isso o projeto está listado como em desenvolvimento, sem clientes reais cadastrados ainda.

Por ainda não ter passado por verificação do Meta Business Manager, o projeto não tem tela pública para mostrar — a arquitetura pode ser detalhada em uma demonstração.