zapixo
EntrarComeçar grátis

Integração

API de WhatsApp para Zapier

Envie e receba WhatsApp pelo Zapier com o Webhooks by Zapier — e quando vale trocar por n8n ou Make.

// Qualquer plataforma com HTTP Request:
POST https://zapixo.com.br/api/v1/messages/text
Authorization: Bearer SUA_CHAVE
Content-Type: application/json

{
  "instance": "automacao",
  "number": "5511999999999",
  "text": "Mensagem automática"
}
Criar conta grátisVer documentação

O Zapier não tem app do Zapixo, e não precisa: o Webhooks by Zapier faz a chamada HTTP para enviar, e o gatilho Catch Hook recebe o webhook das mensagens.

Um detalhe decide antes de começar: o Webhooks by Zapier não está no plano Free — só no Professional, no Team e no Enterprise. Se o plano gratuito é requisito, n8n e Make fazem o mesmo com o módulo HTTP deles, e o n8n ainda pode rodar no seu próprio servidor, na edição Community, sem pagar licença. As duas têm guia própria aqui no site.

O que dá para fazer com Zapier e WhatsApp

  • Lead de formulário vira WhatsApp

    O envio de um formulário dispara o Zap, e o lead recebe a primeira mensagem em segundos.

  • Pagamento aprovado avisa o cliente

    O evento do gateway de pagamento vira confirmação no WhatsApp, sem código.

  • Mensagem recebida vira linha na planilha

    O Catch Hook recebe a mensagem e o Zap grava número, nome e texto no Google Sheets.

  • Mensagem recebida vira tarefa

    Pedido de orçamento que chega no WhatsApp abre um card no quadro da equipe.

Enviar mensagens pelo Zapier

  1. Adicione a ação Webhooks by Zapier

    No Zap, depois do gatilho, adicione Webhooks by Zapier com o evento POST. Em URL, https://zapixo.com.br/api/v1/messages/text; em Payload Type, json.

  2. Headers e dados

    Em Headers, Authorization com Bearer zpx_..., usando a chave do painel. Em Data, uma linha por campo, mapeando os valores do gatilho:

    Data
  instance  →  minha-loja
  number    →  (telefone só com dígitos)
  text      →  Oi (nome), recebemos seu pedido!

Headers
  Authorization  →  Bearer zpx_...

  3. Deixe o número só com dígitos

    Telefone de formulário vem com espaço, traço e parêntese. Um passo Code by Zapier, em JavaScript, antes do envio resolve:

    return { numero: inputData.telefone.replace(/\D/g, "") };

  4. Teste com o seu número

    Testar a ação no Zapier faz a chamada de verdade: a mensagem é enviada. Use o seu próprio número e uma instância conectada. A resposta de sucesso traz success e messageId.

Receber mensagens no Zapier

  1. Crie o gatilho Catch Hook

    Em um Zap novo, escolha Webhooks by Zapier com o evento Catch Hook. Na aba de teste, o Zapier mostra a URL do webhook — copie.

  2. Cole a URL no painel, com um segredo

    No painel do Zapixo, abra a instância e cole a URL em Webhook de mensagens, acrescentando ?chave=SEU_SEGREDO no fim. O Zapixo não assina as requisições; o segredo é o que o próximo passo vai conferir.

  3. Filtre logo depois do gatilho

    Um Filter by Zapier só deixa seguir quando a chave bate, o event é messages.upsert e o fromMe é false. Os campos do payload aparecem achatados, com nomes como Data Key Remote Jid e Data Key From Me.

  4. Use a mensagem

    O número é o remoteJid sem o sufixo: um Formatter com Split Text por @, pegando o primeiro item, resolve. O texto está em Data Message Conversation.

Erros comuns e como resolver

Webhooks by Zapier não aparece
A conta está no plano Free. O Webhooks by Zapier só existe nos planos Professional, Team e Enterprise.
Mensagem enviada durante o teste
É o comportamento do teste de ação no Zapier: ele executa de verdade. Teste sempre com o seu número.
O Zap responde a si mesmo
Mensagens enviadas pela própria instância também chegam, com fromMe: true. Sem o filtro, a resposta do Zap dispara o Zap de novo.
Tarefas gastas à toa
Cada ação executada consome tarefa do plano. Com o filtro logo depois do gatilho, mensagem descartada não chega às ações.
Erro 429 em disparo para lista
A API aceita 60 requisições por minuto por chave. Para lista grande, espace os envios com Delay by Zapier ou divida em lotes.
Erros 401, 404 e 502
401: chave errada ou sem o Bearer na frente. 404: instance não bate com o nome no painel. 502: a entrega ao WhatsApp falhou, e o motivo vem em details.

Perguntas frequentes

Existe app do Zapixo no Zapier?

Não precisa. O Webhooks by Zapier envia e recebe, com a URL e a chave configuradas uma vez.

Dá para usar o Zapixo no plano gratuito do Zapier?

Não. O Webhooks by Zapier está nos planos Professional, Team e Enterprise, e não no Free.

Qual a alternativa ao Zapier para WhatsApp?

n8n e Make fazem o mesmo com o módulo HTTP. O n8n ainda pode rodar no seu servidor, na edição Community, sem licença. As duas têm guia própria aqui no site.

Consigo enviar imagem pelo Zapier?

Sim, com o POST para /api/v1/messages/media, passando mediaUrl (link público do arquivo) e caption opcional.

O trial tem limite de mensagens?

Tem. Ao atingir o limite, a API responde 402 com o link para assinar.

Leia também