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
- Uma conta na apiwpp: o teste grátis de 7 dias libera 1 número com os recursos do plano PRO, sem cartão.
- Um número conectado ao projeto, por QR code ou código de pareamento.
- Uma chave de API do projeto com o escopo
messages:send, e o identificador da conexão. - Uma conta no Zapier com acesso ao Webhooks by Zapier.
Enviar uma mensagem com a ação POST
Adicione uma ação Webhooks by Zapier com o evento POST e preencha:
| Campo | Valor |
|---|---|
| URL | https://api.apiwpp.com/connections/SEU_CONNECTION_ID/send |
| Payload Type | json |
| Data | to, message e clientRef, mapeados dos passos anteriores |
| Headers | Authorization = 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
- Gatilho: novo pedido na sua loja virtual (ou nova linha na planilha de pedidos).
- Formatter by Zapier: deixa o telefone só com dígitos, com o código do país e o DDD, como
5511988887777. - Webhooks by Zapier › POST: envia a confirmação, com
clientRef=pedido-seguido do número do pedido. - Opcional: grava o
jobIdnum campo do pedido ou da planilha.
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:
message.incoming: alguém escreveu para o número; crie o contato ou a tarefa no CRM.message.delivery: o status de uma mensagem enviada mudou (sent,delivered,readoufailed), com o seuclientRef.connection.status: o número conectou ou caiu; avise a equipe quandowillReconnectfor falso.
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:
| Limite | Padrão |
|---|---|
| Envios por minuto, hora e dia | 3, 60 e 200 |
| Intervalo entre dois envios | Aleatório, de 3 a 8 segundos |
| Mesmo destinatário | Pelo menos 30 segundos entre mensagens |
| Destinatários novos | 100 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.
Outras integrações
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.