---
title: "Zaiped para desenvolvedores: API do WhatsApp e MCP"
description: "Uma API REST e um servidor MCP remoto sobre a API oficial do WhatsApp da Meta: seus números, mensagens, modelos, flows e webhooks assinados. Assinatura mensal por número conectado, a partir de R$ 39,90."
lang: "pt-BR"
canonical: "https://zaiped.com/developers"
alternate: "https://zaiped.com/en/developers"
---

# 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.

A partir de R$ 39,90 por mês, por número.

## 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.

- **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.
- **Crie uma chave de API**: Uma chave por ambiente. Mostramos o segredo uma vez e guardamos só o hash.
- **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.

## 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.
- **Modelos**: Crie, submeta, edite, despause e exclua modelos de mensagem, com o status da Meta espelhado de volta para você.
- **Flows**: Crie WhatsApp Flows a partir do JSON, envie, publique, descontinue e leia as respostas que os seus clientes preenchem.
- **Números**: Perfil comercial, componentes de conversa, QR codes com mensagem pronta e configuração de chamadas de voz, direto da Meta.
- **Mídia**: Suba uma vez e envie de qualquer número; baixe o que os seus clientes mandam por uma URL assinada.
- **Analytics**: Enviadas, entregues, lidas, falhas e recebidas por dia, categorias de cobrança e os principais erros de qualquer período.

## 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.received**: Um cliente mandou mensagem para um dos seus números, com o id da mídia quando houver.
- **message.status**: Uma mensagem sua foi entregue, lida ou falhou, com o erro e o dado de cobrança da Meta.
- **template.status**: A Meta aprovou, recusou ou pausou um modelo.
- **number.update**: A qualidade, o limite de envio ou o nome de exibição de um número mudaram.
- **account.notice**: Um aviso da WABA: restrição, violação, acesso perdido.
- **call.event**: Um 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.

## Um servidor MCP, remoto e pronto

Aponte o Claude, o Cursor ou o nó MCP do n8n para uma URL com a sua chave de API. Toda rota é uma tool, com a mesma validação e os mesmos erros da API REST.

Exemplo de configuração: https://zaiped.com/mcp

As tools espelham a API: list_numbers, send_message, create_template, list_flows, create_webhook e o resto.

## 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.

| Faixa | Por número |
| --- | --- |
| 1 a 9 números | R$ 39,90 |
| 10 a 49 números | R$ 29,90 |
| 50+ números | R$ 19,90 |

### 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

Sem taxa de setup · Cancele quando quiser

## O que os desenvolvedores perguntam

### De quem é o número e a WABA?

Seus. Você conecta pelo Embedded Signup da Meta, o token fica selado do nosso lado e você desconecta quando quiser pelo console.

### Quem paga as mensagens?

A Meta cobra as conversas direto da sua WABA. Nunca cobramos ágio por mensagem; cobramos por número conectado, por mês.

### Quais são os limites de taxa?

Seiscentas chamadas por minuto por conta, e um orçamento de envio de mil por hora e cinco mil por dia, além dos limites da própria Meta por número. Todo 429 vem com Retry-After.

### Posso mandar mensagem livre a qualquer hora?

Só dentro da janela de 24 horas depois da última mensagem do cliente, que é regra da Meta. Fora dela, envie um modelo aprovado.

### Funciona com n8n?

Sim: um nó HTTP Request com a chave bearer para enviar, um nó Webhook para receber. A documentação tem a receita, e o nó MCP Client também funciona.

### Preciso pagar antes de conectar um número?

Sim: a assinatura começa com um número e é o que abre o console. Depois de assinar você conecta o número pelo Embedded Signup da Meta, e a cobrança acompanha quantos você mantiver conectados.

## Envie a primeira mensagem hoje

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