Documentación de la API de WhatsApp Business
La WhatsApp Business Platform oficial a través de una API REST, sin tener que postularte ante Meta por tu cuenta.
Genuka WA te da acceso a la WhatsApp Business Platform oficial de Meta a través de una API REST sencilla. Sin cuenta de desarrollador de Meta que crear, sin solicitud de proveedor que presentar ante Meta, sin token de acceso que rotar: Genuka es un Tech Provider de Meta y asume esa complejidad por ti. La verificación de empresa de Meta no es necesaria para empezar; en la práctica, es lo que desbloquea los códigos OTP y límites de envío más altos (detalles).
Lo que puedes hacer
Enviar mensajes
Texto, multimedia, botones, listas, formularios, además de plantillas aprobadas para llegar a un cliente fuera de la ventana de 24 horas.
Recibir eventos
Mensajes entrantes, confirmaciones de entrega y de lectura, cambios de estado de plantillas, bajas de marketing (opt-out).
Automatizar campañas
Difunde una plantilla a una lista de contactos y sigue cada envío hasta la confirmación de lectura.
Integrar en TypeScript
@genuka/whatsapp incluye constructores tipados que rechazan los payloads inválidos antes de
la llamada de red.
Dos reglas que debes conocer antes de empezar
WhatsApp no es un canal de envío sin reglas. Dos restricciones condicionan cada integración, y sale más barato cumplirlas aquí que descubrirlas en tus registros de producción.
La ventana de servicio de 24 horas
Solo puedes enviar un mensaje libre (texto, imagen, botones) dentro de las 24 horas siguientes
al último mensaje que recibiste de ese contacto. Pasado ese plazo, solo se entregará una
plantilla aprobada por Meta. Cualquier otra cosa falla con el error 131047.
El consentimiento (opt-in) es obligatorio
Solo puedes escribir a personas que aceptaron ser contactadas. Un usuario puede darse de baja de los mensajes de marketing en cualquier momento; se te notifica por webhook y el envío debe detenerse de inmediato.
Por dónde empezar
¿Eres nuevo en la plataforma? Sigue el inicio rápido: cuenta, número conectado y primer mensaje, en unos diez minutos.
¿Integras desde código existente? Ve directamente a autenticación y luego a enviar mensajes.
Guías, comparativas y códigos de error
Guías
Un caso de uso por página: códigos OTP, notificaciones de pedidos, campañas, webhooks, coexistencia, precios de Meta en África.
Comparativas
Genuka WA frente a Twilio, 360dialog, WATI y las APIs no oficiales de WhatsApp.
Códigos de error
Los códigos de error de Meta (131047, 131026, 130429…), uno por página: qué significa cada uno y si conviene reintentar.
Para agentes de IA y herramientas
- Servidor MCP:
@genuka/whatsapp-mcpda a Claude, Cursor o VS Code acceso a tus números, plantillas y campañas. Configuración en API de WhatsApp para agentes de IA. - /llms.txt: un índice de toda la documentación para modelos de lenguaje, y /llms-full.txt con todas las páginas en un solo archivo.
- Markdown de cualquier página: agrega
.mdxa su URL, por ejemplo /es/docs/quickstart.mdx. - /openapi.json: la API REST descrita en OpenAPI 3.1.
- /pricing.md: los planes y sus límites, en Markdown.