¿API no oficial de WhatsApp o la API oficial: cuál usar?

En resumen: una API no oficial de WhatsApp ejecuta una sesión de WhatsApp Web que vinculas escaneando un código QR, y whatsapp-web.js y WAHA, dos de los proyectos detrás de esas herramientas, escriben en su propia documentación que WhatsApp no permite bots ni clientes no oficiales. La Cloud API oficial de Meta es el camino que Meta ofrece a las empresas, y con la Coexistencia tu número sigue funcionando en la app de WhatsApp Business. A cambio, trabajas con plantillas de mensajes, las tarifas de Meta y las políticas de Meta, que siguen vigentes.

ZapClaw conecta tu número a la API oficial de WhatsApp por Coexistencia, sin que necesites una app propia en Meta, y la app de WhatsApp Business sigue en tu celular.

Empieza gratis

Los dos caminos lado a lado

En términos generales, no proveedor por proveedor. Las secciones de abajo dan la fuente de cada línea.

	Librería o gateway basado en WhatsApp Web	Cloud API oficial de Meta
Cómo se conecta	Escaneas un código QR con el celular y una librería controla desde un servidor la sesión de WhatsApp Web que se abre.	El número se registra en la API de Meta, con el Embedded Signup de un proveedor o con tu propia app en Meta.
Quién está detrás	Proyectos de código abierto y empresas. Baileys, whatsapp-web.js y WAHA declaran que no están afiliados a WhatsApp.	Meta.
Reglas de WhatsApp	Las Condiciones del servicio de WhatsApp prohíben el acceso automatizado que WhatsApp no autorizó y el envío automático de mensajes.	Se aplican las políticas de mensajes de WhatsApp, como a cualquier empresa.
Restricciones de la cuenta	whatsapp-web.js y WAHA dicen que su método no debe considerarse totalmente seguro.	Meta puede restringir o desactivar una cuenta que incumpla sus políticas.
La app de WhatsApp Business	Sigue funcionando: la sesión es uno de los dispositivos vinculados del celular.	Sigue funcionando con la Coexistencia. Sin ella, el número funciona solo en la API.
App en Meta y App Review	Ninguna: no se usa la API de Meta.	Tu propia app en Meta, o la de un proveedor. Para la Coexistencia, Meta exige un Solution Partner o Tech Provider, y ser Tech Provider requiere la verificación del negocio y App Review.
Iniciar una conversación	Como en WhatsApp Web.	Respuestas libres hasta 24 horas después del último mensaje del cliente; fuera de esa ventana, una plantilla aprobada por Meta.
Tarifas de Meta	Ninguna, porque no se usa la API de Meta.	Cada plantilla y, desde el 1 de octubre de 2026, las respuestas por la API que pasen de las 1,000 gratis por número al mes. Las respuestas escritas en la app siguen siendo gratis.
Grupos, llamadas, visualización única	Depende de la librería o del gateway.	No con la Coexistencia.
Costo del software	Baileys (MIT), whatsapp-web.js y WAHA (Apache-2.0) son de código abierto y funcionan en tu servidor; los gateways alojados cobran su propia tarifa.	Las tarifas de Meta de arriba, más la tarifa de un proveedor si usas uno.

Qué es una API no oficial de WhatsApp

Todas las herramientas de este grupo funcionan igual por dentro. Escaneas un código QR con el celular, la sesión aparece en la app en Dispositivos vinculados y una librería en un servidor envía y recibe como esa sesión. Nada pasa por la Cloud API de Meta, así que no hay app que crear en Meta ni paso de aprobación. Los nombres que la gente busca:

