WhatsApp API Manager / Wa Connector
Gestão multi-tenant para WhatsApp Cloud API
API multi-tenant para credenciais Meta, templates, listas, campanhas e status de entrega no WhatsApp Cloud API.

Por que esse sistema foi necessário
Produtos diferentes precisavam enviar mensagens oficiais pelo WhatsApp sem recriar a integração Meta em cada aplicação.
O que precisava mudar
Duplicar credenciais, templates, listas e campanhas por produto aumentaria risco operacional e dificultaria acompanhar status de entrega por tenant.
Como a solução organiza a operação
A solução centraliza a gestão multi-tenant da WhatsApp Cloud API em uma API reutilizável, com autenticação própria, campanhas, templates, contatos e eventos de entrega.
O que a operação passa a controlar
- Produtos consumidores usam a integração oficial sem duplicar credenciais Meta.
- Templates, listas, campanhas e status ficam separados por tenant.
- O acompanhamento de entrega fica visível sem transformar o conector em caixa de entrada.
Área técnica
Como a solução foi organizada
A próxima seção detalha como a solução foi organizada tecnicamente: componentes, integrações, filas, armazenamento e pontos de controle.
Arquitetura multi-tenant de envio oficial
01
Produtos consumidores
APIs autorizadas por JWT
status
02
API Manager FastAPI
Tenants, credenciais e contratos REST
configuração
03
MongoDB
Templates, listas, campanhas e status
04
Dispatcher e workers
Importação, agendamento e disparo
campanhas
05
Meta Cloud API
Envio oficial e webhooks de entrega
eventos
06
WebSocket + Redis
Acompanhamento em tempo real
Decisões técnicas
- Usar uma API Manager agnóstica de domínio evita duplicar integração Meta em produtos consumidores.
- Isolar credenciais, templates, números e campanhas por tenant reduz mistura de contexto operacional.
- Manter o conector focado em envio e status, sem armazenar inbound, deixa clara sua responsabilidade.
Operação e continuidade
- Workers processam campanhas e contatos sem bloquear produtos consumidores.
- WebSocket e status de entrega dão visibilidade operacional para acompanhamento em tempo real.
- O conector não armazena mensagens inbound; sua responsabilidade pública é envio oficial e status.
Arquitetura
- FastAPI expõe contratos REST para produtos externos autorizados.
- Credenciais Meta, templates e números ficam isolados por tenant.
- Workers processam importação de contatos, disparos e fan-out de status.
- Redis apoia estado operacional e WebSocket para acompanhamento em tempo real.
Tecnologias
- FastAPI
- Meta Cloud API
- MongoDB
- Redis
- RabbitMQ
- WebSocket
- Docker
Capacidades relacionadas
Atendimento e omnichannel
Organize canais, histórico, roteamento e automações para que a operação mantenha contexto de ponta a ponta.
- - Canais sem histórico único
- - Roteamento manual
- - Automações isoladas
Integrações e APIs
Conecte sistemas com contratos claros, webhooks, filas, sincronização e pontos de retomada.
- - Dados duplicados
- - Importação manual
- - Webhooks sem rastreabilidade
IA aplicada
Use copilotos, agentes e classificação onde a IA ganha contexto, permissão e rastreabilidade.
- - Triagem manual
- - Respostas sem contexto
- - Experimentos de IA sem fronteira
Automação
Transforme rotinas sensíveis e repetitivas em fluxos observáveis, recuperáveis e integrados.
- - Conferência manual
- - Filas invisíveis
- - Retomada dependente de pessoas