Voltar a Integrações
🔗 Custom / Developers

API + Webhooks do WhatsApp: REST documentada + eventos bidirecionais

API REST completa para enviar mensagens, gerenciar contatos, lançar disparos em massa e invocar IA. Webhooks bidirecionais em tempo real para cada evento (mensagem recebida, lead novo, etiqueta alterada). SDKs em Node e Python. Documentação completa.

API REST documentada
Webhooks tempo real
SDKs Node + Python
★★★★★ 4.9
Por que Wazzap

Seu app precisa de WhatsApp mas as opções disponíveis são ruins

3 problemas típicos ao construir integrações custom de WhatsApp — e como o Wazzap resolve.

WhatsApp Cloud API: setup de 2-4 semanas + templates Meta

Construir sobre a API oficial da Meta exige BSP, verificação do Business Manager, templates pré-aprovados, regra de 24h e custo por mensagem. Setup técnico complexo + restrições eternas.

API REST simples, sem restrições Meta

API REST padrão com autenticação por Bearer token. POST /messages e você manda. Sem BSP, sem templates, sem regra de 24h. Setup técnico de 30 minutos vs 2-4 semanas.

Bibliotecas community sem manutenção

As bibliotecas JS/Python community para WhatsApp quebram com frequência (mudanças do WhatsApp Web), têm documentação ruim e abandono frequente. Seu time acaba mantendo mais código do que escreveu.

SDKs oficiais mantidos em Node e Python

SDKs construídos e mantidos por nós. npm install wazzap-sdk ou pip install wazzap e você começa. Tipos completos, exemplos, suporte ativo.

Webhooks polling vs eventos em tempo real

Soluções baratas usam polling (verificar a cada N minutos). Para apps que precisam responder instantaneamente a uma mensagem, o delay mata UX e conversão.

Webhooks push em tempo real

Cada evento (mensagem recebida, novo lead, etiqueta alterada, disparo concluído) dispara um webhook push para sua URL em menos de 1 segundo. HMAC signing para segurança. Retries automáticos.

Features-chave

Tudo que seu app precisa para falar com o WhatsApp

📡

API REST completa documentada

Endpoints para tudo: /messages, /contacts, /groups, /campaigns, /ai/chat, /templates, /files. Documentação interativa tipo Swagger com exemplos curl, Node, Python.

OpenAPI specTry-it-out liveVersionada

Webhooks bidirecionais em tempo real

Eventos push para sua URL: message.received, contact.created, tag.added, campaign.completed, ai.handoff. HMAC signing para validar origem. Retries automáticos com backoff.

15+ eventosHMAC signingRetries auto
📦

SDKs oficiais Node + Python

SDKs mantidos por nós com tipos completos (TypeScript), autocomplete, error handling. const msg = await wazzap.messages.send({...}). Comece a integrar em minutos, não horas.

Node 18+Python 3.10+TypeScript
🔒

Segurança enterprise

Autenticação Bearer token com scopes granulares (read-only, send-only, admin). Rate limiting protegido. HMAC signing em webhooks. Logs de cada request para auditoria. SOC 2 ready.

Scopes granularesRate limitingAudit logs
Como funciona

De zero ao seu app conectado ao WhatsApp em 30 minutos

Sem BSP, sem templates Meta, sem bibliotecas community frágeis.

1

Gere sua API key

No Wazzap, seção Developers, você gera uma API key com os scopes que precisar (read, send, admin). Cola no seu app ou variáveis de ambiente. 2 minutos.

2

Instale o SDK e implemente seu primeiro endpoint

npm install wazzap-sdk ou pip install wazzap. Segue a documentação para seu primeiro caso (enviar mensagem, receber webhook, gerenciar contatos). 15-30 min para ter algo em produção.

3

Configure webhooks e escale

Aponta sua webhook URL para seu app. Cada evento dispara um POST com HMAC signature para validar. Retries automáticos. Logs visíveis no seu painel do Wazzap.

Casos reais em produção

O que dizem developers e equipes técnicas

★★★★★

"Precisava conectar WhatsApp ao nosso CRM custom. Testei 3 bibliotecas community que quebraram. A API do Wazzap foi plug-and-play — primeiro endpoint rodando em 30 minutos."

