Saltar al contenido

API no oficial de WhatsApp: riesgos de bloqueo y lo que Meta permite

La API no oficial de WhatsApp es gratis y está en GitHub, pero el número puede ser bloqueado. Mira qué dicen los términos, los riesgos reales y la comparación con la API oficial.

Cofundador de Tolky

Actualizado el 19 de noviembre de 2026

9 min de lectura
API no oficial de WhatsApp: riesgos de bloqueo y lo que Meta permite

TL;DR

Una API no oficial de WhatsApp automatiza WhatsApp Web con bibliotecas y proyectos como Baileys, whatsapp-web.js, WAHA y el modo Baileys de Evolution API, sin aprobación de Meta. Es gratis, pero WhatsApp dice que las apps no oficiales violan sus términos y que la cuenta puede ser bloqueada de forma temporal o permanente. Para el número de la empresa, el camino seguro es la API oficial (Cloud API), con coexistencia para mantener la app.

Compartir

Quien busca "API de WhatsApp gratis en GitHub" encuentra decenas de proyectos que conectan un número en minutos, solo escaneando un código QR. Sin registro en Meta, sin aprobación de plantillas, sin tarifa por mensaje. Parece el atajo perfecto para un chatbot o una bandeja compartida.

El precio llega después: el número bloqueado, la sesión que se cae con cada actualización, los datos de clientes en un servidor sin control. Esta guía explica qué es una API no oficial, qué dicen de verdad los términos de WhatsApp, los riesgos concretos y cuándo conviene la API oficial.

Actualizado en noviembre de 2026.

¿Qué es una API no oficial de WhatsApp?

Una API no oficial de WhatsApp es un software que automatiza la cuenta de WhatsApp de un número, en general conectándose como WhatsApp Web, sin autorización de Meta. Lee y envía mensajes como si fuera un dispositivo vinculado, y lo expone a otros sistemas.

Los proyectos más citados son de código abierto. Según sus repositorios, consultados el 19 de noviembre de 2026:

  • Baileys: biblioteca en TypeScript que se comunica con WhatsApp Web por WebSockets, con licencia MIT.
  • whatsapp-web.js: biblioteca en Node.js que controla WhatsApp Web en un navegador automatizado.
  • WAHA: API HTTP que instalas en tu servidor; la sesión empieza escaneando el código QR con el celular.
  • Evolution API: admite dos modos, uno basado en Baileys y otro en la Cloud API oficial de Meta.

Este último punto importa: "no oficial" describe el modo de conexión, no el proyecto. Evolution API conectada a la Cloud API usa el canal oficial.

¿Por qué tanta gente usa una API no oficial?

La API no oficial es popular porque es gratis, no exige aprobación de Meta y funciona con el número que ya está en el celular. Para probar una idea, es el camino más corto.

  • Sin costo de software, y sin tarifa de Meta por mensaje.
  • Sin registro de cuenta comercial, verificación ni aprobación de plantillas.
  • Mensajes libres a cualquier hora, sin la regla de la ventana de 24 horas.
  • Muchos tutoriales e integraciones listas con n8n, Typebot y CRMs de código abierto.

Aquí entran las búsquedas de "API de WhatsApp open source" y "CRM para WhatsApp open source". Varios de esos sistemas son serios y útiles; el riesgo no está en el código abierto, sino en conectar el número por un canal no oficial.

¿Qué dicen los términos de WhatsApp sobre las APIs no oficiales?

Los términos de WhatsApp prohíben acceder o usar el servicio por medios automatizados no autorizados y enviar mensajes masivos o automáticos no permitidos, y el centro de ayuda dice que las apps no oficiales violan los términos. Las fuentes de abajo se leyeron el 19 de noviembre de 2026.

  • Condiciones del servicio: el usuario no debe, "directa, indirectamente, por medios automatizados u otros", acceder o usar los servicios de forma no autorizada; ni crear cuentas por medios no autorizados o automatizados; ni enviar comunicaciones ilegales o no permitidas, "como mensajes masivos, mensajes automáticos, marcación automática y similares" (traducción nuestra). Las violaciones pueden llevar a desactivar o suspender la cuenta.
  • Acerca de las apps no oficiales de WhatsApp: las apps y sitios no oficiales son versiones hechas por terceros sin aprobación de WhatsApp; usarlas o vincular la cuenta a ellas viola los términos, y la cuenta puede ser bloqueada de forma temporal o permanente.
  • Uso no autorizado de mensajes automáticos o masivos: WhatsApp dice que sus productos no fueron diseñados para mensajes automáticos o masivos, que usa aprendizaje automático para bloquear cuentas y que toma medidas legales contra empresas que violan los términos.

