# Documentación de la API de WhatsApp Business

URL: https://wa.genuka.com/es/docs
Language: Spanish

> 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](https://wa.genuka.com/es/docs/guides/without-meta-verification)).

## Lo que puedes hacer

* [Enviar mensajes](https://wa.genuka.com/es/docs/messages): Texto, multimedia, botones, listas, formularios, además de plantillas aprobadas para llegar a
  un cliente fuera de la ventana de 24 horas.
* [Recibir eventos](https://wa.genuka.com/es/docs/webhooks): Mensajes entrantes, confirmaciones de entrega y de lectura, cambios de estado de plantillas,
  bajas de marketing (opt-out).
* [Automatizar campañas](https://wa.genuka.com/es/docs/campaigns): Difunde una plantilla a una lista de contactos y sigue cada envío hasta la confirmación de
  lectura.
* [Integrar en TypeScript](https://wa.genuka.com/es/docs/library): `@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.

> [!WARNING]
> **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`.

> [!NOTE]
> **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](https://wa.genuka.com/es/docs/quickstart): cuenta, número
conectado y primer mensaje, en unos diez minutos.

¿Integras desde código existente? Ve directamente a [autenticación](https://wa.genuka.com/es/docs/authentication) y luego
a [enviar mensajes](https://wa.genuka.com/es/docs/messages).

## Guías, comparativas y códigos de error

* [Guías](https://wa.genuka.com/es/docs/guides): Un caso de uso por página: códigos OTP, notificaciones de pedidos, campañas, webhooks,
  coexistencia, precios de Meta en África.
* [Comparativas](https://wa.genuka.com/es/docs/compare): Genuka WA frente a Twilio, 360dialog, WATI y las APIs no oficiales de WhatsApp.
* [Códigos de error](https://wa.genuka.com/es/docs/errors): 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-mcp` da 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](https://wa.genuka.com/es/docs/guides/ai-agents).
* **[/llms.txt](https://wa.genuka.com/llms.txt)**: un índice de toda la documentación para modelos de lenguaje, y
  [/llms-full.txt](https://wa.genuka.com/llms-full.txt) con todas las páginas en un solo archivo.
* **Markdown de cualquier página**: agrega `.mdx` a su URL, por ejemplo
  [/es/docs/quickstart.mdx](https://wa.genuka.com/es/docs/quickstart.mdx).
* **[/openapi.json](https://wa.genuka.com/openapi.json)**: la API REST descrita en OpenAPI 3.1.
* **[/pricing.md](https://wa.genuka.com/pricing.md)**: los planes y sus límites, en Markdown.
