API de WhatsApp com webhooks: como enviar e receber mensagens

Resposta curta: uma API de WhatsApp tem dois sentidos. Para enviar, seu sistema faz um POST autenticado com token informando número e mensagem. Para receber, você cadastra uma URL de webhook e a plataforma faz um POST nela a cada mensagem recebida ou mudança de status (enviada, entregue, lida).

Como funciona o envio

Na Zapini, você gera um token de API no painel e chama o endpoint de envio da instância (número) desejada:

curl -X POST https://zapini.app/api/v1/instances/{id}/send-message \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"recipient": "+5511999999999", "message": "Olá! Seu pedido saiu para entrega."}'

Os campos exatos, envio de mídia, áudio como mensagem de voz e templates da Cloud API estão na documentação para desenvolvedores.

Como funciona o recebimento (webhooks)

1. Cadastre a URL pública do seu sistema como webhook da instância.
2. A cada evento, a plataforma envia um JSON com tipo do evento, remetente, conteúdo e identificador da mensagem.
3. Seu endpoint responde 200 rapidamente e processa em fila.

Boas práticas

• Responda rápido: devolva 200 e processe depois; webhooks lentos geram reenvios.
• Idempotência: use o ID da mensagem para não processar o mesmo evento duas vezes.
• Segurança: HTTPS, token secreto no webhook e nunca exponha o token de API no front-end.
• Limites: respeite as regras do WhatsApp; envios em massa sem consentimento levam a bloqueio.

Sem código: Zapier, Make e n8n

Quer “enviar webhooks em zaps”? Use o gatilho Webhooks by Zapier (ou o equivalente no Make/n8n) como URL de webhook da instância para receber mensagens, e uma ação de requisição HTTP para chamar o endpoint de envio. Assim você liga o WhatsApp a planilhas, ERPs e e-mails sem programar.

Casos de uso comuns

• Confirmação de pedido e rastreio de entrega;
• Lembretes de consulta e cobrança;
• Envio de leads do site direto para o WhatsApp do vendedor;
• Sincronização de conversas com o CRM (veja como).

Perguntas frequentes

Preciso da API oficial da Meta para usar a API?

Não. Na Zapini a API funciona tanto com números conectados por QR Code quanto pela Cloud API oficial. Para templates e alto volume, a Cloud API é recomendada.

Qual a diferença entre API e webhook?

A API é chamada pelo seu sistema (você pede algo). O webhook é chamado pela plataforma (ela avisa você que algo aconteceu).

Consigo receber o status de leitura?

Sim. Eventos de status informam quando a mensagem foi enviada, entregue e lida.

Teste na prática

A Zapini reúne WhatsApp (QR Code ou Cloud API oficial), agentes de IA, CRM Kanban, fluxos e API em uma só plataforma. Crie sua conta e configure o primeiro fluxo hoje.