Wafly › Parceiros › API para agências
API de WhatsApp para agências com múltiplos clientes
A dificuldade de uma agência não é enviar uma mensagem. É administrar números, credenciais, webhooks e suporte de vários clientes sem transformar cada novo contrato em um projeto diferente.
Arquitetura recomendada para uma agência
Cada número deve ter sua própria instância. O seu sistema recebe o evento, identifica a qual cliente aquela instância pertence e só então executa a automação. Esse roteamento evita copiar workflows inteiros e reduz o risco de usar a credencial de uma conta em outra.
Na prática, mantenha um cadastro com client_id, instance, token, URLs de webhook e responsáveis. Os segredos ficam no cofre de credenciais do n8n ou no backend — nunca no frontend.
O que precisa ser separado por cliente
| Item | Regra | Por quê |
|---|---|---|
| Instância | Uma por número | Isola sessão, conexão e ciclo de vida |
| Credenciais | Um conjunto por instância | Impede acesso cruzado entre clientes |
| Webhook | URL ou parâmetro que identifique o cliente | Roteia eventos para o fluxo correto |
| Dados e logs | Separação lógica por client_id | Facilita suporte, auditoria e privacidade |
| Limites | Controle por cliente | Um pico não deve consumir a operação dos demais |
Como usar um workflow para vários clientes
- O webhook recebe a mensagem e extrai o identificador da instância.
- Um node consulta a tabela de roteamento e retorna o
client_id. - O fluxo normaliza telefone, texto, mídia e identificador da mensagem.
- A regra de negócio executa sem depender do fornecedor: qualificar lead, atualizar CRM ou chamar um agente de IA.
- O node de saída recupera as credenciais daquele cliente e envia a resposta.
Esse desenho permite trocar a API ou o CRM de um cliente sem mexer na automação dos outros. Para implementação no n8n, veja o guia de WhatsApp com n8n e os templates prontos.
O que a agência deve monitorar
Conexão
Registre conexão e desconexão por instância. Alerta sem identificação do cliente gera suporte lento.
Entrega
Associe o ID retornado no envio aos eventos de status. Isso diferencia falha da API de problema no contato.
Idempotência
Não processe duas vezes o mesmo ID de mensagem. Webhooks podem ser reenviados quando há timeout.
Uso responsável
Registre opt-in e evite abordagem fria. API não oficial não elimina risco de bloqueio do WhatsApp.
Como calcular preço e margem por cliente
O custo técnico deve ser uma linha clara da proposta, separado do valor da automação, implantação e suporte.
| Quantidade na conta | Preço Wafly por instância | Custo mensal |
|---|---|---|
| 5 números | R$ 59,90 | R$ 299,50 |
| 10 números | R$ 59,90 | R$ 599,00 |
| 11 números, conta parceira | R$ 39,90 | R$ 438,90 |
| 20 números, conta parceira | R$ 39,90 | R$ 798,00 |
A regra vigente do programa está detalhada em Parceiros Wafly. A agência decide se repassa o custo, inclui no fee ou adiciona margem pelo suporte prestado.
Quando uma API gerenciada faz sentido
- Você ganha dinheiro com automação e atendimento, não com manutenção de servidor.
- Precisa adicionar novos números sem configurar uma VPS para cada projeto.
- Quer API REST, webhooks e n8n usando a mesma operação.
- Precisa enxergar cada instância separadamente no suporte.
Self-host pode ser melhor quando a equipe já opera Docker, banco, Redis, atualizações e plantão — ou quando controle total da infraestrutura é requisito contratual. Veja a conta completa em Evolution API gerenciada ou self-host.
Teste a arquitetura com um cliente
Crie uma instância, conecte um número e valide envio, webhook e n8n durante 3 dias, sem cartão.
Criar instância grátisVer programa de parceirosPerguntas frequentes
Como administrar vários WhatsApps por API?
Use uma instância e credenciais por número. No início do fluxo, identifique a instância e carregue a configuração do cliente correspondente.
Preciso de uma VPS para cada cliente?
Não ao usar uma API gerenciada. A agência mantém seu n8n, CRM ou aplicação; as sessões ficam na infraestrutura do fornecedor.
Posso usar um workflow n8n para todos?
Sim. Separe configuração e regra de negócio. O workflow busca a credencial correta pelo cliente e reutiliza os mesmos nodes.
A Wafly é a API oficial do WhatsApp?
Não. É uma API não oficial conectada por QR Code. Para alto volume crítico ou exigência de compliance oficial, use a Cloud API da Meta.