Genuka WA docs

API oficial de WhatsApp vs APIs no oficiales (WAHA, Baileys…)

Whapi.Cloud, WAHA, Green API, Baileys: cómo funcionan las APIs no oficiales de WhatsApp, sus riesgos de bloqueo y de fiabilidad, y qué cambia con la API oficial.

Una API no oficial de WhatsApp (Whapi.Cloud, WAHA, Green API, Evolution API en modo Baileys, Baileys, whatsapp-web.js) controla una cuenta de WhatsApp como lo hace WhatsApp Web, después de que escaneas un código QR. Es rápida y no requiere aprobación de Meta, pero infringe las Condiciones del servicio de WhatsApp y el número puede ser bloqueado. La API oficial pasa por la Cloud API de Meta.

Última actualización: 17 de noviembre de 2026

Cómo se redactó esta página

Genuka vende acceso a la API oficial, así que tenemos interés en esta comparativa. Para que sea justa, cada afirmación sobre una herramienta proviene de la propia documentación de esa herramienta, y cada regla de WhatsApp de los propios textos de WhatsApp, consultados el 8 de octubre de 2026 y listados en Fuentes. No encontramos ninguna tasa de bloqueo publicada, ni por WhatsApp ni por estos proyectos, así que no citamos ninguna.

¿Cómo funciona una API no oficial de WhatsApp?

WhatsApp te permite vincular dispositivos secundarios a una cuenta: así funciona WhatsApp Web. Una API no oficial se hace pasar por uno de esos dispositivos. Escaneas un código QR desde Dispositivos vinculados en tu teléfono, o ingresas un código de vinculación, y la herramienta envía y recibe los mensajes de la cuenta como lo haría un navegador.

Hay dos técnicas:

  • Controlar el WhatsApp Web real en un navegador. whatsapp-web.js y los motores WEBJS y WPP de WAHA lanzan Chromium con Puppeteer y llaman a las funciones internas de WhatsApp Web.
  • Hablar directamente el protocolo de WhatsApp Web. Baileys, así como los motores NOWEB y GOWS de WAHA, abren una conexión WebSocket sin navegador.

Por encima, algunos proyectos agregan una API HTTP y webhooks: WAHA y Evolution API se ejecutan en tu propio servidor, mientras que Green API y Whapi.Cloud son servicios alojados que mantienen la sesión por ti.

HerramientaTipoCómo se conecta a WhatsAppPrecio publicadoLo que dice el proyecto
BaileysBiblioteca TypeScript, licencia MITWebSocket, código QR o código de vinculaciónGratis"not affiliated […] with WhatsApp"; "Do not spam people with this"
whatsapp-web.jsBiblioteca Node.js, licencia Apache 2.0WhatsApp Web controlado por PuppeteerGratis"it is not guaranteed you will not be blocked by using this method"
WAHAServidor HTTP autoalojado (Docker), licencia Apache 2.0Navegador (WEBJS, WPP) o WebSocket (NOWEB, GOWS), código QRGratis; nivel de soporte opcional de 5 US$ al mes"WhatsApp does not allow bots or unofficial clients on their platform"
Evolution APIServidor REST autoalojado, licencia Apache 2.0 con condiciones adicionales (aviso de uso obligatorio; de lo contrario, licencia comercial)A elegir: Baileys (WhatsApp Web) o la Cloud API oficial de MetaGratisEl modo Baileys "may have limitations compared to official APIs"
Green APIServicio alojadoCódigo QR mediante Dispositivos vinculados; el teléfono permanece cargado y en línea, o lo alojan ellosDeveloper gratis, Business 12 US$ al mes, Chatbot 24 US$ al mes"The decision to block an account is made by WhatsApp"
Whapi.CloudServicio alojadoSesión de dispositivo vinculado, código QR o código de vinculaciónSandbox gratuito limitado; Developer Premium a 29 US$ al mes por número (mostrado tachado desde 40 US$)"Any automation can carry a risk of WhatsApp restrictions"

Evolution API solo es no oficial en modo Baileys: su conector de Cloud API pasa por la plataforma de Meta, con las mismas reglas que Genuka WA.

