Evolution API y Baileys: lo que pasa en producción

Entre julio y septiembre de 2026 operamos números de WhatsApp conectados con Evolution API y Baileys. En ese periodo tuvimos cinco fallas distintas — ninguna mostró un error en pantalla.

Una actualización de Baileys nos hizo perder el 23% de los mensajes de un número en 24 horas: 143 de 606. El sistema seguía marcado como “saludable”.

En otro número, un reinicio desincronizó la sesión de cifrado y generó 609 errores de descifrado en un día — los mensajes de ese día simplemente no se guardaron.

Por riesgos como estos, migramos el número del puente de un cliente a la API oficial.

Funciona, y en algunos casos sigue siendo la opción correcta. Pero lo que más aprendimos no fue que “puede bloquearte el número” —eso lo dice cualquiera—, sino que cuando falla, casi nunca da un error**.

Qué es Baileys y por qué está detrás de tantas herramientas

WhatsApp Web funciona conectando tu teléfono con una sesión en el navegador. Baileys reproduce esa conexión desde un servidor, sin navegador: el número queda "vinculado" como si fuera un dispositivo más. Por eso no necesita aprobación de Meta, ni verificación de empresa, ni plantillas aprobadas. Y por eso mismo no tiene ninguna garantía: Meta no lo soporta, puede cambiar el protocolo cuando quiera y sus términos no permiten este uso.

Evolution API agrega una capa encima —una API cómoda, varios números, webhooks—, pero los riesgos de fondo son los de Baileys.

Cinco fallas que vimos, ninguna con un error en pantalla

1. Vinculaciones que mueren a los segundos. En el puente de un cliente se quemaron cinco vinculaciones seguidas: el código se aceptaba, aparecía "conectado" y entre 1 y 36 segundos después la sesión moría. Parecía que el cliente desvinculaba el dispositivo. Eran dos fallas del propio código: pedir un código de vinculación sobre una sesión que ya estaba registrada, y dejar dos conexiones vivas con las mismas credenciales.

2. Una actualización que descartó uno de cada cuatro mensajes. Al pasar a la versión 7 de Baileys, el número real del remitente empezó a llegar en otro campo. El código que leía el campo viejo descartaba esos mensajes: 143 de 606 en 24 horas, el 23%. Sin excepción, sin reinicio, con el sistema marcado como "saludable".

3. Mensajes que nunca existieron. Tras un reinicio, la sesión de cifrado de un número quedó desincronizada: 609 errores de descifrado en un día. Un mensaje que no se puede descifrar no llega a la aplicación, así que no se guarda ni se responde. La conversación de una persona que escribió ese día tenía cero mensajes guardados.

4. "Esperando este mensaje" para siempre. Cuando el teléfono del destinatario no logra descifrar un mensaje, pide que se lo reenvíen. Si el sistema no tiene configurada la función que recupera el mensaje original, el reintento muere en silencio y al otro lado queda el aviso de espera de forma permanente. Un contacto se quejó cinco veces en una semana de que no le llegaban los mensajes.

5. Cambiar de celular apagó el bot por una semana. El dueño de un número cambió de teléfono, WhatsApp invalidó la sesión vinculada y el sistema no volvió a intentar conectarse. Quedó siete días caído sin avisar a nadie.

Lo que tienen en común las cinco

Ninguna de las cinco fallas apareció como un error en un panel. En todas, el servidor seguía encendido, el sistema se reportaba sano y el número figuraba como conectado. Lo que delataba el problema era siempre lo mismo: menos mensajes de los normales, o ninguno. Por eso la vigilancia que sirve con Baileys no es "¿está prendido?", sino "¿cuántos mensajes entraron en la última hora comparado con lo habitual?". Un número que nunca está en cero y de pronto está en cero tiene un problema, aunque todo diga verde.

Entonces, ¿Baileys o la API oficial?

Depende de para qué es el número:

• Para responder a quien te escribe, en un número personal o de bajo volumen, Baileys o Evolution API pueden servir, asumiendo el riesgo y con vigilancia de verdad: alertas cuando el número deja de recibir, no solo cuando el servidor se cae.
• Para enviar campañas, atender a muchos clientes o conectar un CRM del que depende la venta, la respuesta es la API oficial. Tiene costo por mensaje y requisitos, pero los fallos dan error, el número es de tu empresa y nadie puede apagarte la operación con una actualización. Por estos riesgos migramos a la API oficial el número del puente de un cliente.

Si no estás seguro de qué usa tu proveedor, aquí explicamos cómo saber si tu WhatsApp usa la API oficial, y la diferencia de fondo está en WhatsApp Business o la API: cuál te toca. Cuando lo que está en juego son tus ventas, eso es lo que montamos con la API oficial de WhatsApp Business.