# Guías de la API de WhatsApp Business

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

> Guías de la API de WhatsApp Business con Genuka WA: códigos OTP, notificaciones de pedidos, campañas, webhooks, coexistencia, precios de Meta y agentes de IA.

Cada una de estas guías responde a una pregunta de integración sobre la API de WhatsApp Business con
Genuka WA: enviar un código OTP, notificar a tus clientes sobre un pedido, lanzar una campaña, recibir
respuestas y estados en un webhook, conservar la app WhatsApp Business en tu número, empezar
sin la verificación de Meta, estimar el costo de los mensajes en África o confiar WhatsApp a un agente de IA.

*Última actualización: 8 de octubre de 2026*

## ¿Cómo envío mensajes de WhatsApp desde mi backend?

* [Enviar códigos OTP por WhatsApp con Node.js](https://wa.genuka.com/es/docs/guides/whatsapp-otp-nodejs): Plantilla de autenticación con botón para copiar el código, vencimiento y verificación en el servidor,
  respaldo por SMS.
* [Notificaciones de pedidos por WhatsApp](https://wa.genuka.com/es/docs/guides/order-notifications): Confirmación, envío y entrega como plantillas de utilidad: variables, idempotencia y estados
  de entrega.
* [Enviar una campaña de WhatsApp por la API](https://wa.genuka.com/es/docs/guides/campaigns-api): Plantilla de marketing, lista de destinatarios, lanzamiento, cuotas del plan y límites de marketing de Meta.

## ¿Cómo recibo las respuestas y los estados de entrega?

* [Recibir respuestas y estados por webhook](https://wa.genuka.com/es/docs/guides/receive-messages-webhooks): Registra una URL, verifica la firma HMAC del encabezado `X-Genuka-Signature`, elimina duplicados,
  gestiona los reintentos y la reproducción.
* [Conectar un agente de voz a las llamadas de WhatsApp](https://wa.genuka.com/es/docs/guides/voice-agent): Activa las llamadas, recibe cada llamada con su SDP, contesta y llama a través de la API.

## ¿Cómo conecto mi número de WhatsApp?

El procedimiento en sí está en [Conectar un número](https://wa.genuka.com/es/docs/onboarding). Estas dos guías responden a las
preguntas que surgen antes.

* [Coexistencia con la app WhatsApp Business](https://wa.genuka.com/es/docs/guides/coexistence): Conserva la app en el número mientras envías por la API: requisitos, pasos, qué se sincroniza y
  los límites.
* [API de WhatsApp sin verificación de Meta](https://wa.genuka.com/es/docs/guides/without-meta-verification): Qué puede enviar un negocio no verificado, qué desbloquea la verificación y el riesgo de las APIs
  no oficiales.

## ¿Cuánto cuesta un mensaje de WhatsApp?

* [Precios de los mensajes de WhatsApp en África](https://wa.genuka.com/es/docs/guides/whatsapp-pricing-africa): Las tarifas de Meta por país y categoría, en USD, EUR y francos CFA, con un ejemplo práctico.

Esas son las tarifas de Meta. La suscripción a Genuka WA, facturada por número, está en la
[página de precios](https://wa.genuka.com/es#pricing) y en Markdown en [/pricing.md](https://wa.genuka.com/pricing.md).

## ¿Cómo conecto un agente de IA a WhatsApp?

* [API de WhatsApp para agentes de IA](https://wa.genuka.com/es/docs/guides/ai-agents): El servidor MCP `@genuka/whatsapp-mcp` para Claude, Cursor o VS Code, además de `llms.txt`, páginas
  en Markdown y la especificación OpenAPI para escribir la integración.

## ¿Qué necesito antes de seguir una guía?

Una cuenta de Genuka WA, un número conectado y una clave API. El [inicio rápido](https://wa.genuka.com/es/docs/quickstart)
cubre los tres, [autenticación](https://wa.genuka.com/es/docs/authentication) cubre la clave y la
[referencia de la API](https://wa.genuka.com/es/docs/api) lista todos los endpoints. La misma API está descrita en OpenAPI 3.1 en
[/openapi.json](https://wa.genuka.com/openapi.json). Cuando una llamada falla, el código que devolvió Meta se explica en
[códigos de error](https://wa.genuka.com/es/docs/errors).

## Preguntas frecuentes

### ¿Necesito la verificación del negocio de Meta para seguir estas guías?

No para empezar. Un negocio no verificado envía plantillas de marketing y de utilidad a un máximo de 250
destinatarios únicos cada 24 horas fuera de la ventana de atención al cliente, para comenzar
([Meta, Messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits)).
Los códigos OTP son la excepción: las plantillas de autenticación exigen superar una de las vías de
escalamiento de Meta, en la mayoría de los casos la verificación del negocio
([360dialog, Authentication messages](https://docs.360dialog.com/docs/resources/authentication-messages)).
Los detalles están en [API de WhatsApp sin verificación de Meta](https://wa.genuka.com/es/docs/guides/without-meta-verification).

### ¿Puedo conservar un número que ya funciona con WhatsApp Business?

Sí. Con la coexistencia de Meta, la app WhatsApp Business, versión 2.24.17 o posterior, sigue funcionando en
el número conectado a la API, y el historial de chats individuales se mantiene sincronizado
([Meta, Onboarding WhatsApp Business app users](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users)).
Solo un número registrado en WhatsApp normal, la app para consumidores, debe liberarse primero. Consulta la
[guía de coexistencia](https://wa.genuka.com/es/docs/guides/coexistence).

### ¿Quién factura los mensajes que envío?

Meta, directamente en tu cuenta de WhatsApp Business: un cliente incorporado por un Tech Provider agrega su
propio método de pago, y Meta le factura el uso
([Meta, Solution Partners and Tech Providers](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/overview)).
Genuka no aplica ningún margen sobre esas tarifas y cobra una suscripción por número de WhatsApp.

### ¿En qué lenguajes están los ejemplos de código?

curl, Node.js, Python y PHP en la mayoría de las guías. La guía de webhooks muestra Next.js, Express, Flask y
la biblioteca `@genuka/whatsapp`; la guía de OTP se limita a Node.js y curl.

## Fuentes

Consultadas el 8 de octubre de 2026.

* Meta — [Messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits)
* Meta — [Onboarding WhatsApp Business app users (coexistence)](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users)
* Meta — [Solution Partners and Tech Providers](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/overview)
* 360dialog — [Authentication messages](https://docs.360dialog.com/docs/resources/authentication-messages)