¿Por qué los desarrolladores eligen una API no oficial?

  • Empezar en minutos. Basta con escanear un código QR: sin portafolio comercial de Meta, sin Embedded Signup, sin plantilla que aprobar.
  • Escribirle a cualquiera, en cualquier momento. Whapi.Cloud anuncia "No templates or approvals". En la API oficial, un mensaje enviado fuera de la ventana de 24 horas debe ser una plantilla aprobada por Meta.
  • Un precio fijo, sin tarifas por mensaje. Whapi.Cloud no cobra "no per-message, per-conversation, or per-request fees"; WAHA es gratis, sin límite de mensajes. En la API oficial, Meta cobra las plantillas y, desde el 1 de octubre de 2026, las respuestas libres por encima de 1.000 mensajes de servicio gratuitos por número al mes.
  • Grupos, Canales y Estados. Whapi.Cloud y WAHA los exponen. La API de Genuka WA no gestiona grupos.
  • Conservar tu teléfono. La sesión se agrega junto a tus dispositivos existentes; la app sigue funcionando como antes.

Son razones reales. La pregunta es cuánto cuestan.

¿Cuáles son los riesgos de una API no oficial de WhatsApp?

¿Qué dicen las Condiciones del servicio de WhatsApp?

Las Condiciones del servicio de WhatsApp prohíben las comunicaciones que impliquen "bulk messaging, auto-messaging, auto-dialing, and the like", así como cualquier "non-personal use of our Services unless otherwise authorized by us". También prohíben explotar el servicio "through automated or other means" de forma no autorizada, y "create software or APIs that function substantially the same as our Services and offer them for use by third parties in an unauthorized manner". Cuando se infringen las condiciones, WhatsApp puede "modify, suspend, or terminate your access".

Los propios proyectos lo dicen: whatsapp-web.js y WAHA escriben que WhatsApp no permite bots ni clientes no oficiales, y los mantenedores de Baileys declaran que no avalan ningún uso que infrinja las Condiciones del servicio de WhatsApp.

¿Pueden bloquear mi número?

Sí, y ninguna de estas herramientas afirma lo contrario. Green API escribe que la decisión de bloquear una cuenta corresponde a WhatsApp y no depende de su servicio. Enumera las señales de automatización, las quejas de los destinatarios y la tasa de respuesta, recomienda "calentar" un número nuevo durante al menos 10 días y aconseja no escribir a más de 200 clientes al día. Whapi.Cloud reconoce que toda automatización conlleva un riesgo de restricciones. En el repositorio de Baileys, los usuarios siguen reportando cuentas bloqueadas tras envíos masivos (issue abierto el 7 de octubre de 2026).

Un bloqueo no solo te cuesta la integración: te cuesta el número que conocen tus clientes, junto con sus conversaciones.

¿Por qué no tener plantillas es un problema?

En la plataforma oficial, la política de WhatsApp Business exige el consentimiento del destinatario: "You may only contact people on WhatsApp if: (a) they have given you their mobile phone number […]; and (b) you have received opt-in permission […]". Fuera de la ventana de 24 horas, solo puede salir una plantilla revisada por Meta, y cada portafolio comercial tiene un límite de envío, compartido por sus números, que sube cuando sus mensajes son de alta calidad y se usa al menos la mitad del límite.

En una sesión no oficial, ninguna de estas salvaguardas existe: nada te impide escribirle a una lista fría. Y las quejas de los destinatarios están entre las causas de bloqueo que enumera Green API.

¿Se puede desconectar una sesión?

Sí. Whapi.Cloud indica que normalmente debes usar WhatsApp en el teléfono al menos una vez cada 14 días para mantener la sesión activa, y que WhatsApp puede igualmente restablecer las sesiones vinculadas y exigir una nueva autorización. Green API recuerda que el envío pasa por el teléfono, que debe permanecer cargado y en línea, a menos que alquiles un teléfono alojado por ellos. WAHA advierte que las respuestas de la API y los payloads de los webhooks difieren de forma significativa de un motor a otro. Para notificaciones de pedidos o códigos de inicio de sesión, es un punto de falla que debes prever.

¿Quién puede leer tus conversaciones?

Un dispositivo vinculado recibe las conversaciones de la cuenta, no solo las que le interesan a tu integración: Baileys incluso documenta cómo recuperar el historial completo. Con un servicio alojado, ese proveedor tiene la sesión de tu número.

¿Cuándo puede tener sentido una API no oficial?

Estos usos quedan fuera del marco que ofrece WhatsApp. El riesgo es el mismo en todos los casos; lo que varía es lo que te cuesta. Sigue siendo soportable cuando perder el número no cuesta casi nada:

  • Automatizar tu propia cuenta: recordatorios personales, archivo de tus mensajes, notificaciones que te envías a ti mismo.
  • Un prototipo o una demo, en un número dedicado que aceptas perder, con destinatarios que saben que están probando.
  • Una herramienta interna de bajo volumen, entre personas que te conocen y que te han escrito.

