Pular para o conteúdo
apiwpp
Integração

WhatsApp no Zapier com a apiwpp: Webhooks by Zapier para enviar e receber

Envie mensagens de WhatsApp no Zapier com Webhooks by Zapier (POST) e receba eventos com Catch Hook. Zap de exemplo: novo pedido vira mensagem.

Atualizado em

O Zapier liga milhares de aplicativos por Zaps: um gatilho e uma sequência de ações. Não existe um app nativo da apiwpp no Zapier: a integração usa o Webhooks by Zapier, com a ação POST para enviar mensagens pela API e o gatilho Catch Hook para receber os eventos que a apiwpp envia. Assim, um pedido novo na loja, um lead no formulário ou uma linha na planilha pode virar uma mensagem de WhatsApp, e as respostas do cliente podem voltar para o seu CRM.

O Webhooks by Zapier não está disponível em todos os planos do Zapier. Confira na página de planos do Zapier se o seu inclui esse recurso antes de montar o Zap.

O que você precisa

Enviar uma mensagem com a ação POST

Adicione uma ação Webhooks by Zapier com o evento POST e preencha:

CampoValor
URLhttps://api.apiwpp.com/connections/SEU_CONNECTION_ID/send
Payload Typejson
Datato, message e clientRef, mapeados dos passos anteriores
HeadersAuthorization = Bearer wag_live_…

O Zapier monta com os campos de Data um corpo como este:

{
  "to": "5511988887777",
  "message": "Olá, Maria! Recebemos o seu pedido 1234.",
  "clientRef": "pedido-1234"
}

A autenticação é só o cabeçalho Authorization com a chave no formato Bearer. Trate a chave como senha: ela dá acesso ao projeto, e qualquer pessoa com acesso ao Zap consegue vê-la. Se um dia ela vazar, crie uma chave nova no painel e revogue a antiga; a apiwpp permite rotacionar a chave com um período em que as duas funcionam, sem parar os envios.

A resposta é 202 com jobId, scheduledAt e position, que ficam disponíveis para os passos seguintes do Zap. O 202 quer dizer que a mensagem entrou na fila do número; o resultado da entrega chega depois, pelo webhook.

Zap de exemplo: novo pedido vira mensagem

O clientRef protege contra mensagens repetidas: se o Zap rodar de novo para o mesmo pedido, a apiwpp responde 200 com o job original e "duplicate": true, sem enviar outra vez. Ele fica reservado por 7 dias e volta nos eventos message.delivery e message.send_failed.

Antes de enviar, a apiwpp pergunta ao WhatsApp em qual endereço o número está registrado, então contas antigas sem o nono dígito recebem normalmente. Um número que não tem WhatsApp falha na hora. Para confirmações com o mesmo texto base, um template de mensagem com variáveis evita repetir o texto em cada Zap. Mais ideias para lojas estão em WhatsApp para e-commerce.

Receber eventos com Catch Hook

Para receber mensagens e confirmações de entrega, crie um Zap com o gatilho Webhooks by Zapier › Catch Hook. O Zapier gera uma URL; configure essa URL como o endereço de webhook do projeto na apiwpp. O projeto tem um único endereço, que recebe os eventos de todos os números dele; se o Zapier cuida só de uma parte do trabalho, crie um projeto separado para ele, sem custo.

Cada evento chega no mesmo envelope, { type, connectionId, tenantId, externalId, timestamp, data }. Depois do gatilho, use Filter by Zapier ou Paths by Zapier no campo type:

Deixe os outros tipos passarem sem ação: a lista de eventos só cresce. A entrega é pelo menos uma vez, então o mesmo evento pode chegar duas vezes; antes de criar um registro, procure pelo messageId. O Catch Hook responde na hora, dentro do prazo de 10 segundos que a apiwpp espera.

Cada entrega assinada traz os cabeçalhos X-Sales-Timestamp e X-Sales-Signature, um HMAC-SHA256 do corpo bruto. O Catch Hook entrega os campos já convertidos; para verificar a assinatura, use o gatilho Catch Raw Hook, que mantém o corpo e os cabeçalhos, e um passo de código. Sem essa verificação, mantenha a URL do webhook em segredo. Veja o que é HMAC e webhooks assinados.

Limites da fila em Zaps de volume

O Zapier consegue disparar muitas ações em pouco tempo, por exemplo ao importar uma planilha inteira. A fila de cada número na apiwpp não acompanha esse ritmo, de propósito: ela protege o número de bloqueios. Os padrões por número são:

LimitePadrão
Envios por minuto, hora e dia3, 60 e 200
Intervalo entre dois enviosAleatório, de 3 a 8 segundos
Mesmo destinatárioPelo menos 30 segundos entre mensagens
Destinatários novos100 por 24 horas

Nos primeiros 14 dias depois de conectar, o número passa por um aquecimento com limites menores, que sobem por etapas. Todo envio aceito entra na fila, e o scheduledAt da resposta diz quando ele deve sair.

A exceção é o teto de destinatários novos: passando dele, a ação POST recebe 429 com new_recipient_cap_reached e o cabeçalho Retry-After, e nada entra na fila. No Zapier, o passo falha; trate isso marcando o pedido para uma nova tentativa depois, com o mesmo clientRef. Mensagens para quem já conversou com o número seguem sendo aceitas. Para campanhas para listas frias, a apiwpp não é a ferramenta certa. Veja fila com ritmo anti-bloqueio.

Perguntas frequentes

Existe um app da apiwpp no Zapier?

Não. A integração usa o Webhooks by Zapier: a ação POST para enviar e o gatilho Catch Hook para receber. Como a apiwpp é uma API HTTP com eventos por webhook, isso cobre o envio e o recebimento.

Preciso de um plano pago do Zapier?

O Webhooks by Zapier não está em todos os planos do Zapier. Os planos e o que cada um inclui estão na página de preços do próprio Zapier; do lado da apiwpp, o preço é por número conectado, com mensagens ilimitadas dentro dos limites da fila.

Por que o Zap mostrou sucesso, mas a mensagem demorou a chegar?

O sucesso do passo POST é o 202 da apiwpp: a mensagem entrou na fila. A fila envia no ritmo que protege o número, então em horários de muito volume a mensagem pode sair minutos depois. O campo scheduledAt da resposta mostra o horário previsto.

Posso mandar uma imagem ou um PDF pelo Zapier?

Sim, se o arquivo estiver numa URL https pública. Com Payload Type json, preencha os campos de media (o tipo, a URL e, para documentos, o mimetype). Se o Zap achatar os campos aninhados, use a ação Custom Request com o JSON completo no corpo.

Todos: Integrações →

Sem app nativo da apiwpp no Make: o envio usa o módulo HTTP "Make a request", os eventos chegam num Custom webhook, e o cenário de exemplo transforma cada nova linha da planilha numa mensagem.

Não há nó nativo da apiwpp no n8n: o envio usa o nó HTTP Request com uma credencial Header Auth, e os eventos chegam num nó Webhook, filtrados pelo campo type e com a assinatura conferida.

Envie mensagens com o fetch nativo do Node.js, sem dependências, e receba os eventos num endpoint Express que verifica a assinatura HMAC-SHA256 de cada entrega.

Conecte seu primeiro número hoje.

7 dias grátis, sem cartão de crédito.