OficialWhatsApp pela API da Meta

Conectamos o seu sistema ao WhatsApp oficial

Uma API REST e um servidor MCP sobre os seus próprios números do WhatsApp Business: envie qualquer tipo de mensagem, gerencie modelos e flows e receba todo evento no seu webhook, assinado. Feito para n8n, CRMs e agentes.

Entregas de webhook

  • message.received200
  • message.status200
  • template.status502
  • number.update200

POST https://seu-sistema.com/webhook

X-Zaiped-Signature: t=1757160000000,v1=9f2c…

Três passos até a primeira mensagem

Tiramos o lado da Meta do seu caminho: a conta, os números e os webhooks são seus, e a tubulação fica conosco.

  1. 1

    Conecte um número

    Entre no console e conecte o seu número do WhatsApp Business pelo Embedded Signup da Meta. Ele fica no seu nome e na sua WABA.

  2. 2

    Crie uma chave de API

    Uma chave por ambiente. Mostramos o segredo uma vez e guardamos só o hash.

  3. 3

    Chame a API ou o MCP

    Liste seus números, envie uma mensagem, cadastre um webhook. A mesma chave vale para a API REST e para o servidor MCP.

Um servidor MCP, remoto e pronto

Expomos a API como tools para o seu agente: uma URL e a mesma chave, no Claude, no Cursor ou no n8n.

Seu agente, pelo MCP

Responda à Ana que o pedido dela saiu para entrega.

Chamada de toolsend_message

numberId
YOUR_NUMBER_ID
to
+5511999999999
message.text
Oi, Ana! Seu pedido saiu para entrega.
Resultadoacceptedwamid.HBg...

Pronto: a Meta aceitou a mensagem.

Rode uma vez no terminal.
claude mcp add --transport http zaiped https://zaiped.com/mcp \
  --header "Authorization: Bearer zp_..."

Uma URL, nada para instalar

Hospedamos o servidor: Streamable HTTP, sem estado, sem id de sessão para guardar e sem processo local para manter de pé.

A mesma chave da API

Autenticamos pelo header Authorization: Bearer zp_..., o mesmo da REST. Uma credencial para os dois caminhos.

44 tools, um contrato só

Espelhamos as rotas REST com a mesma validação e os mesmos erros, e marcamos cada tool como somente leitura ou destrutiva.

Ler o capítulo de MCP

No n8n, com os nós que você já tem

Escrevemos três receitas com os nós nativos do n8n: enviar, receber e entregar o WhatsApp a um agente. Sem pacote da comunidade para instalar.

Fluxo no n8n

Receber e responder

  1. Webhook

    Recebe message.received

  2. Code

    Confere o X-Zaiped-Signature

  3. AI Agent

    Decide a resposta e envia pelo WhatsApp

    ToolMCP Clienthttps://zaiped.com/mcp

Enviar

  1. Seu gatilho

    Qualquer nó do seu fluxo

  2. HTTP Request

    POST /v1/messages

Enviar

HTTP Request

POST em https://zaiped.com/v1/messages, credencial Header Auth com Authorization: Bearer zp_... e corpo JSON com numberId, to e message.

Receber

Webhook + Code

Cadastre a URL de produção do nó no console ou por POST /v1/webhooks, assine message.received, confira o X-Zaiped-Signature num nó Code e responda 200.

Agentes

AI Agent + MCP Client

Aponte o MCP Client para a URL do MCP com o mesmo header e entregue ao seu agente as tools de envio e de modelos.

Abrir as receitas na documentação

Tudo o que a Cloud API faz, a uma chamada de distância

Expomos o que já rodamos para milhares de conversas: o mesmo código, atrás de uma chave em vez de uma sessão.

  • Mensagens

    Texto, mídia, localização, contatos, reações, botões e listas interativos, CTA com link, carrossel, flows, produtos e modelos. Marcar como lida com o indicador de digitação.

    POST /v1/messages

  • Modelos

    Crie, submeta, edite, despause e exclua modelos de mensagem, com o status da Meta espelhado de volta para você.

    POST /v1/templates

  • Flows

    Crie WhatsApp Flows a partir do JSON, envie, publique, descontinue e leia as respostas que os seus clientes preenchem.

    POST /v1/flows

  • Números

    Perfil comercial, componentes de conversa, QR codes com mensagem pronta e configuração de chamadas de voz, direto da Meta.

    GET /v1/numbers

  • Mídia

    Suba uma vez e envie de qualquer número; baixe o que os seus clientes mandam por uma URL assinada.

    POST /v1/media

  • Analytics

    Enviadas, entregues, lidas, falhas e recebidas por dia, categorias de cobrança e os principais erros de qualquer período.

    GET /v1/analytics

Webhooks em que dá para confiar

Todo evento que chega até nós vindo da Meta chega ao seu endpoint, assinado e com retentativa.

  • message.receivedUm cliente mandou mensagem para um dos seus números, com o id da mídia quando houver.
  • message.statusUma mensagem sua foi entregue, lida ou falhou, com o erro e o dado de cobrança da Meta.
  • template.statusA Meta aprovou, recusou ou pausou um modelo.
  • number.updateA qualidade, o limite de envio ou o nome de exibição de um número mudaram.
  • account.noticeUm aviso da WABA: restrição, violação, acesso perdido.
  • call.eventUm evento ou mudança de status de chamada de voz.

Assinatura HMAC no header

Mandamos X-Zaiped-Signature com um carimbo de tempo e um HMAC-SHA256 sobre o corpo cru. Confira com o segredo que mostramos uma vez, e retente sem medo: cada entrega carrega o próprio id.

POST https://seu-sistema.com/webhook
X-Zaiped-Event: message.received
X-Zaiped-Delivery: YOUR_DELIVERY_ID
X-Zaiped-Signature: t=1757160000000,v1=HMAC_SHA256

{
  "id": "YOUR_DELIVERY_ID",
  "event": "message.received",
  "createdAt": 1757160000000,
  "data": { "from": "+5511999999999", "type": "text", "text": "Oi" }
}

Um preço por número conectado

Sem taxa de setup e sem taxa por mensagem: a Meta cobra as conversas direto de você. Cobramos pelos números que você mantém conectados, e o preço cai conforme você cresce.

Quantos números?

10números

Quantos números?
10
1100+
FaixaQtd.Por númeroSubtotal
1 a 9 números9R$ 39,90R$ 359,10
10 a 49 números1R$ 29,90R$ 29,90
50+ números0R$ 19,90R$ 0,00

Total mensal

R$ 389,00/ mês

Média de R$ 38,90 por número

Você economiza R$ 10,00 (3%) por mês

Todo plano inclui

  • API ilimitada (dentro dos limites da Meta)
  • Webhooks configuráveis e assinados
  • Servidor MCP remoto
  • Coexistência com o app WhatsApp Business
  • Suporte via WhatsApp
  • Sem taxa de setup ou ativação
Assinar

Sem taxa de setup · Cancele quando quiser

O que os desenvolvedores perguntam

As respostas curtas. A documentação tem as longas.

Envie a primeira mensagem hoje

Crie a conta, conecte um número, copie a chave. A documentação leva você pelo resto.