--- title: "API de WhatsApp para agências de automação | D-API" description: "API de WhatsApp para agências que montam automação para vários clientes: uma conexão isolada por cliente, fluxos no n8n e custo por conexão fácil de repassar." url: https://d-api.cloud/api-whatsapp-para-agencias --- Por segmento # API de WhatsApp para agências que automatizam vários clientes Agência que monta automação de WhatsApp para vários clientes precisa de uma conexão por cliente, isolada das outras, e de um custo que dá para repassar sem surpresa. É isso que separa uma carteira que cresce de uma agência que vira suporte de celular. Por Time de engenharia D-APIAtualizado em 24 de set de 20266 min de leitura ## O problema de quem cuida do WhatsApp de dez clientes No começo, cada cliente novo é resolvido do jeito que dá: um celular na gaveta do escritório, uma instância de uma ferramenta self-hosted num servidor pequeno, um número emprestado para testar o fluxo. Funciona até o quinto cliente. A partir daí aparecem os sintomas conhecidos: - O cliente liga dizendo que o bot parou e você descobre que o aparelho desconectou há dois dias. - Um número foi bloqueado e, na mesma semana, outros dois começaram a falhar no mesmo servidor. - Ninguém sabe quanto o WhatsApp de cada cliente custa de verdade, então a mensalidade é chute. - Cada fluxo no n8n tem uma credencial diferente, configurada à mão, sem padrão. Nenhum desses problemas é de automação. São problemas de infraestrutura, e infraestrutura não é o que o seu cliente paga para ter. Ele paga pelo fluxo que qualifica lead, agenda visita ou cobra boleto. Uma [API de WhatsApp](https://d-api.cloud/) gerenciada tira da agência a parte que ninguém vê e que mais dá trabalho. ## Uma conexão por cliente, e cada uma no seu canto O modelo que escala para agência é simples: cada cliente tem uma conexão própria, com nome previsível e webhook próprio. Nada de misturar dois clientes no mesmo número ou no mesmo processo. | | Tudo no mesmo servidor | Uma conexão isolada por cliente | | --- | --- | --- | | Número de um cliente bloqueado | Pode arrastar os outros que dividem IP | Afeta só aquele cliente | | Conexão caiu | Alguém percebe quando o cliente reclama | Evento de status chega no seu webhook | | Cliente cancelou | Sobra lixo de configuração no servidor | Você remove a conexão e pronto | | Custo por cliente | Difícil de separar | Uma conexão, um valor fixo | Na D-API, cada conexão roda em ambiente isolado, com as próprias credenciais, o próprio webhook e um proxy com IP único gerenciado pela plataforma. Quando um número de cliente toma bloqueio por causa de uma campanha mal planejada, os outros continuam trabalhando. Para entender o que costuma levar a bloqueio, e como evitar que o cliente cometa esses erros, leia [como evitar banimento](https://d-api.cloud/como-evitar-banimento-api-whatsapp). ## Como fica o onboarding de um cliente novo O ideal é que colocar um cliente no ar vire rotina de dez minutos, igual para todos. Um roteiro que funciona bem: 1. **Defina o identificador.** Use o nome do cliente como `sessionId`, por exemplo `cliente-padaria-central`. Esse nome aparece em todo evento e facilita achar o fluxo certo. 2. **Crie a conexão já com o webhook.** Aponte o `webhookUrl` para o nó Webhook do fluxo daquele cliente no n8n. 3. **Conecte o número.** Se o cliente está ao lado, QR Code. Se está longe, código de pareamento, que ele digita no celular sem precisar escanear nada. 4. **Teste com uma mensagem real** para o número do responsável e confirme que o evento chegou no fluxo. 5. **Registre na sua planilha de carteira** o identificador, o plano do cliente e o contato técnico dele. Os passos 2 e 3 cabem em duas chamadas: ``` # cria a conexão do cliente, já apontando para o fluxo no n8n curl -X POST https://api.d-api.cloud/api/v1/sessions \ -H "Authorization: SUA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "sessionId": "cliente-padaria-central", "type": "unofficial", "connectionMode": "pair", "pairPhone": "5511999999999", "webhookUrl": "https://n8n.suaagencia.com.br/webhook/padaria-central" }' # gera o código que o cliente digita no celular curl https://api.d-api.cloud/api/v1/sessions/cliente-padaria-central/pair-code \ -H "Authorization: SUA_API_KEY" ``` Quem tem muitos números por cliente, como uma rede com várias unidades, encontra o modelo de organização em [múltiplos números no WhatsApp](https://d-api.cloud/api-whatsapp-multiplos-numeros). ## n8n: o que é nativo e o que passa por webhook A maior parte das agências monta os fluxos no n8n. A D-API tem um community node, o `n8n-nodes-d-api`, que cobre as ações: enviar texto, mídia, lista, consultar dados. Ele é um nó de ação, não um gatilho. Para o fluxo reagir a mensagens recebidas, o caminho é o nó Webhook nativo do n8n, com a URL dele configurada como webhook da conexão do cliente. Na prática, isso dá um padrão limpo: um fluxo de entrada por cliente, começando no nó Webhook, e os nós da D-API para responder. O passo a passo de instalação está na página da [integração com n8n](https://d-api.cloud/integrations/n8n). Se o seu trabalho é mais de construir automações do que de gerir carteira, a página de [API de WhatsApp para automação](https://d-api.cloud/api-whatsapp-para-automacao) aprofunda esse lado. E, antes de desenhar os fluxos de entrada, vale entender o formato dos eventos em [webhook de WhatsApp](https://d-api.cloud/webhook-api-whatsapp). ## Operação sem babá: saber da queda antes do cliente O que mais desgasta relação de agência com cliente é o cliente descobrir o problema primeiro. A D-API faz self-healing contínuo das conexões, e a maior parte das quedas se resolve sem ninguém agir. Para as que não se resolvem, o evento `connection.status` avisa com o valor `connected`, `disconnected` ou `logged_out`. Um fluxo de monitoramento simples, que toda agência deveria ter: - Ao receber `disconnected`, espere alguns minutos e consulte a conexão de novo. Se continuar fora, mande um alerta para o grupo interno da agência. - Ao receber `logged_out`, o cliente desconectou o aparelho ou trocou de celular. Gere um novo código de pareamento e envie para o responsável, com instrução de uma linha. - Guarde o histórico de quedas por cliente. Ele mostra quem precisa de orientação sobre uso do número. ## Repasse de custo sem planilha de mensagens Cobrança por mensagem é ruim para agência: o custo muda todo mês, depende de campanha que o cliente decide sozinho e obriga você a conferir extrato. Na D-API a cobrança é por conexão, não por mensagem. Um cliente, uma conexão, um valor que você sabe no dia da proposta. E o preço por conexão fica mais barato conforme a carteira cresce, então a margem melhora a cada cliente novo em vez de apertar. Consulte as faixas em [preços](https://d-api.cloud/pricing). Se o seu modelo é vender o próprio WhatsApp como produto, com a sua marca e a sua relação comercial, isso é revenda e tem outra conversa, descrita em [API de WhatsApp para revenda](https://d-api.cloud/api-whatsapp-para-revenda). Para validar o fluxo de onboarding com um cliente piloto, o trial é de 3 dias, sem cartão. Agências que também desenvolvem sistemas sob medida podem se interessar pela página de [API de WhatsApp para software houses](https://d-api.cloud/api-whatsapp-para-software-house). ## Perguntas frequentes ### Uma agência precisa de uma conta separada para cada cliente? Não. Você mantém uma única conta e cria uma conexão por cliente dentro dela. Cada conexão tem o próprio número, o próprio webhook e roda isolada das demais, então dá para gerenciar a carteira inteira de um lugar só. ### Se o número de um cliente for bloqueado, os outros clientes são afetados? Não deveriam ser, e é por isso que o isolamento importa. Na D-API cada conexão roda em ambiente próprio, com IP próprio. O bloqueio de um número não contamina o IP nem a infraestrutura dos outros clientes. ### Como conecto o WhatsApp de um cliente que está em outra cidade? Além do QR Code, a conexão pode ser feita por código de pareamento: você informa o número do cliente, gera um código de oito caracteres e ele digita no próprio celular, em Aparelhos conectados. Não precisa de reunião nem de compartilhar tela. ### Consigo receber mensagens dos clientes dentro do n8n? Sim. O node da D-API no n8n é de ação, para enviar e consultar. Para receber, você aponta o webhook da conexão para um nó Webhook do próprio n8n, que dispara o fluxo a cada mensagem recebida. ### Como cobro o WhatsApp dos meus clientes? Como a D-API cobra por conexão e não por mensagem, o custo de cada cliente é fixo no mês. A maioria das agências embute esse valor na mensalidade de gestão da automação. Os valores por faixa estão na página de preços. Teste a API de WhatsApp da D-API3 dias grátis, sem cartão.[Começar trial grátis](https://app.d-api.cloud/register) ## Continue lendo - [Por segmentoAPI de WhatsApp para software houses](https://d-api.cloud/api-whatsapp-para-software-house) - [Por segmentoAPI de WhatsApp para CRM](https://d-api.cloud/api-whatsapp-para-crm) - [Por segmentoAPI de WhatsApp para ERP](https://d-api.cloud/api-whatsapp-para-erp) - [Por segmentoAPI de WhatsApp para helpdesk](https://d-api.cloud/api-whatsapp-para-helpdesk) ## Teste a API de WhatsApp da D-API Trial de 3 dias com acesso completo. Sem cartão, sem fidelidade. [Começar trial grátis](https://app.d-api.cloud/register)[Ver documentação](https://docs.d-api.cloud/)