En cuanto los clientes, los códigos de inicio de sesión o los pagos dependen del número, o le escribes a personas que no pidieron saber de ti, la balanza se invierte.

¿En qué se diferencia la API oficial a través de Genuka WA?

La Cloud API es la vía que Meta ofrece a las empresas. Genuka es un Tech Provider de Meta: conectas tu propio número de WhatsApp Business mediante el Embedded Signup de Meta y luego envías notificaciones, códigos de un solo uso y campañas por HTTP, sin tener que postularte tú mismo ante Meta como proveedor.

API oficial, a través de Genuka WAAPI no oficial
Permitida por WhatsAppSí, es la plataforma creada para las empresasNo: las Condiciones del servicio prohíben el acceso automatizado no autorizado
Conexión del númeroEmbedded Signup de Meta, en tu propia WhatsApp Business Account (WABA)Escaneo de código QR, como un dispositivo vinculado
Escribirle primero a un clienteUna plantilla aprobada por MetaCualquier mensaje
Volumen250 destinatarios únicos cada 24 horas para un portafolio comercial nuevo, luego 2,000, 10,000, 100.000 e ilimitadoNingún límite publicado; Green API aconseja no superar 200 clientes al día
Ritmo de envíoEl techo de Meta de 80 mensajes por segundo por número por defecto, 20 en coexistenciaLo que permita la sesión
Grupos, Canales, EstadosNo compatibles con Genuka WASí, según la herramienta
Estados de entregaWebhooks firmados con HMAC-SHA256, reintentados, reenviablesLos webhooks de la herramienta
CostoLas tarifas por mensaje de Meta, facturadas a tu WABA, más una suscripción de Genuka por númeroUna suscripción fija, o gratis si es autoalojada
Riesgo principalUna plantilla rechazada; una calificación de calidad más baja si los destinatarios se quejanUn número bloqueado, una sesión caída

A lo que renuncias, con honestidad:

  • No puedes escribir primero sin una plantilla aprobada por Meta.
  • El volumen empieza bajo: 250 destinatarios únicos cada 24 horas. Sube a 2.000 después de que Meta verifique la empresa, o después de 2.000 mensajes entregados fuera de la ventana en 30 días con plantillas de alta calidad, y luego aumenta automáticamente. Consulta lo que funciona sin verificación de Meta.
  • Las plantillas tienen un costo de Meta, según la categoría y el país del destinatario. Desde el 1 de octubre de 2026, Meta también cobra las respuestas libres enviadas dentro de la ventana de 24 horas, por encima de 1.000 mensajes de servicio gratuitos por número al mes.
  • Genuka WA no envía a grupos, Canales ni Estados.

Lo que obtienes:

  • Estás dentro del marco que ofrece WhatsApp. El riesgo que queda es la calidad: los mensajes que la gente no quiere bajan la calificación del número, y Meta puede restringirlo.
  • Ningún teléfono, navegador ni código QR que mantener activo.
  • Las respuestas y los estados (sent, delivered, read, failed) llegan a webhooks firmados, reintentados 5 veces y reenviables desde el registro.
  • Las bajas de marketing (opt-out) se respetan: Genuka WA rechaza una plantilla de marketing que conoce cuando va dirigida a un contacto que se dio de baja (403 recipient_opted_out), y una campaña de marketing omite esos contactos (estado skipped).
  • Meta factura tus mensajes directamente, sin margen de Genuka. La suscripción empieza en 5.000 FCFA o 12,99 US$ al mes por número, con una prueba de 7 días y sin tarjeta. Consulta la página de precios.

¿Cómo paso de una API no oficial a la API oficial?

Averigua qué app usa el número

  • El número funciona en la app WhatsApp Business: consérvalo. Es la coexistencia de Meta: la app sigue funcionando para las conversaciones individuales y el historial de chats se sincroniza. Necesitas la versión 2.24.17 o posterior de la app, y la sincronización del historial debe hacerse en un plazo de 24 horas. Al conectar, Meta desvincula de la cuenta todos los dispositivos acompañantes, incluida la sesión no oficial: no la vuelvas a vincular después.
  • El número está registrado en WhatsApp común: primero hay que liberarlo, eliminando la cuenta de WhatsApp de ese número, o usar otro número.

En coexistencia, Meta indica que los chats de grupo no se sincronizan y que las listas de difusión de la app se desactivan. Los detalles están en la guía de Coexistencia.

