agências e revendas
API de WhatsApp para agências de automação que atendem muitos clientes ao mesmo tempo
A API de WhatsApp para agências de automação da D-API reúne os números de todos os seus clientes numa conta, com builder de fluxos, node do n8n e webhook por evento, e um preço por conexão que cai conforme a carteira cresce.
SaaS testa 14 dias com o time técnico ajudando na integração.
- conexões na D-API
- 1.875
- de uptime garantido em contrato
- 99,9%
- datacenters no Brasil
- 4
- por ligação de WhatsApp na API não-oficial
- R$ 0
Carteira inteira numa conta
Cada cliente da agência é uma ou mais conexões isoladas, criadas pelo painel ou pela API, com status e logs próprios.
Fluxos sem código e com código
Builder visual com gatilhos de anúncio, webhook e mensagem, node oficial do n8n e API REST para o que fugir do padrão.
Margem previsível na revenda
Cobrança por conexão ativa, sem tarifa por mensagem na não-oficial. Mais conexões, menor o preço de cada uma.
Uma agência de automação vive de entregar o mesmo tipo de projeto muitas vezes: o fluxo de atendimento da clínica, a qualificação de leads da imobiliária, o aviso de pedido da loja. O que trava o crescimento raramente é o fluxo, e sim a operação em volta dele: números espalhados em contas diferentes, cada cliente com uma credencial, custo que muda a cada campanha. A API de WhatsApp para agências de automação precisa resolver essa operação antes de qualquer outra coisa.
Esta página mostra como uma agência, integradora ou revenda organiza a carteira na D-API, monta os fluxos no builder ou no n8n e precifica a revenda com margem previsível.
A carteira inteira numa conta
O ganho para a agência é ter uma visão só. Cada cliente vira uma ou mais conexões dentro da sua conta, e cada conexão roda isolada, com proxy e IP dedicado. Quando o número de um cliente desconecta, o dos outros segue funcionando, e o evento connection.status avisa a agência antes de o cliente perceber.
As conexões podem ser criadas no painel ou pela API. Para agências que fecham muitos clientes por mês, POST /api/v1/sessions permite provisionar o número no momento em que o contrato é assinado. O cliente lê o QR code ou digita o código de pareamento, e a conexão está pronta. Cada conexão tem logs próprios em GET /api/v1/sessions/{sessionId}/logs, o que acelera o suporte quando o cliente liga reclamando.
Use um padrão de sessionId que diga de quem é cada número, como cliente-padaria-sol-vendas. Na hora do suporte, isso economiza tempo de todo mundo. A página sobre vários números na mesma conta cobre organização e limites.
Eventos de cada cliente no lugar certo
Agência costuma mandar os eventos de cada cliente para um destino diferente: o fluxo do n8n daquele projeto, o CRM do cliente, o monitoramento da própria agência. A configuração de webhook por sessão aceita o modo per_event, em que cada evento tem a sua URL:
POST /api/v1/sessions
{
"sessionId": "cliente-padaria-sol-vendas",
"ignoreGroups": true,
"webhookConfig": {
"enabled": true,
"type": "per_event",
"events": {
"messages.received": { "enabled": true, "webhookUrl": "https://n8n.suaagencia.com/webhook/padaria-sol" },
"connection.status": { "enabled": true, "webhookUrl": "https://ops.suaagencia.com/hooks/status" }
}
}
}
As mensagens do cliente vão para o fluxo dele, e as quedas de conexão de todos os clientes vão para um painel só da agência. Evento ausente ou com enabled: false não é enviado, o que reduz ruído nos fluxos. Quando o destino falha, a D-API retenta com backoff exponencial, e cada tentativa espera até 30 segundos pela resposta. A referência dos modos de entrega e dos eventos está na documentação da D-API.
Builder de fluxos para entregar rápido
Boa parte dos projetos de agência cabe no builder de automação da D-API, no mesmo painel das conexões. Cada fluxo começa por um gatilho:
- Mensagem recebida, com escolha de conexões, filtros de texto e janela de reentrada.
- Meta Lead Ads, que inicia uma execução para cada lead de formulário instantâneo.
- Webhook, com uma URL própria por fluxo que qualquer sistema do cliente pode chamar.
- Campanha, para disparar a partir de uma lista.
Depois do gatilho, os blocos fazem o trabalho: WhatsApp (texto, mídia, botões, lista ou template, com espera de resposta), Condição, HTTP, Atraso, SMS e Ligação (URA), além de CTWA Enrich e CTWA Tracking para quem trabalha com anúncios de clique para WhatsApp. O artigo sobre automação de anúncios da Meta mostra um fluxo completo, do clique ao evento de conversão.
Para a agência, o builder tem uma vantagem extra: o mesmo fluxo atende WhatsApp, SMS e voz. A régua do cliente pode começar no WhatsApp, cair para SMS quando não houver resposta e terminar numa ligação com menu por tecla, sem integrar outro fornecedor.
n8n, API e agentes de IA
Quando o projeto foge do builder, a agência tem dois caminhos com a mesma credencial.
O node oficial do n8n, n8n-nodes-d-api, é mantido pela D-API e cobre sessões, envio de texto, mídia, localização, contatos, enquetes, botões e listas, além de grupos, contatos e operações de chat. Para receber mensagens, o webhook da conexão aponta para um nó Webhook do próprio n8n, como no exemplo acima. A página de integração com n8n mostra a instalação e os primeiros fluxos.
Para projetos com agente de IA conversando no WhatsApp, a D-API oferece um servidor MCP, que entrega ao modelo as ferramentas de envio e consulta prontas. A página sobre agente de IA com MCP explica a montagem. E para qualquer outra stack, a API é REST com OpenAPI 3, com SDK Node oficial para quem trabalha em TypeScript.
Revenda com margem que não oscila
A conta da revenda fecha quando o custo por cliente é fixo. Na API não-oficial, a D-API cobra por conexão ativa, sem tarifa por mensagem, então a campanha grande de um cliente não come a margem do mês. O preço de cada conexão cai conforme o total de conexões da conta cresce, e a agência decide como repassar: mensalidade com o WhatsApp incluído, valor por número ou pacote junto com a automação. Os valores por faixa estão na tabela de preços.
Para o cliente que exige a API Oficial, a conexão nasce pelo Embedded Signup num popup hospedado pela D-API, custa o mesmo por conexão e entra nos mesmos fluxos. As tarifas da Meta ficam na conta Meta do próprio cliente. Agências que querem entregar a experiência com a própria marca encontram o desenho na página de WhatsApp white label.
Por onde começar
Escolha dois clientes da carteira e migre os números deles para a conta. Configure o webhook per_event com as mensagens indo para o fluxo de cada um e o connection.status indo para o seu monitoramento. Depois recrie um fluxo que já funciona hoje no builder ou no n8n e compare a operação. Se a agência também vende software próprio, a página de API de WhatsApp para SaaS cobre a modelagem multi-tenant.
Time D-API. Atualizado em .
Perguntas frequentes
Posso revender as conexões para os meus clientes?
Sim. Você contrata as conexões na D-API e cobra dos seus clientes como quiser. A relação comercial com o cliente final é da agência.
O node do n8n recebe mensagens?
O pacote n8n-nodes-d-api executa ações como criar sessão, enviar texto, mídia, botões, listas e enquetes, gerenciar grupos e contatos. Para receber mensagens, aponte o webhook da conexão para um nó Webhook do próprio n8n.
Cada cliente precisa de um fluxo separado no builder?
Não necessariamente. O gatilho Mensagem recebida permite escolher quais conexões escutar, e vazio significa todas. Na prática, fluxos com regra específica por cliente ficam mais fáceis de manter separados.
Quando vale usar a API Oficial com um cliente da agência?
Quando o cliente exige a conta oficial da Meta ou precisa de templates aprovados para campanhas. A conexão Oficial custa o mesmo por conexão, e as tarifas da Meta são cobradas na conta do próprio cliente.
Como recebo os 14 dias de teste?
O teste de 14 dias com grupo de onboarding é liberado pelo time para SaaS, depois de uma conversa rápida em que você conta o seu caso. O cadastro direto no painel tem 3 dias de teste.