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

  1. 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.
  2. 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.
  3. 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 ZapierO que colocar
URLhttps://api.d-api.cloud/api/v1/messages/send/text
Payload Typejson
DatasessionId, to e text, um por linha
Wrap Request In ArrayNo
HeadersAuthorization 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.

Teste a API de WhatsApp da D-API

Trial de 3 dias com acesso completo. Sem cartão, sem fidelidade.