Baileys. Una librería en TypeScript que se comunica con WhatsApp Web por WebSockets. Su README dice que el proyecto no está afiliado a WhatsApp y agrega que desaconseja usarlo para stalkerware o para el envío masivo o automatizado.
whatsapp-web.js. Ejecuta WhatsApp Web en un navegador controlado con Puppeteer. Su README dice que el proyecto no está afiliado a WhatsApp y que WhatsApp no permite bots ni clientes no oficiales en su plataforma.
WAHA. Se describe como una capa de unión sobre motores de WhatsApp mantenidos por la comunidad y ofrece cuatro: WEBJS y WPP ejecutan un navegador real con Puppeteer, mientras que NOWEB y GOWS se comunican con WhatsApp Web por WebSocket, en Node.js y en Go (motores). Su introducción trae el mismo aviso y no da ninguna garantía contra bloqueos.
Evolution API en modo Baileys. Evolution API ofrece dos tipos de conexión, Baileys y la Cloud API de Meta. En modo Baileys, que su documentación describe como una API gratuita basada en WhatsApp Web, conectas la instancia escaneando un código QR, y el README advierte que ese método depende de la versión web de WhatsApp.
El producto de código QR de Z-API (la Z-API clásica). La documentación de Z-API dice que basta con leer su código QR para trabajar sobre una sesión de WhatsApp Web, y la documentación de Omni lo llama una conexión no oficial. El otro producto de Z-API, Z-API Omni, funciona sobre la API oficial de Meta (ver abajo).

Qué dice WhatsApp sobre las apps no oficiales y la automatización

El artículo Acerca de las apps no oficiales del Servicio de ayuda de WhatsApp dice que vincular tu cuenta a versiones no oficiales de WhatsApp incumple sus Condiciones del servicio, y que la cuenta también podría quedar bloqueada de forma temporal o permanente. Los ejemplos que nombra son apps: GB WhatsApp, FM WhatsApp, TM WhatsApp y TeleMessage. No nombra ninguna librería ni ningún gateway de API.

Un segundo artículo, sobre mensajes automatizados o masivos, dice que los productos de WhatsApp no están pensados para el envío masivo o automatizado, y que WhatsApp toma acciones legales contra ese uso, lo que desde el 7 de diciembre de 2019 incluye actuar a partir de las declaraciones públicas de empresas.

Las Condiciones del servicio de WhatsApp prohíben acceder o usar el servicio por medios automatizados de una forma que WhatsApp no autorizó, aplicar ingeniería inversa o extraer su código, y el envío masivo o automático de mensajes. Le permiten a WhatsApp suspender o cancelar el acceso.

Cómo aplica WhatsApp estas reglas a cada herramienta lo decide WhatsApp. Esta página reproduce lo que publican WhatsApp y los propios proyectos; no es un pronóstico.

El camino oficial: la Cloud API de Meta y la Coexistencia

La Cloud API es la API que Meta ofrece a las empresas para WhatsApp: tu sistema recibe los mensajes en un webhook y envía con llamadas a la API, sin ninguna sesión de WhatsApp Web de por medio. Un número registrado solo en la API funciona solo en la API, no en la app. La Coexistencia cambia eso. La documentación de Meta describe cómo conectar un número que ya funciona en la app de WhatsApp Business, una función que a veces se llama Coexistencia:

La app sigue funcionando. La empresa todavía puede enviar mensajes individuales desde la app de WhatsApp Business, y las conversaciones se mantienen sincronizadas con la API. Los mensajes enviados desde la app siguen siendo gratis.
Historial. Se pueden sincronizar hasta los últimos 6 meses de chats. Los grupos no se sincronizan.
Requisitos. La app de WhatsApp Business en la versión 2.24.17 o posterior, y una conexión hecha por una empresa que ya sea Solution Partner o Tech Provider. ZapClaw es Tech Provider de Meta. Sigue abriendo la app en tu celular principal: Meta desconecta el número después de unos 14 días sin usarla.
Velocidad de envío. Fija en 20 mensajes por segundo.
Dispositivos vinculados. Cuando el número se conecta, Meta desvincula todos los dispositivos vinculados. Los compatibles se pueden volver a vincular; WhatsApp para Windows y WearOS, no.

Qué cambia cuando pasas a la API oficial

