API oficial vs API no oficial de WhatsApp: qué cambia de verdad

La diferencia entre la API oficial de WhatsApp y una biblioteca no oficial no es de calidad de código: es de autorización. La oficial es la Cloud API de Meta, donde automatizar es el uso previsto y cada conversación que inicias se cobra. La no oficial automatiza WhatsApp Web, es gratuita y no pide aprobación de nada, e infringe los términos, lo que expone el número a un bloqueo sin aviso ni recurso fiable.

La comparación va criterio a criterio e incluye las dos líneas en las que gana la no oficial. Una comparación en la que un lado se lo lleva todo no es una comparación.

Tiempo hasta el primer envío

Empate, con un matiz. La no oficial arranca en minutos: instalas, escaneas el código QR, envías. La oficial contratada directamente con Meta lleva de semanas a meses; con un proveedor que ya cumplió el trámite, también minutos.

Coste por mensaje

Gana la no oficial, y gana con holgura. No cobra nada por mensaje. En la oficial, Meta cobra cada plantilla que inicias, con precio por categoría y país. Para volumen alto de notificación, la diferencia es de órdenes de magnitud.

Es la línea más honesta de esta comparación, y la razón por la que un proyecto con poco presupuesto elige la no oficial con motivo.

Riesgo de bloqueo

Aquí la distancia es la mayor de todas. Automatizar WhatsApp Web infringe los términos por sí solo, sea cual sea el contenido. El bloqueo llega sin aviso y el recurso es una solicitud de revisión sin plazo ni garantía.

En la API oficial no existe bloqueo por automatizar: Meta sabe que hay un sistema al otro lado. Lo que sí existe es la calidad del número, que baja cuando demasiada gente bloquea o denuncia, y eso vale para ambos caminos.

Estabilidad

La no oficial depende de una sesión de WhatsApp Web. Se rompe cuando se actualiza la aplicación, cuando el servidor reinicia y cuando Meta cambia algo de su lado, sin aviso y sin registro de cambios.

Esto no es hipótesis: operamos un clúster de instancias no oficiales durante años. En un reinicio de dos servidores, 41 instancias entraron en estado de reconexión y no volvieron solas. Y nadie lo notó ese día, porque el fallo es silencioso: el servicio sigue en pie, respondiendo, sin sesión. Fue lo que nos llevó a migrar los clientes a la Cloud API.

Una sesión de WhatsApp Web no sobrevive a un reinicio. Te enteras el día en que necesitas reiniciar el servidor, o el día en que se reinicia solo.

Qué se puede enviar

• No oficial — texto y multimedia a cualquier número, sin aprobación, incluidos grupos.
• Oficial — texto, multimedia, interactivos, ubicación, contacto y reacción; plantilla aprobada para iniciar conversación; y ningún soporte de grupos.

Los grupos son lo único en lo que la no oficial hace algo que la oficial no hará: no existe endpoint de grupos en la Cloud API. Quien dependa de ellos tiene que saberlo antes de decidir.

Aprobación de contenido

En la no oficial no existe: escribes y envías. En la oficial, todo mensaje que parte de ti es una plantilla analizada por Meta, con categoría y reglas de redacción.

Es un coste de proceso real, y también es lo que impide que tu base reciba, por el mismo canal, lo que dispararía una empresa desesperada.

Quién responde cuando se rompe

• No oficial — la comunidad del proyecto. No hay SLA, ni canal, ni a quién escalar.
• Oficial — el proveedor, y detrás Meta. Hay alguien contractualmente responsable.

El resumen, por perfil

1. Prototipo, uso interno, volumen bajo, número prescindible: es difícil argumentar contra la no oficial.
2. Tienda que avisa al cliente por el mismo número de atención: oficial, porque el número que cae es el del negocio.
3. Operación que depende de grupos: ninguna lo resuelve bien; la no oficial lo resuelve con riesgo.
4. Volumen alto de notificación con presupuesto ajustado: hay que hacer la cuenta de la oficial antes, y puede no cerrar.

Quien haya decidido migrar encontrará el paso a paso, incluso conservando el mismo número, en migrar a la API oficial de WhatsApp.

Preguntas frecuentes

¿Es ilegal una API no oficial de WhatsApp?

No es un delito; es una infracción de los términos de uso de la plataforma. La consecuencia no es jurídica, es operativa: bloqueo del número, sin aviso y sin plazo de recurso.

¿Usar una API no oficial solo para recibir es seguro?

Es el mismo mecanismo. Lo que constituye la infracción es automatizar WhatsApp Web, no el sentido del mensaje.

¿Puedo usar las dos a la vez?

En el mismo número, no: queda registrado en un solo sitio. En números distintos, sí, y es el diseño de quien migra poco a poco.

¿La API oficial es más lenta al enviar?

No. La diferencia de latencia es irrelevante para notificaciones; lo que limita el volumen es el nivel de envío del número, que sube conforme se mantiene la calidad.