Volver a Integraciones
🔗 Custom / Developers

API + Webhooks de WhatsApp: REST documentada + eventos bidireccionales

API REST completa para enviar mensajes, gestionar contactos, lanzar masivos e invocar IA. Webhooks bidireccionales en tiempo real para cada evento (mensaje recibido, lead nuevo, etiqueta cambiada). SDKs en Node y Python. Documentación completa.

API REST documentada
Webhooks tiempo real
SDKs Node + Python
★★★★★ 4.9
Por qué Wazzap

Tu app necesita WhatsApp pero las opciones disponibles son malas

3 problemas típicos al construir integraciones custom de WhatsApp — y cómo Wazzap los resuelve.

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

Construir sobre la API oficial de Meta requiere BSP, verificación de Business Manager, plantillas pre-aprobadas, regla de 24h, y costo por mensaje. Setup técnico complejo + restricciones eternas.

API REST simple, sin restricciones Meta

API REST estándar con autenticación por Bearer token. POST /messages y mandas. Sin BSP, sin plantillas, sin regla de 24h. Setup técnico de 30 minutos vs 2-4 semanas.

Librerías community sin mantenimiento

Las librerías JS/Python community para WhatsApp se rompen seguido (cambios de WhatsApp Web), tienen mala documentación, y abandono frecuente. Tu equipo termina manteniendo más código del que escribió.

SDKs oficiales mantenidos en Node y Python

SDKs construidos y mantenidos por nosotros. npm install wazzap-sdk o pip install wazzap y empiezas. Tipos completos, ejemplos, soporte activo.

Webhooks polling vs eventos en tiempo real

Soluciones baratas usan polling (revisar cada N minutos). Para apps que necesitan responder instantáneo a un mensaje, el delay mata UX y conversión.

Webhooks push en tiempo real

Cada evento (mensaje recibido, nuevo lead, etiqueta cambiada, masivo completado) dispara un webhook push a tu URL en menos de 1 segundo. HMAC signing para seguridad. Retries automáticos.

Features clave

Todo lo que tu app necesita para hablar con WhatsApp

📡

API REST completa documentada

Endpoints para todo: /messages, /contacts, /groups, /campaigns, /ai/chat, /templates, /files. Documentación interactiva tipo Swagger con ejemplos curl, Node, Python.

OpenAPI specTry-it-out liveVersionada

Webhooks bidireccionales en tiempo real

Eventos push a tu URL: message.received, contact.created, tag.added, campaign.completed, ai.handoff. HMAC signing para validar origen. Retries automáticos con backoff.

15+ eventosHMAC signingRetries auto
📦

SDKs oficiales Node + Python

SDKs mantenidos por nosotros con tipos completos (TypeScript), autocomplete, error handling. const msg = await wazzap.messages.send({...}). Empieza a integrar en minutos, no horas.

Node 18+Python 3.10+TypeScript
🔒

Seguridad enterprise

Autenticación Bearer token con scopes granulares (read-only, send-only, admin). Rate limiting protegido. HMAC signing en webhooks. Logs de cada request para auditoría. SOC 2 ready.

Scopes granularesRate limitingAudit logs
Cómo funciona

De cero a tu app conectada a WhatsApp en 30 minutos

Sin BSP, sin plantillas Meta, sin librerías community frágiles.

1

Genera tu API key

En Wazzap, sección Developers, generas una API key con los scopes que necesites (read, send, admin). La pegas en tu app o variables de entorno. 2 minutos.

2

Instala el SDK e implementa tu primer endpoint

npm install wazzap-sdk o pip install wazzap. Sigues la documentación para tu primer caso (enviar mensaje, recibir webhook, gestionar contactos). 15-30 min para tener algo en producción.

3

Configura webhooks y escala

Apuntas tu webhook URL a tu app. Cada evento dispara un POST con HMAC signature para validar. Retries automáticos. Logs visibles en tu panel de Wazzap.

Casos reales en producción

Lo que dicen developers y equipos técnicos

★★★★★

"Necesitaba conectar WhatsApp a nuestro CRM custom. Probé 3 librerías community que se rompieron. La API de Wazzap fue plug-and-play — primer endpoint corriendo en 30 minutos."

