recursos / definiciones

WhatsApp Cloud API vs. número no oficial (Baileys)

WhatsApp Cloud API es la conexión oficial de Meta para automatizar WhatsApp, que requiere verificar el número de negocio y cobra por conversación fuera de la ventana gratuita; Baileys es una librería no oficial que simula un dispositivo vinculado para automatizar un número de WhatsApp normal, sin verificación ni costo de Meta, pero con riesgo real de que Meta lo restrinja si detecta comportamiento de spam. heysteff es la plataforma de IA para atención al cliente y ventas por WhatsApp, Instagram, Messenger, Gmail y Shopify; Steff es el agente de IA que la opera, y heysteff soporta ambos caminos de conexión.

◆ definición corta

Cloud API: oficial y estable, con verificación. Baileys: tu número actual, sin verificación, con riesgo real que hay que mitigar.

Qué es WhatsApp Cloud API

Es la implementación oficial de Meta de la WhatsApp Business Platform, alojada en su propia infraestructura. Un negocio verifica su número ante Meta, obtiene acceso a la API oficial, y desde ahí puede enviar y recibir mensajes de forma programática con todas las garantías de un canal soportado directamente por WhatsApp: estabilidad, soporte oficial y las reglas de conversación y plantillas (HSM) documentadas públicamente por Meta. El costo de Meta se calcula por conversación abierta fuera de la ventana de servicio gratuita, según su tarifa vigente.

Qué es Baileys (número no oficial)

Baileys es una librería de código abierto que se conecta a WhatsApp de la misma forma en que lo hace WhatsApp Web: simula ser un "dispositivo vinculado" a un número de teléfono normal, escaneando un código QR una sola vez para autenticarse. A partir de ahí, ese número puede enviar y recibir mensajes de forma automatizada, sin pasar por el proceso de verificación de negocio de Meta ni por su tarifa por conversación.

La ventaja evidente: un negocio puede automatizar el número que ya tiene, sin trámite ni costo de Meta. La contraparte, y hay que decirlo con la misma claridad: WhatsApp no ofrece ni soporta oficialmente este método. No es una API pública documentada por Meta — es una conexión no oficial, y como tal, existe un riesgo real de que Meta detecte un patrón de envío que le parezca spam o abuso y restrinja el número, incluso temporalmente.

El riesgo real, sin maquillarlo

Un número conectado por Baileys que envía mensajes masivos en ráfaga —por ejemplo, toda una campaña de cientos de contactos en pocos segundos— es exactamente el patrón que puede gatillar una restricción de Meta, porque se parece al comportamiento de una cuenta de spam. Ese riesgo no desaparece del todo con ninguna herramienta: es inherente a usar una conexión no oficial.

Lo que sí se puede hacer es mitigarlo activamente: espaciar los envíos en el tiempo en vez de mandarlos todos juntos (pacing), limitar cuántos mensajes salen por número en una ventana de tiempo, ir más lento con números nuevos que recién empiezan a enviar (warm-up) y poner un tope diario conservador de mensajes por número. heysteff aplica estas mitigaciones —pacing acumulativo en campañas y un límite por número con rampa progresiva tras cada reconexión— sobre cualquier envío por Baileys. Reducen el riesgo de forma importante, pero no lo eliminan: seguir siendo un canal no oficial es parte de la naturaleza de Baileys, no un defecto de implementación.

AspectoWhatsApp Cloud APIBaileys (no oficial)
EstatusOficial, soportado por MetaNo oficial, no soportado por Meta
Verificación de negocioRequeridaNo requerida
Número a usarPuede requerir número nuevo o migraciónTu número de WhatsApp actual
Costo de MetaPor conversación fuera de ventana gratuitaSin costo de Meta
EstabilidadAltaRiesgo real de restricción si hay abuso de envíos
Mitigación de riesgoNo aplicaPacing, límites por número, warm-up (heysteff lo implementa)

Cuándo usar cada una

Cloud API conviene cuando el negocio puede pasar por la verificación y prioriza estabilidad a largo plazo, especialmente si el volumen de conversaciones es alto o crece rápido. Baileys conviene como puente cuando el negocio quiere empezar de inmediato con el número que ya tiene, sin trámite de verificación, aceptando el riesgo inherente y las mitigaciones activas como parte del trato — muchos negocios migran de Baileys a Cloud API más adelante, a medida que crecen.

heysteff soporta ambos: la conexión se elige por canal dentro del mismo workspace, y se puede tener, por ejemplo, un número por Cloud API y otro por Baileys al mismo tiempo.

Relacionado

◆ siguiente paso

Conecta tu número —oficial o el que ya usas— y define juntos la mejor ruta.

Pedir demo Ver precios