Plantillas y la ventana de 24 horas. Respondes libremente hasta 24 horas después del último mensaje del cliente. Para iniciar una conversación, o para escribir después de que esa ventana se cierra, envías una plantilla de mensaje que Meta aprobó antes.
Las tarifas de Meta. Meta te cobra directamente cada plantilla que envías y, desde el 1 de octubre de 2026, las respuestas que envías por la API después de las primeras 1,000 gratis por número cada mes, con la tarifa del país del destinatario. Las respuestas escritas en la app de WhatsApp Business siguen siendo gratis. ZapClaw nunca le agrega margen a las tarifas de Meta (precios).
Las políticas de Meta. Siguen vigentes: Meta puede restringir o desactivar una cuenta de WhatsApp Business que las incumpla. ZapClaw reenvía esos eventos a tu webhook, y su API responde 403 con ACCOUNT_RESTRICTED mientras dure la restricción (errores).
Lo que la Coexistencia deja fuera. La API no envía mensajes en grupos, no hace llamadas de voz ni de video y no envía mensajes de visualización única, y un número en Coexistencia no recibe la insignia azul de Meta. Si tu automatización depende de algo de esto, revísalo antes de migrar.

Caminos hacia la API oficial

Cada camino, con lo que te pide:

Directo con Meta, con tu propia app. Creas una app en Meta for Developers, generas el token y configuras el webhook por tu cuenta. Para mantener el número en la app de WhatsApp Business, Meta exige que la empresa que hace la conexión ya sea Solution Partner o Tech Provider, y ser Tech Provider requiere la verificación del negocio y App Review, con un video de tu app enviando mensajes y administrando plantillas.
Un proveedor como ZapClaw. ZapClaw es Tech Provider de Meta: conectas el número en la ventana de Meta sin app propia y sin App Review, y el número sigue en la app de WhatsApp Business por Coexistencia. Los mensajes entrantes llegan a tu webhook firmados con HMAC-SHA256, con hasta 3 intentos de entrega, y envías por una API REST. El precio es por cuenta, no por número, y los planes de pago aceptan números ilimitados.
Evolution API en modo Cloud API. La misma Evolution API self-hosted puede conectarse a la Cloud API de Meta en lugar de Baileys. Su guía pide una app tuya en Facebook Developers y un token permanente, y configuras el webhook en esa app.
Evo Hub. El producto de pago y alojado de la Evolution Foundation, que ella describe como un proxy entre tú y la API de Meta, para WhatsApp, Instagram y Messenger, con precio por canal (cada conexión cuenta como uno). Su sitio web no decía si admite la Coexistencia cuando lo revisamos.
Z-API Omni. El producto de Z-API sobre la API oficial de Meta. Su documentación dice que se conecta con el Embedded Signup de Meta, admite la Coexistencia y tiene precio por canal, y que un canal es un número de WhatsApp Business.

Dos de ellos lado a lado con ZapClaw: ZapClaw vs Evolution API y ZapClaw vs Z-API.

Cuándo conviene más una herramienta basada en WhatsApp Web

Tu flujo depende de grupos, llamadas de voz o de video, o mensajes de visualización única. Con la Coexistencia, la API de Meta no ofrece nada de eso.
No quieres un portfolio comercial en Meta, ni plantillas de mensajes, ni tarifas de Meta, y aceptas lo que dicen las condiciones de WhatsApp y los avisos de los propios proyectos.
Quieres código abierto funcionando de punta a punta en tu propio servidor.

Cuándo conviene más ZapClaw

Tu número es parte de tu negocio y lo quieres en la API oficial de Meta, no en una sesión de WhatsApp Web.
Quieres seguir respondiendo desde la app de WhatsApp Business mientras tu bot, tu agente de IA o tu sistema usa la API.
No quieres crear una app en Meta, pasar por App Review ni convertirte en Tech Provider.
Manejas varios números o clientes: los planes de pago aceptan números ilimitados con un solo precio por cuenta, y en el plan Agency cada cliente queda aislado de los demás.
Usas tu propia instalación de Chatwoot: su canal nativo de WhatsApp Cloud se conecta a ZapClaw.

ZapClaw no sirve para envíos masivos, más de 20 mensajes por segundo, grupos, llamadas de voz o de video, ni la insignia azul. Esos límites son de Meta, con la Coexistencia.