Conecta el número a Genuka WA

Crea una cuenta: la incorporación te propone conectar un número. Después, es Números > Agregar un número > Conectar WhatsApp, que abre el Embedded Signup de Meta. El número, su WABA y sus plantillas aparecen en tu espacio de trabajo. Agrega un medio de pago a la cuenta de WhatsApp Business: es Meta quien factura los mensajes. Consulta Conectar un número.

Envía tus plantillas a revisión

Cada mensaje que envías primero (confirmación de pedido, recordatorio, promoción) se convierte en una plantilla que Meta debe aprobar: envíalas a revisión con anticipación. Los códigos de un solo uso usan la categoría AUTHENTICATION, reservada a las empresas que superaron la verificación de empresa de Meta (u otra de las vías de crecimiento de Meta): consulta enviar un OTP de WhatsApp desde Node.js.

Recoge el consentimiento de tus contactos

Escribe solo a personas que aceptaron recibir mensajes tuyos por WhatsApp, y detente en cuanto se den de baja: la baja te llega por webhook.

Reemplaza la llamada de envío y conecta los webhooks

Crea una clave API, reemplaza tu llamada de envío (ver más abajo) y luego registra la URL de tu webhook y verifica la firma antes de procesar cualquier cosa: consulta recibir respuestas y estados por webhook.

¿Qué cambia en el código de envío?

Antes, con una sesión de WAHA, un mensaje libre se envía a cualquier número:

curl -X POST https://waha.example.com/api/sendText \
  -H "X-Api-Key: $WAHA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "session": "default",
    "chatId": "[email protected]",
    "text": "Hi Awa, your order #1042 has shipped."
  }'

Con Genuka WA, el mismo mensaje se convierte en una plantilla aprobada, y solo pasas sus variables:

curl -X POST https://wa.genuka.com/api/v1/messages \
  -H "Authorization: Bearer $GENUKA_WA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "cnx_...",
    "to": "+237699001122",
    "template": {
      "name": "order_shipped",
      "language": "en_US",
      "variables": ["Awa", "#1042"]
    }
  }'

# { "data": { "messageId": "wamid.HBg..." } }

Para responder a un cliente que te escribió en las últimas 24 horas, cambia template por text: basta con un mensaje libre. Fuera de esa ventana, la API sigue respondiendo 200, con un campo warning (outside_service_window, o unverified_service_window cuando no hay registrado ningún mensaje entrante de ese contacto). Meta no entrega el mensaje y, por lo general, lo reporta más tarde como un estado failed con el error 131047 en tus webhooks. Todos los tipos de mensaje se describen en Enviar mensajes.

Preguntas frecuentes

Infringe las Condiciones del servicio de WhatsApp, que WhatsApp hace cumplir suspendiendo o cancelando el acceso al servicio. Más allá de eso, normas como la protección de datos o la legislación sobre marketing directo de tu país se aplican sea cual sea la herramienta que uses.

¿Me van a bloquear el número con seguridad?

No, pero nadie puede prometerte lo contrario, y no encontramos ninguna tasa de bloqueo publicada. Las propias herramientas nombran los factores que aumentan el riesgo: un número nuevo, envíos masivos, destinatarios que no responden o que se quejan.

¿Puedo conservar mi número al pasar a la API oficial?

Sí, si el número funciona en la app WhatsApp Business: la coexistencia de Meta lo conecta a la Cloud API sin tocar la app. Un número registrado en WhatsApp común debe liberarse primero. En cualquier caso, la sesión no oficial tiene que desaparecer.

¿La API oficial puede publicar en grupos de WhatsApp?

Sí, hasta cierto punto: Meta ofrece una Groups API en la Cloud API, abierta a las Official Business Accounts, con un máximo de 8 participantes por grupo, que se unen mediante un enlace de invitación. No está disponible en un número que también usa la app WhatsApp Business. Genuka WA no la expone: envía mensajes individuales, plantillas y campañas. En coexistencia, los chats de grupo de la app no se sincronizan.

¿Cuánto cuesta la API oficial con Genuka WA?

Dos capas: Meta factura tus mensajes de pago a tu WhatsApp Business Account, según la categoría y el país del destinatario, y Genuka cobra una suscripción por número, desde 5.000 FCFA o 12,99 US$ al mes, sin margen sobre los mensajes. Consulta Planes y facturación.

Fuentes

Consultadas el 8 de octubre de 2026.

En esta página