Marco Salinas · CTO en SaaS B2B

★★★★★

"Construimos nuestra propia plataforma de notificaciones sobre la API de Wazzap. Procesamos 50k eventos/día sin downtime. La calidad de la documentación + SDKs ahorra semanas de desarrollo."

Andrea Solano · Lead engineer en fintech

★★★★★

"Lo que más me gustó: la API es honesta. Si pides X, te da X. Sin abstracciones raras, sin acoplamientos ocultos. Como developer se siente bien construido."

Sergio Linares · Forge Digital Agency

Comparativa honesta

Wazzap API vs WhatsApp Cloud API vs librerías community

3 formas de integrar WhatsApp en tu app custom — comparadas con datos.

Wazzap API + WebhooksWhatsApp Cloud API (Meta)Librerías community (whatsapp-web.js)
Setup time30 minutos2-4 semanas (Meta + BSP)1-3 días
Costo$19/mes plataforma$0 + $0.005-0.15 por mensaje$0 + tu hosting
Costo por mensaje$0 — ilimitados$0.005-$0.15$0
Plantillas Meta requeridasNoNo
SDKs oficiales mantenidos✓ Node + Python✓ Múltiples lenguajesVariable
Webhooks tiempo real✓ <1s + HMAC✓ <1sVariable
Estabilidad / uptime99.9% (8+ meses)99.9% (oficial)Variable (community)
Anti-baneo built-in✓ Spintax + proxiesN/A (oficial)✗ Tú lo construyes
SoporteEquipo WazzapBSP intermediarioGitHub issues

¿Cuándo usar WhatsApp Cloud API directo? Si tu producto necesita badge verificado de Meta para compliance regulatorio. Para todo lo demás (apps custom, integraciones internas, herramientas SaaS), Wazzap API gana en costo, velocidad y libertad.

Combina con

Lo más usado junto con la API + Webhooks

Todas estas integraciones vienen incluidas en el mismo plan.

API + SDKs incluidos en cualquier plan

Desde $19/mes con todo el stack técnico

API REST + webhooks + SDKs Node y Python + documentación + scopes granulares — sin add-ons, sin per-message fees.

Ver planes y precios

Preguntas frecuentes sobre API + Webhooks

¿Qué autenticación usa la API?+

Bearer token estándar (Authorization header). Las API keys tienen scopes granulares: read-only (consultar datos), send-only (mandar mensajes), admin (todo). Puedes generar varias keys con scopes distintos para distintos casos de uso.

¿Hay rate limits?+

Sí, generosos. Plan estándar: 60 requests/minuto, 5,000/hora, 50,000/día. Para volúmenes mayores tenemos planes enterprise. Los rate limits se aplican por API key, headers de respuesta indican el cupo restante.

¿Los webhooks vienen firmados?+

Sí. Cada webhook incluye un header X-Wazzap-Signature con HMAC-SHA256 del body firmado con tu secret. Validas con tu SDK (incluido) o manualmente — esto previene que alguien suplante webhooks a tu URL.

¿Qué pasa si mi webhook URL falla?+

Retries automáticos: 5 intentos con backoff exponencial (1s, 5s, 30s, 5min, 1h). Después del último fallo, el evento queda en el log de Wazzap por 7 días para que puedas reprocesarlo manualmente.

¿Tienen SDKs para otros lenguajes (PHP, Ruby, Go)?+

SDKs oficiales: Node y Python. Para otros lenguajes (PHP, Ruby, Go, Java, .NET), la API REST es estándar — puedes consumirla directamente con cualquier cliente HTTP. Tenemos guías para los lenguajes más comunes.

¿Hay un sandbox / ambiente de pruebas?+

Sí. Cada cuenta puede crear sub-cuentas de "sandbox" con tus propios números de prueba. Los mensajes funcionan reales pero quedan etiquetados — útil para testing sin contaminar producción.

¿Tienen webhooks para todos los eventos?+

Sí, 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. Documentación completa en developer docs.

Conecta tu app a WhatsApp en 30 minutos

7 días gratis, API + SDKs incluidos, documentación completa.

Empezar prueba gratuita