API de WhatsApp no Zapier: lead novo vira mensagem em segundos
Não existe app da D-API no Zapier: a ligação é feita pelo Webhooks by Zapier, que chama a API REST com um POST. Com isso, cada lead que preenche um formulário recebe uma mensagem no WhatsApp logo depois, sem ninguém copiar telefone de planilha.
Por que o primeiro contato pelo WhatsApp precisa ser automático
Lead de formulário esfria rápido. Se o vendedor só vê o cadastro no fim da tarde, a pessoa já falou com outras duas empresas. Um Zap resolve a parte mecânica: o formulário dispara, o Zapier monta a mensagem e a API de WhatsApp entrega pelo número da empresa. O vendedor entra na conversa já aberta, com o histórico no celular ou no sistema de atendimento.
O Zapier não tem um app da D-API. Quem faz a ponte é o Webhooks by Zapier, um app do próprio Zapier para falar com qualquer API. Ele tem gatilhos como Catch Hook, para receber dados, e ações como POST e Custom Request, para enviar. Pela central de ajuda do Zapier, esse app não está no plano gratuito.
O Zap em três passos
- Gatilho: o app do seu formulário (Google Forms, Typeform, RD Station, o que você já usa) com o evento de nova resposta. Se o formulário é do seu próprio site, o gatilho pode ser um Catch Hook que recebe o POST do site.
- Limpeza do telefone: um passo de Formatter by Zapier que deixa o número só com dígitos e com o código do país.
- Ação: Webhooks by Zapier, evento POST, chamando o envio de texto da D-API.
Passo 1: o gatilho do formulário
Escolha o app do formulário e o evento de nova resposta, conecte a conta e puxe um registro de teste. Confira que os campos nome, telefone e o de consentimento aparecem na amostra. Sem uma amostra real, o mapeamento dos próximos passos fica às cegas.
O campo de consentimento não é detalhe. Um checkbox do tipo "aceito receber contato pelo WhatsApp" separa uma mensagem esperada de uma mensagem que vira denúncia. Número que recebe muita denúncia é número que para de funcionar, em qualquer modelo de API. Adicione um passo de Filter by Zapier que só continua quando o consentimento foi marcado. As outras práticas estão em como evitar banimento.
Passo 2: deixar o telefone no formato certo
A D-API espera o número internacional só com dígitos: 5511999999999. Formulário traz de tudo: "(11) 99999-9999", "11 999999999", "+55 11...". Use o Formatter by Zapier para remover o que não é dígito e, se o formulário não pede o código do país, acrescente o 55 na frente. Teste com os três formatos acima antes de ligar o Zap.
Passo 3: a ação POST do Webhooks by Zapier
Adicione a ação Webhooks by Zapier, escolha o evento POST e preencha:
| Campo do Zapier | O que colocar |
|---|---|
| URL | https://api.d-api.cloud/api/v1/messages/send/text |
| Payload Type | json |
| Data | sessionId, to e text, um por linha |
| Wrap Request In Array | No |
| Headers | Authorization com a sua API Key, sem Bearer |
Em to, mapeie a saída do Formatter. Em text, misture texto fixo com o nome do lead. O Zapier monta o corpo a partir desses pares, e o que chega na D-API é isto:
POST https://api.d-api.cloud/api/v1/messages/send/text
Authorization: SUA_API_KEY
Content-Type: application/json
{
"sessionId": "comercial",
"to": "5511999999999",
"text": "Oi, Mariana! Aqui é o Pedro, da Acme. Vi seu cadastro no site sobre o plano anual. Posso te passar os detalhes por aqui?"
}Mensagem de primeiro contato funciona melhor quando cita o que a pessoa pediu e termina com uma pergunta simples. Evite link logo na primeira mensagem para um número que nunca falou com você.
Precisa de algo além de texto? Troque a URL pela rota de imagem ou documento e ajuste os campos em Data. Para corpos aninhados, como uma lista com seções, use o evento Custom Request, onde você escreve o JSON inteiro à mão.
A outra direção: quando o lead responde
O Zap acima só envia. Para reagir à resposta, crie um segundo Zap com o gatilho Catch Hook do Webhooks by Zapier. Copie a URL gerada e registre como webhook do evento messages.received da conexão:
curl -X POST https://api.d-api.cloud/api/v1/sessions/comercial/webhook-config \
-H "Authorization: SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "enabled": true, "type": "single",
"events": { "messages.received": { "enabled": true, "webhookUrl": "https://hooks.zapier.com/hooks/catch/SUA_URL" } } }'No Zap, filtre data fromMe igual a false e use data message e data from jid para, por exemplo, atualizar o lead no CRM como "respondeu" e avisar o vendedor. O Catch Hook separa os campos do JSON para você mapear, então não precisa parsear nada. Os demais eventos que dá para receber estão no guia de webhook de WhatsApp.
Custo e limites de cada lado
No Zapier, cada passo executado conta como tarefa do plano, e o volume de leads define a conta. Na D-API a cobrança é por conexão, não por mensagem, então mandar mais mensagens pelo mesmo número não muda a fatura. Os detalhes estão em planos e preços.
Se o fluxo crescer para vários passos por lead, compare com o n8n, que tem um node nativo da D-API para as ações de envio. E se a ideia é mandar para uma base inteira, e não lead a lead, a conversa é outra: veja API de WhatsApp para marketing. O mesmo desenho de formulário para WhatsApp também pode ser montado no Make.
Perguntas frequentes
A D-API tem app oficial no Zapier?
Não. O Zap usa o Webhooks by Zapier, que faz requisições HTTP para qualquer API. A ação POST chama o endpoint de envio da D-API, e o gatilho Catch Hook pode receber os eventos que a D-API envia.
Webhooks by Zapier funciona no plano gratuito?
Segundo a central de ajuda do Zapier, não. O Webhooks by Zapier fica disponível a partir dos planos pagos. Confira as condições atuais na página de planos do Zapier antes de desenhar o fluxo.
Qual formato de telefone a D-API espera?
Número internacional só com dígitos, sem sinal de mais, espaço ou traço, por exemplo 5511999999999. Formulários costumam trazer o telefone do jeito que a pessoa digitou, por isso vale um passo de limpeza antes do POST.
Posso responder automaticamente quando o lead responder?
Pode. Crie um segundo Zap com o gatilho Catch Hook, configure a URL dele como webhook do evento messages.received na D-API e use um filtro para ignorar mensagens com fromMe verdadeiro.
Quando usar Custom Request em vez de POST?
Quando o corpo tem estrutura aninhada, como as seções de uma lista interativa. A ação POST monta o JSON a partir de pares chave e valor, o que resolve bem textos e mídias simples.
Continue lendo
Teste a API de WhatsApp da D-API
Trial de 3 dias com acesso completo. Sem cartão, sem fidelidade.