Los propios proyectos lo advierten. whatsapp-web.js dice que no hay garantía de que el número no sea bloqueado y que WhatsApp no permite bots ni clientes no oficiales. Baileys desaconseja el uso para mensajes masivos o automatizados.

Los términos hablan de uso no autorizado y de medidas sobre la cuenta. Esta guía no llama ilegal a nadie: el punto es el riesgo que asume la empresa.

¿Cuáles son los riesgos concretos para la empresa?

El mayor riesgo es perder el número de la empresa, pero la inestabilidad, la seguridad de los datos y la falta de soporte pesan en el día a día.

  1. Bloqueo del número. El bloqueo puede ser temporal o permanente. Según el centro de ayuda, solo WhatsApp bloquea o desbloquea cuentas, y los servicios de terceros no lo resuelven.
  2. El envío masivo se vuelve denuncia. Sin plantillas aprobadas ni opt-in, los mensajes masivos generan bloqueos y denuncias. Mira cómo hacer envíos masivos en WhatsApp por el camino oficial.
  3. Inestabilidad. La conexión depende de una interfaz que WhatsApp cambia cuando quiere. Una actualización puede tumbar la sesión y exigir un nuevo código QR.
  4. Seguridad y privacidad. La sesión da acceso a toda la cuenta, y las conversaciones quedan en el servidor de quien ejecuta el proyecto. Leyes de privacidad como la LGPD de Brasil exigen medidas de seguridad para proteger datos personales (Ley 13.709, art. 46).
  5. Sin soporte ni recursos oficiales. No hay a quién acudir en Meta, ni plantillas, cuenta verificada o la calidad del número como señal de salud.

API oficial o no oficial: ¿cuál es la diferencia?

La API oficial cuesta por mensaje y exige registro, pero protege el número y escala; la no oficial es gratis e inmediata, pero pone el número en riesgo.

CriterioAPI oficial (Cloud API)API no oficial
AutorizaciónDe Meta, con cuenta comercialNinguna
CostoTarifa de Meta por mensaje, más la plataformaServidor y mantenimiento
Riesgo para el númeroBajo, si sigues las políticasBloqueo temporal o permanente
Fuera de 24 horasPlantilla aprobadaSin regla, y sin protección
RecursosPlantillas, botones, webhooks, coexistenciaLos de WhatsApp Web, mientras funcionen
EscalaLos límites crecen con la calidadMás volumen, más riesgo
SoporteMeta y el proveedor (BSP)La comunidad del proyecto

Con la tabla vigente desde el 1 de octubre de 2026, consultada el 17 de noviembre de 2026, Meta da 1.000 mensajes de servicio gratis por número al mes; después, cada uno cuesta US$ 0,0085 para un número de México, y una plantilla de marketing, US$ 0,0397 (precios de WhatsApp Business Platform). Mira los nuevos precios de WhatsApp Business y simula en la calculadora de costo de la API de WhatsApp.

¿Cuándo alguien todavía elige la API no oficial?

La API no oficial todavía aparece en estudio, prototipos y uso personal, con un número que la persona acepta perder. Para aprender cómo funciona un bot, enseña rápido.

Para el número de la empresa, la cuenta cambia: un bloqueo cuesta más que años de tarifas. Si la idea es armar un agente con herramientas abiertas, puedes usar el canal oficial, como muestra la guía de agente de IA para WhatsApp con n8n.

¿Cómo pasar de la API no oficial a la oficial?

