OpenWA permite conectar herramientas propias con WhatsApp Web. OpenWA es una librería Node.js que convierte tu cuenta de WhatsApp Web en una API programable para bots, notificaciones y automatizaciones. Lleva desde 2019 en GitHub, acumula más de 3.600 estrellas y la v5 alfa ya incluye un servidor MCP para que agentes de IA operen sobre tus chats.
TL;DR: El resumen sin rodeos
- Qué es: biblioteca Node.js con código fuente disponible que convierte WhatsApp Web en API HTTP. La v5 alfa añade servidor MCP para agentes de IA.
- Coste: el núcleo es gratuito. Algunas funciones restringidas pueden requerir una clave de licencia (tarifas no publicadas en euros).
- Riesgo real: proyecto no oficial. El repositorio advierte de que se usa bajo responsabilidad del usuario.
- Estado: versión estable 4.76.0. La v5 está en alfa y no es apta para producción.
En este artículo
| Qué es | Librería Node.js que convierte WhatsApp Web en una API programable para bots, notificaciones y automatizaciones, con opción autoalojada y funciones restringidas que pueden requerir licencia. |
|---|---|
| Web oficial | https://openwa.dev/ |
| Repositorio | repo |
| Licencia | Hippocratic + Do Not Harm Version 1.0 |
| Precio | freemium |
| Estrellas en GitHub | 3.660 |
| Año de lanzamiento | 2019 |
| Quién lo mantiene | open-wa (organización) |
| Plataformas | Local (Node.js), Docker, alojamiento propio, CLI (npx) |
| Integraciones | Chatwoot, Webhook, S3, Node-RED, Cloudflare, MCP (Claude, Cursor, Windsurf) |
| Idioma | Inglés (interfaz y docs); no se menciona soporte en español |
Revisado el 2026-09-22
Esta herramienta forma parte de estos recopilatorios: Aplicaciones open source que sustituyen software de pago
El problema que resuelve
La plataforma oficial de WhatsApp Business tiene sus propios requisitos de alta y condiciones de uso y facturación. Conviene revisar la documentación vigente de Meta antes de comparar opciones.
Para una multinacional con departamento legal, perfecto. Para una agencia pequeña que quiere automatizar confirmaciones de cita o responder contactos fuera de horario, esa barrera es un muro.
OpenWA utiliza una integración no oficial. Monta un servidor local que se conecta a WhatsApp Web y expone funciones a través de una interfaz HTTP: enviar mensajes, recibir eventos, gestionar grupos, reenviar archivos. Tú administras la instancia y decides qué automatizar; la conexión sigue dependiendo de WhatsApp Web.
El proyecto nació en 2019, lo mantiene la organización open-wa y a septiembre de 2026 acumula más de 3.600 estrellas en GitHub. La versión estable es la 4.76.0.
Cómo se pone en marcha
Este ejemplo fija la versión estable 4.76.0. Su interfaz de línea de comandos declara la opción --key para la clave de acceso. Debes completar la vinculación de WhatsApp mediante el código QR.
npx @open-wa/wa-automate@4.76.0 --port 8080 --key "tu-clave-segura"La dirección http://localhost:8080/api-docs/ muestra la documentación de la API. Comprueba por separado la vinculación de la sesión. El proyecto también documenta Docker; revisa la etiqueta de la imagen y sus instrucciones antes de elegir una versión.
La documentación de la v5 alfa describe dos vías para integrarla en una aplicación Node.js. No son instrucciones específicas para la estable 4.76.0. SocketClient: tu app se conecta como consumidor remoto a una instancia de Easy API ya corriendo. O createClient en modo integrado: controlas directamente el navegador con drivers intercambiables (Puppeteer, Playwright o Lightpanda).
Si lo que te interesa es conectar agentes de IA, OpenWA incluye un servidor MCP (ojo: solo en la v5 alfa, no en la rama estable 4.76.0). Se activa en el archivo de configuración (mcp: { enabled: true }) y queda accesible en http://localhost:8080/mcp. Cualquier cliente MCP compatible descubre los métodos y puede ejecutarlos con la misma clave API.
Requisitos: Node.js, un número de WhatsApp y conexión a internet. La documentación recomienda proteger el acceso a la API; el servidor MCP de v5 exige una clave. La documentación oficial cubre la configuración en detalle, en los materiales en inglés consultados.
Usándola en marketing real
El caso de uso más directo: automatizar notificaciones transaccionales. Imagina una agencia con varios clientes de comercio electrónico: hay que confirmar pedidos por WhatsApp, responder dudas fuera de horario y derivar las complicadas a un humano. Con OpenWA montas una instancia por cliente, conectas un webhook a tu CRM (Chatwoot tiene integración nativa en el proyecto) y programas las respuestas. Necesitas infraestructura para ejecutar la instancia, como un servidor virtual privado.
¿Lo más interesante? El ángulo MCP. En la v5 alfa, OpenWA expone cada método de la API como herramienta MCP: un agente en Claude, Cursor o Windsurf puede utilizar las herramientas MCP expuestas para trabajar con mensajes y grupos tras configurar la conexión. Si ya trabajas con agentes de IA para tus campañas de marketing, esta pieza encaja como canal de entrada y salida dentro de un flujo de trabajo más amplio.
No he probado OpenWA con clientes reales, así que no voy a venderte que "funciona sin fisuras en producción". Lo que sí te digo: el planteamiento técnico es sólido y las piezas están ahí.
Aquí el marrón lo pone WhatsApp.
Lo que no te cuentan
¿Suena demasiado bien? Vamos con la letra pequeña. OpenWA no es la API oficial de WhatsApp. Es un proyecto independiente, no afiliado a Meta, que automatiza WhatsApp Web por debajo.
El proyecto se presenta como una solución no oficial y avisa de que se utiliza bajo responsabilidad del usuario. El repositorio dice: "This project is unofficial and is not affiliated with WhatsApp or Meta. Use it at your own risk". No uses tu número personal para pruebas. NUNCA.
La versión 5 es alfa. El README lo marca en rojo: "Use version 4 unless you are testing or contributing to v5". Mezclar documentación de ambas versiones es receta para perder media mañana buscando por qué algo no funciona.
La licencia publicada se llama Hippocratic + Do Not Harm Version 1.0. Consulta su texto antes de incorporar OpenWA a tu proyecto.
Funciones de pago sin tarifa pública en euros. El núcleo es gratuito, pero hay funciones restringidas que pueden requerir una clave de licencia. El proyecto no publica precios claros, así que antes de planificar un despliegue, consulta directamente en openwa.dev.
La documentación revisada está en inglés; las fuentes consultadas no documentan soporte en español.
Qué dice la gente
Las fuentes sociales recogidas para esta reseña incluyen estos comentarios de Hacker News.
"Ever wanted to turn your WhatsApp account into an API? Now you can with one command > npx @open-wa/wa-automate --help" smashah en hn
"I appreciate your hard work. I will try it" aymenitc en hn
En Hacker News, el usuario smashah presentó OpenWA en un Show HN destacando la simplicidad: "Ever wanted to turn your WhatsApp account into an API? Now you can with one command". En otro hilo sobre botones de WhatsApp, el usuario aymenitc respondió con un escueto "I appreciate your hard work. I will try it".
Los comentarios de Hacker News recogidos aquí ofrecen algunas impresiones técnicas. Esta reseña no incluye una prueba propia de Marketing Ultra.
Veredicto
OpenWA merece una evaluación si quieres conectar un bot interno con WhatsApp. Antes de usarlo con un cliente, contrasta los requisitos y la licencia del proyecto con las condiciones vigentes de la plataforma oficial de Meta.
Copia esto y pégalo en Claude Code, Cursor o tu asistente de código favorito:
Instala OpenWA fijando la versión 4.76.0. Comprueba primero sus opciones con npx @open-wa/wa-automate@4.76.0 --help. Usa --port 8080 y --key para definir la clave de acceso; no mezcles estas instrucciones con la documentación de v5 alfa. Pídeme que complete el código QR y verifica la sesión antes de probar el envío a un número que yo indique.
El asistente puede guiarte en la instalación. Tendrás que completar el código QR y comprobar la configuración antes de usar la instancia.
