Actualizado el 25/10/2026
Una API no oficial de WhatsApp es una biblioteca o servicio que controla una sesión de WhatsApp Web abierta con código QR, como Baileys, WPPConnect o Evolution API en modo Baileys. No cobra por mensaje, pero viola los Términos del Servicio de WhatsApp, que prohíben el acceso automatizado no autorizado, por lo que el número puede ser bloqueado en cualquier momento. La API oficial (Cloud API de Meta) tiene costo por mensaje y reglas de plantillas, pero es el único camino autorizado; conviene migrar cuando WhatsApp es una parte crítica de la operación.
Cómo funciona cada una
API no oficial. El software se conecta a los servidores de WhatsApp como si fuera WhatsApp Web o un dispositivo vinculado. Escaneas un código QR con el celular, la sesión queda guardada en el servidor y la biblioteca expone funciones para enviar y recibir mensajes. Baileys lo hace por WebSocket; WPPConnect exporta funciones de WhatsApp Web a Node.js. Ninguna tiene relación con Meta: el README de Baileys dice que el proyecto no está afiliado, autorizado ni respaldado por WhatsApp.
API oficial. La WhatsApp Cloud API está alojada por Meta. Tu sistema hace llamadas HTTPS con un token de acceso y recibe eventos por webhook. El número se registra en la plataforma, vinculado a un portafolio comercial, y la empresa acepta los términos de la WhatsApp Business Platform.
Evolution API es un caso aparte: según su propio README, admite tanto la conexión basada en Baileys como la Cloud API oficial. Lo que define el riesgo es el canal que eliges, no el nombre de la herramienta.
Qué dicen los Términos del Servicio
Los Términos del Servicio de WhatsApp, en la sección de uso aceptable, prohíben:
- acceder o usar el servicio «por medios automatizados» de forma no autorizada;
- crear cuentas por medios no autorizados o automatizados;
- hacer ingeniería inversa, modificar o extraer código del servicio;
- enviar comunicaciones no permitidas, como mensajes masivos, mensajes automáticos y marcación automática.
Los mismos términos indican que WhatsApp puede desactivar o suspender la cuenta de quien incumpla esas reglas. Una biblioteca que emula WhatsApp Web para automatizar envíos encaja justo en esos puntos. El propio README de Baileys afirma que sus mantenedores no apoyan usos que violen los Términos del Servicio y desaconsejan el envío masivo o automatizado.
¿Quieres probar mientras lees? Crea tu cuenta en Vectalk y envía el primer mensaje por la API oficial. Crear cuenta gratis →
Por qué se bloquean los números
No hay una lista pública de disparadores, y eso es lo que hace difícil gestionar el riesgo. Quien opera con una API no oficial suele ver:
- Bloqueos sin aviso, a veces justo después de conectar, a veces meses después.
- Fallas tras las actualizaciones de WhatsApp, que obligan a actualizar la biblioteca a toda prisa.
- Sesiones que se caen y piden un nuevo código QR, con alguien que debe tomar el celular.
Las denuncias y bloqueos de los destinatarios pesan en cualquier modelo. La diferencia es que, con una API no oficial, usar la herramienta ya es una infracción, así que no existe un «uso correcto» que elimine el riesgo. Si el número es bloqueado, recuperarlo exige pedir una revisión a WhatsApp, sin plazo ni garantía.
La API oficial también tiene controles: Meta sigue la calidad de los mensajes, puede pausar plantillas y restringir cuentas que violen la Política de Mensajería de WhatsApp Business. Pero el riesgo depende de qué envías y a quién, no de estar conectado. Las señales aparecen antes, en la calidad del número y en los límites, y hay canales de soporte y apelación.
Comparación lado a lado
| Criterio | API no oficial (Baileys, WPPConnect, Evolution en modo Baileys) | API oficial (Cloud API) |
|---|---|---|
| Autorización | No; viola los Términos del Servicio | Sí, producto de Meta para empresas |
| Conexión | Código QR y sesión guardada en el servidor | Token de acceso y HTTPS |
| Depende de un celular | Sí, el dispositivo principal debe seguir activo | No |
| Riesgo de bloqueo por usar la herramienta | Alto e impredecible | No existe; el riesgo viene de la calidad y las políticas |
| Iniciar una conversación | Mensaje libre | Plantilla aprobada |
| Responder al cliente | Libre | Libre dentro de la ventana de 24 horas |
| Costo por mensaje | Sin cobro de Meta | Por mensaje entregado, según categoría y país |
| Webhooks | Formato propio de cada biblioteca | Formato documentado por Meta |
| Estabilidad | Depende de ingeniería inversa | API versionada, con changelog y plazos |
| Grupos y listas de difusión | Acceso amplio | API de Grupos con reglas propias; sin listas de difusión |
| Soporte | Comunidad | Soporte de Meta y del proveedor |
Sobre el costo: Meta no cobra mensualidad por la API oficial y parte de los mensajes es gratis. Los detalles están en ¿existe una API de WhatsApp gratis?.
Cuándo migrar a la API oficial
Migra ya si al menos uno de estos puntos es cierto:
- WhatsApp es un canal principal de ventas, cobranza o atención, y un bloqueo detendría la operación;
- vendes software (CRM, ERP, plataforma) y conectas números de tus clientes;
- ya perdiste un número o las sesiones se caen con frecuencia;
- necesitas varios agentes, IA o integración con sistemas, con un historial confiable;
- tu cliente o tu área legal exige cumplir los términos de WhatsApp.
Puedes esperar, o quizá no necesites la API, si el uso es manual, de bajo volumen y la app WhatsApp Business te alcanza.
Revisa con cuidado antes de migrar si tu flujo depende de grupos grandes, listas de difusión, lectura de estados de los contactos o mensajes libres a personas que no te escribieron en las últimas 24 horas. La API oficial no replica esos usos y tu producto tendrá que cambiar.
Cómo migrar sin detener la operación
- Inventario. Separa lo que es respuesta al cliente (sigue igual) de lo que es mensaje iniciado por la empresa (pasa a ser plantilla).
- Cuenta en Meta. Un portafolio comercial, idealmente verificado. Mira cómo obtener acceso a la API de WhatsApp.
- Número. Si está en la app WhatsApp Business, puedes usar la coexistencia. Si está en WhatsApp normal, primero hay que liberarlo. Mira cómo liberar un número que ya está en WhatsApp.
- Plantillas. Créalas y aprúebalas antes del cambio; es la etapa que depende de Meta.
- Envío y webhooks. Cambia la capa de envío y reescribe la recepción de eventos.
- Cierra la sesión antigua antes de registrar el número en la Cloud API.
Un adaptador para la recepción
La mayor parte del trabajo está en el webhook, porque el formato cambia. Una forma de reducir el impacto es convertir el evento de Meta al mismo objeto interno que tu sistema ya usa:
// Convierte el webhook de la Cloud API al formato interno usado antes de la migración
export function normalizarWebhook(body) {
const eventos = [];
for (const entry of body.entry ?? []) {
for (const change of entry.changes ?? []) {
const v = change.value ?? {};
for (const m of v.messages ?? []) {
eventos.push({
tipo: 'mensaje',
numeroOrigen: m.from, // wa_id, sin @s.whatsapp.net
idMensaje: m.id, // wamid...
texto: m.text?.body ?? m.button?.text ?? null,
mediaId: m.image?.id ?? m.document?.id ?? m.audio?.id ?? null,
recibidoEn: new Date(Number(m.timestamp) * 1000),
canal: v.metadata?.phone_number_id,
});
}
for (const s of v.statuses ?? []) {
eventos.push({ tipo: 'estado', idMensaje: s.id, estado: s.status, error: s.errors?.[0]?.code ?? null });
}
}
}
return eventos;
}Observa que los archivos multimedia llegan como media_id, no como archivo: hace falta una llamada extra para descargarlos. Y los errores llegan en el webhook de estado, no en la respuesta del envío. Los más comunes están en errores de la API de WhatsApp.
Migrar a la API oficial con Vectalk
Vectalk es un proxy de la WhatsApp Cloud API oficial: los payloads y los webhooks son los de Meta, y solo cambian la URL base (https://apis.vectalk.com.br/api) y el token. Tú pagas a Vectalk y Vectalk paga a Meta. Vectalk ofrece coexistencia, así que si tu número está en la app WhatsApp Business puedes conectarlo a la API sin dejar la app.
Revisa la guía rápida (documentación en portugués) y crea tu cuenta en apps.vectalk.com.br/register. Para planear la migración con el equipo, usa la página de contacto.
Preguntas frecuentes
¿Evolution API es oficial?
Evolution API es un proyecto de código abierto que no pertenece a Meta. Ofrece dos modos: uno basado en Baileys, que emula WhatsApp Web y no está autorizado, y otro que usa la Cloud API oficial. Solo el segundo cumple las reglas de Meta.
¿Usar Baileys siempre termina en bloqueo?
No necesariamente, pero el riesgo existe desde el primer día y no se puede eliminar, porque el uso en sí viola los Términos del Servicio. Muchos números funcionan durante meses y caen sin aviso.
Mi número fue bloqueado usando una API no oficial. ¿Puedo usarlo en la API oficial?
Primero hay que recuperarlo con una solicitud de revisión a WhatsApp. Solo después de reactivado puede registrarse en la Cloud API.
¿En la API oficial el número nunca se bloquea?
Puede ser restringido si la empresa viola las políticas o tiene baja calidad, por ejemplo al enviar mensajes a quien no dio su consentimiento. La diferencia es que el riesgo depende de tu comportamiento y da señales antes, como una caída en la calidad.
¿Puedo mantener el mismo número al migrar?
En la mayoría de los casos, sí. Si el número está en la app WhatsApp Business, la coexistencia permite conectarlo a la API y seguir con la app. Si está en una sesión no oficial, desconéctala antes de registrarlo.
Fuentes oficiales consultadas el 25/10/2026: Términos del Servicio de WhatsApp, Política de Mensajería de WhatsApp Business, Descripción general de la Cloud API, Coexistencia: incorporación de usuarios de la app WhatsApp Business, README de Baileys, README de WPPConnect, README de Evolution API.
Pon a funcionar el WhatsApp oficial de tu empresa
Crea tu cuenta, conecta tu número a la API oficial (puedes mantener la app con coexistencia) y empieza a atender y enviar mensajes.