Receita de integração

WhatsApp + Zapier / Make: conecte hoje pela REST API

Funciona hoje via HTTP, sem precisar de um app nativoÚltima verificação: agosto de 2026

O Spun ainda não tem um app publicado no Zapier ou no Make que se instale com um clique. O que ele tem é uma REST API criada especificamente para isso: enviar mensagens de WhatsApp, criar ou atualizar contatos, aplicar etiquetas e verificar se um número tem WhatsApp, além de webhooks de saída para eventos em tempo real. Os dois se conectam direto à etapa “Webhooks by Zapier” do Zapier ou ao módulo HTTP do Make, e da mesma forma ao nó “HTTP Request” do n8n.

Esta receita é o caminho franco que funciona hoje. Se em vez de uma etapa HTTP genérica você quer um app nativo listado no diretório, veja as notas de viabilidade no final para saber o que seria preciso para lançá-lo.

1. Crie uma chave de API

  1. 1

    Abra “Chaves de API”

    Na sua caixa de entrada do Spun: “Configurações”, depois “Webhooks”, depois “Gerenciar Chaves da API” e depois “Nova Chave”.

  2. 2

    Dê um nome e escolha os escopos

    Dê um nome como “Zapier Production”. Ative só os escopos de que você realmente precisa: enviar mensagens, gerenciar contatos, ler contatos, gerenciar etiquetas, ler etiquetas ou verificar números de telefone.

  3. 3

    Copie uma única vez

    A chave (que começa com wap_) é exibida uma única vez. Guarde-a no cofre de credenciais da sua plataforma de automação, nunca dentro de uma etapa do fluxo de trabalho ou em um documento compartilhado.

2. Chame o Spun a partir de um Zap, de um cenário ou de um fluxo de trabalho

Todas as ações vão para a mesma URL base com o mesmo cabeçalho. No Zapier, use “Webhooks by Zapier” > “Custom Request”; no Make, um módulo HTTP configurado como “Make a request”; no n8n, um nó “HTTP Request” com “Header Auth”.

  • check-phone: verifique se um número tem WhatsApp antes de enviar (aceita até 20 números por chamada).
  • create-contact / update-contact: mantenha o registro de WhatsApp de um lead sincronizado a partir de qualquer formulário ou CRM.
  • apply-label / remove-label: etiquete um chat a partir de um gatilho externo, por exemplo, aplique a etiqueta “Novo lead” a um chat no momento em que um formulário é enviado.
Enviar uma mensagem de WhatsApp (POST /api/integrations/send-message)
POST https://api.spun.com/api/integrations/send-message
Authorization: Bearer wap_YOUR_KEY
Content-Type: application/json

{
  "to": "15551234567",
  "text": "Hello! Thanks for contacting us."
}

Se o canal do WhatsApp ficar offline por um momento, o send-message ainda responde com sucesso e uma marcação queued em vez de falhar: a mensagem sai automaticamente quando o canal se reconecta.

3. Receba eventos do WhatsApp no Zapier ou no Make

  1. 1

    Crie primeiro a etapa que recebe

    No Zapier, comece um Zap com “Webhooks by Zapier” > “Catch Hook” e copie a URL que ele fornece. No Make, adicione um módulo de gatilho “Custom Webhook” e copie a URL dele.

  2. 2

    Cole no Spun

    “Configurações”, depois “Webhooks”, depois “Adicionar Webhook”. Cole a URL e escolha quais eventos devem dispará-lo.

  3. 3

    Dispare um evento de teste

    Envie uma mensagem de WhatsApp para você mesmo e depois clique em “Test trigger” (Zapier) ou execute o cenário uma vez (Make) para capturar o payload de exemplo real.

O que o Spun envia em message.inbound
{
  "event_id": "550e8400-e29b-41d4-a716-446655440000",
  "event": "message.inbound",
  "timestamp": "2026-08-18T10:30:00.000Z",
  "org_id": "123",
  "data": {
    "message_id": "[email protected]_ABC123",
    "chat_id": "[email protected]",
    "from": "15551234567",
    "type": "text",
    "text": "Hello!"
  }
}

Eventos disponíveis: mensagem recebida ou enviada, contato criado, atualizado ou excluído, etiqueta atribuída, fluxo de chat concluído, mensagem da fila processada, lead qualificado, chat arquivado e ligação concluída.

O que saber antes de construir em cima disso

  • Não é um app listado e pesquisável no Zapier ou no Make. Hoje não existe uma tela de OAuth “Connect your Spun account” dentro do Zapier ou do Make: a autenticação é uma chave de API fixa que você mesmo cola nos cabeçalhos da etapa HTTP.
  • Por enquanto, as assinaturas de webhook (o lado de “receber eventos”) só podem ser criadas dentro das próprias “Configurações” do Spun, não pelo lado do Zapier, então ainda não existe um gatilho no estilo REST Hook que se inscreva sozinho.
  • O limite é de 60 solicitações por minuto por chave de API. Sempre que puder, agrupe as verificações de números (até 20 por chamada) em vez de fazer uma por vez em um loop.

Relacionado: WhatsApp + Google Sheets (totalmente nativa, sem chave de API) · WhatsApp + HubSpot CRM

Perguntas frequentes

Existe um app oficial do Spun no diretório do Zapier ou do Make?

Ainda não. A REST API e os webhooks de saída que ele usaria já estão no ar, então as mesmas ações e gatilhos funcionam hoje pela etapa genérica HTTP/Webhooks do Zapier, do Make e do n8n.

O que posso fazer com a API hoje?

Enviar uma mensagem de texto no WhatsApp, verificar se um número tem WhatsApp, criar ou atualizar um contato e aplicar ou remover uma etiqueta em um chat, além de receber eventos em tempo real (nova mensagem, novo contato, etiqueta aplicada, fluxo de chat concluído, lead qualificado, chat arquivado, ligação concluída) como webhooks de saída.

Como faço a autenticação?

Crie uma chave de API em “Configurações” > “Webhooks” > “Gerenciar Chaves da API”, escolha só os escopos de que você precisa e envie-a como token Bearer no cabeçalho Authorization. Hoje esta API não tem fluxo de OAuth.

O Zapier consegue se inscrever automaticamente nos meus eventos do Spun, como faz com um app nativo do tipo REST Hook?

Ainda não. Você cola a URL de catch hook do Zapier ou do Make na tela “Configurações” > “Webhooks” do próprio Spun e escolhe os eventos ali; o Zapier não consegue criar essa assinatura por você.

Quais são os limites de solicitações?

60 solicitações por minuto por chave de API. O endpoint check-phone aceita até 20 números em uma única chamada, que é a forma mais fácil de ficar bem abaixo do limite ao verificar muitos números.

O que acontece se eu enviar uma mensagem com o canal do WhatsApp desconectado?

A API ainda responde com sucesso e uma marcação queued em vez de falhar. A mensagem é enviada automaticamente quando o canal se reconecta, então você não precisa criar sua própria lógica de novas tentativas para esse caso.

Pegue uma chave de API e comece a construir

O acesso à API está disponível nos planos de WhatsApp do Spun, junto com a caixa de entrada compartilhada da equipe, as respostas com IA e as integrações nativas com o Google Sheets e o HubSpot. Preço fixo a partir de R$249 por mês, teste grátis.

Comece grátis: 7 dias com tudo incluído

Ver todas as integrações