Evolution API o ZapClaw: ¿cuál debo usar para WhatsApp?
En resumen: Evolution API es un software de código abierto que ejecutas en tu propio servidor, conectado por WhatsApp Web (Baileys) o por la Cloud API oficial de Meta con tu propia app de Meta. ZapClaw es un gateway alojado en la Cloud API oficial de Meta: te conectas en la ventana de Embedded Signup de Meta sin una app de Meta propia, y el número sigue funcionando en la app de WhatsApp Business. Elige Evolution API para tener control total del código en tus servidores, y ZapClaw para no mantener un servidor ni configurar una app en Meta.
ZapClaw conecta tu número a la Cloud API oficial de Meta por Coexistencia. Sin servidor que mantener y sin una app de Meta propia.
Empieza gratisDos productos de Evolution Foundation
Evolution API es un software de código abierto que instalas en tu propio servidor. Su README dice que admite tanto la API de WhatsApp Web basada en Baileys como la Cloud API oficial de WhatsApp, y eliges una de las dos por instancia:
- El modo Baileys se conecta por WhatsApp Web: con el inicio rápido de Evolution creas la instancia y escaneas un código QR con WhatsApp en tu celular. El README advierte que este método depende de la versión web de WhatsApp.
- El modo Cloud API llama a la Cloud API oficial de WhatsApp, de Meta. La guía de Evolution te pide crear tu propia app en Facebook Developers, tener un Business Manager (aprobado, en palabras de la guía), generar un token permanente y configurar tú mismo el webhook en tu app de Meta.
Evo Hub es un producto aparte y alojado que vende Evolution Foundation. Su sitio web lo describe como un proxy entre tú y la API de Meta, para la Cloud API de WhatsApp, Instagram y Messenger. Se cobra por canal, y cada conexión cuenta como uno: desde R$ 97 al mes por 3 canales, y todos los planes indican tanto una app de Meta propia como una compartida. Su página no dice si admite la Coexistencia, así que pregúntale a Evo Hub antes de contar con ella. La tabla compara Evolution API self-hosted en sus dos modos.
Lado a lado
| Evolution API, modo Baileys | Evolution API, modo Cloud API | ZapClaw | |
|---|---|---|---|
| Cómo se conecta | WhatsApp Web, con la librería Baileys. Escaneas un código QR con tu celular. | Cloud API de WhatsApp, de Meta, con un token permanente de tu propia app de Meta. | Cloud API de WhatsApp, de Meta, por Coexistencia. Te conectas en la ventana de Embedded Signup de Meta. |
| API oficial de Meta | No: depende de WhatsApp Web. | Sí. | Sí. |
| El número sigue en la app de WhatsApp Business | El celular conserva WhatsApp: la sesión es un dispositivo vinculado, como WhatsApp Web. | La documentación de Evolution no menciona la Coexistencia. | Sí, por Coexistencia. |
| Quién lo ejecuta | Tú, en tu propio servidor: Node.js 20 o posterior, PostgreSQL o MySQL, y Redis. Su documentación recomienda Docker para producción. | ZapClaw aloja el gateway. Tú solo ejecutas el sistema que recibe tu webhook. | |
| App de Meta y App Review | No interviene ninguna app de Meta. | Tu propia app de Meta, Business Manager y token permanente. La guía no menciona App Review. | Nada de tu lado: te conectas por la app de Meta de ZapClaw, y ZapClaw es Tech Provider de Meta. |
| Números y precio | Sin costo de licencia: la página de licencias de Evolution Foundation dice que sigue siendo gratuita, self-hosted y sin límites de uso. Pagas tu servidor, y en el modo Cloud API el README advierte que puede haber costos por mensaje. | Plan gratuito: 1 número y 500 mensajes al mes, sin tarjeta. Business: US$ 29 al mes por cuenta, números ilimitados, 20,000 mensajes incluidos. Meta te cobra sus propias tarifas directamente, sin margen de ZapClaw. | |
| Recepción de mensajes | Webhooks, más integraciones de eventos como RabbitMQ, Apache Kafka, Amazon SQS y Socket.io. No verificamos su política de reintentos, así que los reintentos no se comparan aquí. | Tu webhook, firmado con HMAC-SHA256. Hasta 3 intentos (de inmediato, luego a los 30 y a los 120 segundos), cada uno registrado, y los eventos no entregados se guardan para reenviarlos. | |
| Envío de mensajes | API REST. | API REST, con tu clave en el encabezado X-API-Key. |
|
| Chatwoot | Integración nativa con Chatwoot, según su README. | Modo de compatibilidad: el propio canal WhatsApp Cloud de Chatwoot habla con ZapClaw en lugar de Meta. | |
| Grupos | Su documentación lista endpoints para grupos. | No se admiten: los grupos siguen funcionando en la app de WhatsApp Business, pero la Cloud API de Meta no los admite en la Coexistencia. | |
| Código y licencia | Código abierto, Apache 2.0 con condiciones adicionales de protección de marca. Desde la versión 2.4.0, que seguía como release candidate cuando la revisamos, pide una activación de licencia gratuita en el primer acceso. | Un servicio alojado que usas por su API y su panel. | |
Cuándo Evolution API es la mejor opción
- Quieres todo en tus propios servidores. El código es abierto, no hay costo de licencia, y la página de licencias de Evolution Foundation dice que sigue siendo gratuita y sin límites de uso.
- Ya tienes tu propia app aprobada en Meta. El modo Cloud API de Evolution funciona con tu app, tu token y tu número, sin ningún gateway de por medio.
- Dependes de los grupos de WhatsApp. La documentación de Evolution API lista endpoints para grupos. ZapClaw se conecta por Coexistencia, donde los grupos siguen funcionando en la app de WhatsApp Business, pero la Cloud API de Meta no los admite.
- Quieres sus integraciones incluidas. Su README lista Typebot, Dify, OpenAI, RabbitMQ, Apache Kafka, Amazon SQS y almacenamiento S3, entre otras.
Cuándo ZapClaw es la mejor opción
- Quieres la API oficial de Meta sin mantener un servidor. Nada que instalar, ninguna base de datos ni actualizaciones de tu lado, y ninguna app, token ni webhook que configurar en Meta.
- El número tiene que seguir en la app de WhatsApp Business. Meta abre la Coexistencia solo a Solution Partners y Tech Providers, y convertirse en Tech Provider exige la verificación del negocio y App Review. ZapClaw es Tech Provider de Meta, así que no necesitas convertirte en uno.
- Manejas muchos números o clientes. Los planes de pago conectan números ilimitados por un solo precio por cuenta, y el plan Agency mantiene separados los números, contactos, plantillas, claves de API y webhook de cada cliente.
- Quieres entregas que puedas revisar. Cada llamada al webhook va firmada, se reintenta y queda registrada, y un evento que tu servidor no recibió se puede reenviar desde el panel.
- Usas tu propia instalación de Chatwoot. Su canal nativo de WhatsApp Cloud se conecta a ZapClaw con una variable de entorno y una llamada a la API por número.
ZapClaw no es la herramienta para envíos masivos, para más de 20 mensajes por segundo, ni para grupos, llamadas de voz y video o la marca de verificación de cuenta de empresa oficial, que Meta no ofrece en la Coexistencia.
Cómo pasar de Evolution API a ZapClaw
Tus clientes siguen escribiendo al mismo número. Lo que cambia depende del modo que usabas:
- Desde el modo Baileys. El número tiene que estar en la app de WhatsApp Business, en la versión 2.24.17 o posterior (todos los requisitos). Cuando se conecta a ZapClaw, Meta desvincula todos los dispositivos vinculados, incluida la sesión de Evolution. Después, Meta te deja volver a vincular los dispositivos compatibles.
- Desde el modo Cloud API. Si el número solo funciona en la API, primero tiene que volver a la app de WhatsApp Business: consulta cómo cambiar el número de proveedor.
- Tu integración. El payload del webhook de ZapClaw no es el de Evolution, así que cambia el código que lee los eventos entrantes, y enviar pasa a ser una llamada a la API REST de ZapClaw con tu clave de API. Las dos cosas están en la documentación (en inglés).
- Chatwoot. Si usabas la integración de Evolution con Chatwoot, el propio canal WhatsApp Cloud de Chatwoot puede hablar con ZapClaw: consulta Chatwoot en la API oficial de WhatsApp.
La migración completa, paso a paso, con los principales campos de envío y de webhook mapeados a los de ZapClaw: cómo migrar de Evolution API a la API oficial de WhatsApp.
Preguntas frecuentes
¿Evolution API es oficial?
Depende del modo. Evolution API es un proyecto de código abierto de Evolution Foundation. En el modo Cloud API llama a la Cloud API oficial de WhatsApp, de Meta, con tu propia app de Meta. En el modo Baileys se conecta por WhatsApp Web, y el README de Baileys dice que la librería no está afiliada, asociada, autorizada ni respaldada por WhatsApp.
¿Puedo seguir usando el mismo número en la app de WhatsApp Business?
Con ZapClaw, sí. Se conecta por Coexistencia, que la documentación de Meta describe como llevar un número de la app de WhatsApp Business a la Cloud API mientras el negocio sigue respondiendo uno a uno desde la app. La documentación de Evolution API no menciona la Coexistencia (revisado el 14 de octubre de 2026). En el modo Baileys, la sesión es un dispositivo vinculado al WhatsApp de tu celular, como WhatsApp Web.
¿Necesito un servidor?
Para Evolution API, sí: la instalas con Node.js 20 o posterior, PostgreSQL o MySQL y Redis, y su documentación recomienda Docker para producción. Para ZapClaw, no: ZapClaw ejecuta el gateway, y solo necesitas lo que recibe tu webhook, como tu bot, tu app o tu propia instalación de Chatwoot.
¿Evo Hub es lo mismo que Evolution API?
No. Evo Hub es un producto alojado de Evolution Foundation sobre las API oficiales de Meta, con precio por canal. Evolution API es el software de código abierto que alojas tú mismo, y las preguntas frecuentes del propio Evo Hub dicen que Evolution API se enfoca en integraciones para instancias de WhatsApp Web.
¿Pueden bloquear (banear) mi número?
El Centro de ayuda de WhatsApp dice que vincular tu cuenta a versiones no oficiales de WhatsApp infringe sus Condiciones del servicio y que la cuenta podría bloquearse de forma temporal o permanente. Menciona apps como GB WhatsApp, no Evolution API ni Baileys. En la Cloud API oficial de Meta, que usan ZapClaw y el modo Cloud API de Evolution, las políticas de mensajes de Meta siguen aplicando: Meta puede restringir o desactivar una cuenta que las incumple, y la documentación de ZapClaw (en inglés) muestra el error que reciben tus llamadas a la API cuando eso pasa.
Fuentes
Revisado el 14 de octubre de 2026. Los precios, las versiones y las funciones cambian, así que revisa cada fuente antes de decidir.
- README de Evolution API en GitHub (en inglés): tipos de conexión, integraciones, requisitos previos y licencia.
- Documentación de Evolution API, visión general (en portugués): los dos tipos de conexión, webhooks, eventos y grupos.
- Guía de instalación de Evolution API (en portugués): Docker y la conexión por código QR.
- Evolution API, guía de la Cloud API de WhatsApp (en portugués): app de Meta, Business Manager, token permanente y webhook.
- Licencias de Evolution Foundation (en portugués) y el archivo LICENSE (en inglés).
- Versiones de Evolution API en GitHub (en inglés): la 2.3.7 es la versión estable más reciente (5 de diciembre de 2025), y la 2.4.0 tuvo dos release candidates en mayo de 2026.
- Documentación de Evolution Foundation, texto completo, revisada en busca de Coexistencia.
- Evo Hub (en portugués): planes, canales y preguntas frecuentes.
- Meta, incorporación de usuarios de la app de WhatsApp Business (en inglés): la Coexistencia, sus requisitos y los dispositivos vinculados.
- Meta, primeros pasos como Tech Provider (en inglés): verificación del negocio y App Review.
- Centro de ayuda de WhatsApp, Acerca de las apps no oficiales (en inglés).
- README de Baileys en GitHub (en inglés): aviso legal.
- ZapClaw: precios, webhooks y Chatwoot en la documentación (en inglés), y qué necesitas para conectar.
Compara también ZapClaw y Z-API, o lee cómo se compara la API oficial de WhatsApp con las librerías no oficiales.