Para migrar, conecta el número a la Cloud API, directo con Meta o por un proveedor, y usa la coexistencia si quieres mantener la app en el celular.

  1. Elige el camino: Cloud API directa o un BSP. El paso a paso está en cómo conseguir la API oficial de WhatsApp Business.
  2. Desconecta la sesión no oficial del número antes de migrar.
  3. Mantén la app, si la necesitas. Con la coexistencia, el número sigue en la app WhatsApp Business y también funciona en la API, cuando está disponible para la cuenta.
  4. Prepara plantillas y opt-in para hablar con clientes fuera de la ventana de 24 horas.

Las ventajas de la API oficial están en la guía de beneficios de la API de WhatsApp Business.

¿Dónde entra Tolky?

Tolky atiende en el número oficial de tu empresa por la API oficial de WhatsApp Business, con conexión directa con Meta (Cloud API) o por Gupshup, socio oficial de Meta. No hay conexión por código QR ni por WhatsApp Web. Mira la pregunta ¿Tolky usa la API oficial de WhatsApp?

Captura real de la pantalla Servicios de Tolky en español, con la lista de conversaciones de WhatsApp de varios clientes, los filtros Todos, No Leídos y Pausados y el menú lateral contraído

En el mismo número, los agentes de IA atienden, pasan a personas con el historial y envían campañas con plantillas aprobadas. Con la coexistencia, cuando está disponible, el número sigue en la app del celular.

Lo que Tolky no hace: no usa APIs no oficiales ni paga las tarifas de Meta, que no forman parte del plan. WhatsApp entra desde el plan Starter; mira los planes.

Preguntas frecuentes

¿Usar una API no oficial de WhatsApp está prohibido?

Los términos de WhatsApp prohíben el acceso por medios automatizados no autorizados y dicen que las apps no oficiales violan los términos. La consecuencia prevista es una medida sobre la cuenta, como suspensión o bloqueo.

¿Cuál es la mejor API no oficial de WhatsApp?

Para el número de la empresa, ninguna es segura, porque el riesgo viene del modo de conexión. Si ya usas Evolution API, también tiene un modo con la Cloud API oficial.

¿Existe una API de WhatsApp gratis?

El código de las APIs no oficiales es gratis, pero el servidor y el riesgo no. En la API oficial, Meta da 1.000 mensajes de servicio gratis por número al mes y cobra por mensaje por encima de eso y por plantilla.

¿Un CRM para WhatsApp open source es seguro?

El software puede ser bueno; lo que define el riesgo es cómo se conecta el número. Por la API oficial, el riesgo para el número es bajo; por WhatsApp Web, hay riesgo de bloqueo.

Mi número fue bloqueado. ¿Qué hago?

Sigue la indicación de la app y pide revisión si aparece la opción. Solo WhatsApp puede desbloquear una cuenta; desconfía de quien prometa hacerlo.

¿Puedo migrar a la API oficial sin cambiar de número?

Sí. El número puede pasar a la Cloud API y, con la coexistencia, sigue en la app WhatsApp Business, cuando el recurso está disponible para la cuenta.


Conclusión

La API no oficial de WhatsApp es gratis y rápida, pero pone en riesgo el activo más difícil de cambiar: el número de la empresa. Para estudiar, sirve; para atender clientes, la API oficial cuesta por mensaje y devuelve estabilidad, plantillas y un número protegido.

Mira los planes, conoce los beneficios de la API oficial, calcula el costo de WhatsApp o habla con el equipo →. ¿Hablamos?

Compartir

Etiquetas

Sobre el autor

Cofundador de Tolky

Marlos Carmo es un emprendedor en IA y fundador de Tolky, la infraestructura y AI CRM de la era conversacional que unifica el servicio inteligente, la omnicanalidad (como WhatsApp y voz), el CRM en vivo y la inteligencia operativa en un único ecosistema. Es finalista del SXSW Innovation Awards e integrante de la Francesco's Economy, una red global de jóvenes emprendedores enfocados en la innovación y el impacto social. Trabaja conectando la Inteligencia Artificial y la transformación digital en proyectos para grandes organizaciones.

Siguiente paso

¿Quieres llevar esto a tu operación?

Tati, la asistente de IA de Tolky, entiende tu escenario en pocas preguntas, sugiere el mejor camino y te conecta con una persona del equipo con todo el contexto.

Compartir

Lea también sobre la API y el precio de WhatsApp