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.

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.
- 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.
- 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.
- 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.
- 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).
- 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.
| Criterio | API oficial (Cloud API) | API no oficial |
|---|---|---|
| Autorización | De Meta, con cuenta comercial | Ninguna |
| Costo | Tarifa de Meta por mensaje, más la plataforma | Servidor y mantenimiento |
| Riesgo para el número | Bajo, si sigues las políticas | Bloqueo temporal o permanente |
| Fuera de 24 horas | Plantilla aprobada | Sin regla, y sin protección |
| Recursos | Plantillas, botones, webhooks, coexistencia | Los de WhatsApp Web, mientras funcionen |
| Escala | Los límites crecen con la calidad | Más volumen, más riesgo |
| Soporte | Meta 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.
- Elige el camino: Cloud API directa o un BSP. El paso a paso está en cómo conseguir la API oficial de WhatsApp Business.
- Desconecta la sesión no oficial del número antes de migrar.
- 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.
- 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?

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
- api no oficial de whatsapp
- api de whatsapp gratis github
- api de whatsapp open source
- mejor api no oficial de whatsapp
- crm para whatsapp open source
- bloqueo de número whatsapp
- #api oficial de whatsapp
- #whatsapp cloud api
Citado en
- Agente de IA para WhatsApp con n8n: paso a paso y cuándo migrar
- Automatizar WhatsApp para empresas: qué automatizar y cómo empezar
- Chatbot para WhatsApp en pequeñas empresas: cómo elegir y precio
- Cómo crear un agente de IA para WhatsApp: n8n, plataforma o Meta
- CRM para WhatsApp gratis: qué es gratis de verdad y qué se paga
- Mensajes masivos en WhatsApp: listas de difusión, API y reglas
- WhatsApp con varios agentes gratis: qué funciona y cuándo pagar
- Agente de IA para WhatsApp: precio, tarifas de Meta y plataforma
- Integrar WhatsApp con CRM sin quitar la app del celular del vendedor
- Coexistencia de WhatsApp: usar la app y la API en el mismo número
- Chatbot para WhatsApp: cómo funciona y cómo crearlo
- API de WhatsApp Business: qué es, cómo funciona y precio en 2026
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