Cómo pasar de una herramienta basada en WhatsApp Web a ZapClaw

Revisa que el número funcione en la app de WhatsApp Business, en la versión 2.24.17 o posterior, y no en WhatsApp normal: la Coexistencia solo conecta números de la app de WhatsApp Business. Revisa todos los requisitos.
Crea tu cuenta en ZapClaw y conecta el número en la ventana de Meta desde el panel. Cuando se conecta, Meta desvincula todos los dispositivos vinculados, incluida la sesión de la herramienta que usas hoy.
Apunta tu integración a ZapClaw. Los mensajes llegan a tu webhook con el formato de ZapClaw, no con el de tu librería, así que mapea los campos una sola vez con la referencia del webhook (en inglés). Envías con una llamada REST y el encabezado X-API-Key.
Crea las plantillas que necesitas para iniciar conversaciones y envíalas a Meta para su aprobación por la API.

¿El número ya está en otro proveedor de la API de Meta? Sácalo de ahí primero. ¿Usas Chatwoot? Conéctalo por su canal nativo de WhatsApp Cloud.

Guías paso a paso, con los principales campos de envío y de webhook mapeados a los de ZapClaw: desde Evolution API, desde Z-API y desde WAHA.

Preguntas frecuentes

¿Pueden bloquear (banear) mi número en una API no oficial?

Nadie puede decirlo de antemano, ni en un sentido ni en el otro. El Servicio de ayuda de WhatsApp dice que una cuenta vinculada a versiones no oficiales de WhatsApp también podría quedar bloqueada de forma temporal o permanente, y los ejemplos que da son apps, no librerías. whatsapp-web.js y WAHA escriben que su método no debe considerarse totalmente seguro, y la documentación de Z-API responde, sobre su producto de código QR, que la posibilidad de un bloqueo existe y es real. En la API oficial, las políticas de Meta siguen vigentes, y Meta puede restringir una cuenta que las incumpla.

¿Puedo pasar mi número a la API oficial sin perder la app de WhatsApp Business?

Sí, con la Coexistencia. La documentación de Meta dice que la empresa conectada así todavía puede enviar mensajes individuales desde la app de WhatsApp Business. Necesitas la app en la versión 2.24.17 o posterior y una conexión por un Solution Partner o Tech Provider, como ZapClaw. Los dispositivos vinculados se desvinculan cuando el número se conecta, los grupos no se sincronizan y la velocidad de envío es fija en 20 mensajes por segundo. Todos los requisitos.

¿Necesito una empresa registrada o la verificación del negocio?

No para conectar. Para la Coexistencia, Meta pide la app de WhatsApp Business en el número y una cuenta de Facebook, y la verificación del negocio no está en la lista. La verificación cambia algunos límites de Meta, como a cuántas personas distintas puedes escribir con plantillas en 24 horas. El registro en ZapClaw no pide identificación fiscal, dirección ni tarjeta. La API oficial sin empresa registrada.

¿Evolution API y Z-API son no oficiales?

Depende del producto. Evolution API se conecta por Baileys (WhatsApp Web) o por la Cloud API de Meta con tu propia app en Meta, y la Evolution Foundation también vende Evo Hub, un proxy alojado hacia la API de Meta. El producto clásico de Z-API ejecuta una sesión de WhatsApp Web que vinculas con un código QR, mientras que Z-API Omni funciona sobre la API oficial de Meta. Detalles: ZapClaw vs Evolution API y ZapClaw vs Z-API.

¿Existe una API de WhatsApp sin aprobación de Meta?

Las herramientas basadas en WhatsApp Web no piden ninguna, porque no usan la API de Meta; lo que dice WhatsApp sobre ellas está arriba. En la API oficial, un Tech Provider te ahorra la app en Meta y el App Review: conectas el número en la ventana de Meta. Meta igual revisa cada plantilla de mensaje antes de que puedas enviarla.

Guías relacionadas

Fuentes

Revisado el 14 de octubre de 2026.