Marco Salinas · CTO em SaaS B2B

★★★★★

"Construímos nossa própria plataforma de notificações sobre a API do Wazzap. Processamos 50k eventos/dia sem downtime. A qualidade da documentação + SDKs economiza semanas de desenvolvimento."

Andrea Solano · Lead engineer em fintech

★★★★★

"O que mais gostei: a API é honesta. Se você pede X, te dá X. Sem abstrações estranhas, sem acoplamentos ocultos. Como developer se sente bem construído."

Sergio Linares · Forge Digital Agency

Comparativa honesta

Wazzap API vs WhatsApp Cloud API vs bibliotecas community

3 formas de integrar WhatsApp no seu app custom — comparadas com dados.

Wazzap API + WebhooksWhatsApp Cloud API (Meta)Bibliotecas community (whatsapp-web.js)
Setup time30 minutos2-4 semanas (Meta + BSP)1-3 dias
Custo$19/mês plataforma$0 + $0.005-0.15 por mensagem$0 + seu hosting
Custo por mensagem$0 — ilimitadas$0.005-$0.15$0
Templates Meta obrigatóriosNãoSimNão
SDKs oficiais mantidos✓ Node + Python✓ Múltiplas linguagensVariável
Webhooks tempo real✓ <1s + HMAC✓ <1sVariável
Estabilidade / uptime99.9% (8+ meses)99.9% (oficial)Variável (community)
Anti-banimento built-in✓ Spintax + proxiesN/A (oficial)✗ Você constrói
SuporteEquipe WazzapBSP intermediárioGitHub issues

Quando usar WhatsApp Cloud API direto? Se seu produto precisa do badge verificado da Meta por compliance regulatório. Para todo o resto (apps custom, integrações internas, ferramentas SaaS), Wazzap API ganha em custo, velocidade e liberdade.

Combine com

O mais usado junto com a API + Webhooks

Todas essas integrações vêm incluídas no mesmo plano.

API + SDKs incluídos em qualquer plano

Desde $19/mês com todo o stack técnico

API REST + webhooks + SDKs Node e Python + documentação + scopes granulares — sem add-ons, sem per-message fees.

Ver planos e preços

Perguntas frequentes sobre API + Webhooks

Que autenticação a API usa?+

Bearer token padrão (Authorization header). As API keys têm scopes granulares: read-only (consultar dados), send-only (enviar mensagens), admin (tudo). Você pode gerar várias keys com scopes distintos para diferentes casos de uso.

Há rate limits?+

Sim, generosos. Plano standard: 60 requests/minuto, 5.000/hora, 50.000/dia. Para volumes maiores temos planos enterprise. Os rate limits se aplicam por API key, headers de resposta indicam a cota restante.

Os webhooks vêm assinados?+

Sim. Cada webhook inclui um header X-Wazzap-Signature com HMAC-SHA256 do body assinado com seu secret. Você valida com seu SDK (incluído) ou manualmente — isso impede que alguém falsifique webhooks para sua URL.

O que acontece se minha webhook URL falhar?+

Retries automáticos: 5 tentativas com backoff exponencial (1s, 5s, 30s, 5min, 1h). Após a última falha, o evento fica no log do Wazzap por 7 dias para que você possa reprocessar manualmente.

Têm SDKs para outras linguagens (PHP, Ruby, Go)?+

SDKs oficiais: Node e Python. Para outras linguagens (PHP, Ruby, Go, Java, .NET), a API REST é padrão — você pode consumi-la diretamente com qualquer cliente HTTP. Temos guias para as linguagens mais comuns.

Há um sandbox / ambiente de testes?+

Sim. Cada conta pode criar sub-contas de "sandbox" com seus próprios números de teste. As mensagens funcionam reais mas ficam etiquetadas — útil para testing sem contaminar produção.

Têm webhooks para todos os eventos?+

Sim, 15+ eventos: message.received, message.sent, message.delivered, message.read, contact.created, contact.updated, tag.added, tag.removed, campaign.started, campaign.completed, ai.handoff, group.joined, conversation.assigned, etc. Documentação completa em developer docs.

Conecte seu app ao WhatsApp em 30 minutos

7 dias grátis, API + SDKs incluídos, documentação completa.

Começar teste gratuito