Alguien liberó una API de WhatsApp open source que te ahorra pagar por cada mensaje: se llama OpenWA, corre en tu propio servidor y tiene licencia MIT. En esta guía la levantás con Docker en minutos y mandás tu primer mensaje por API. Todo con los comandos reales del repo oficial, creado por @rmyndharis.
01 · ¿Qué es OpenWA?
Una API de WhatsApp que corre en TU servidor · sin intermediarios
OpenWA es un gateway HTTP self-hosted para WhatsApp: un servicio que levantás vos y que te deja controlar WhatsApp por código, sin pasar por un proveedor pago ni por la API oficial de Meta. Mandás mensajes, recibís eventos en tiempo real y automatizás flujos, todo por REST.
Está construido sobre NestJS con un motor de WhatsApp intercambiable, base de datos configurable y autenticación por X-API-Key. Es MIT, así que lo usás gratis incluso en proyectos comerciales.
Garantía: no pagás fee por mensaje ni por sesión. Tu único costo es el servidor donde corra.
¿Quieres el stack de IA correcto operando en tu negocio?
Sin demos infinitas. Sin contratar consultor. Sin elegir mal.
Agendar llamadaMarcas que confiaron en Claura
- Bissu Abogados
- Isha Judd
- Luxom Developments
- RE/MAX Patagon
- Bitget Wallet
- SpacePal
- Margaret Bissu
- Soy Andina
02 · ¿Qué es el repo de OpenWA en GitHub y quién lo mantiene?
El código completo vive en github.com/rmyndharis/OpenWA, creado y mantenido por @rmyndharis. Ahí está todo: el código fuente, la licencia MIT, el Docker Compose para levantar el stack y el README con la documentación técnica completa.
Antes de clonarlo, el propio repo pide leer una sección puntual antes de conectar un número real, con las guías de envío seguro que vas a necesitar más abajo en esta guía. Conviene seguir el repo (star o watch) para enterarte cuando salga una release nueva, porque el proyecto sigue activo.
Si preferís no correr git clone, el repo también tiene un Docker Compose listo para copiar y pegar, así que no hace falta bajar el código fuente para levantar la API.
Nota: "OpenWA" comparte campo semántico con otros gateways de WhatsApp open source de nombre parecido, como WAHA. Google lo confirma en su sección de People Also Ask, donde pregunta directamente "Is Waha API free?" junto a las preguntas sobre OpenWA. No son el mismo proyecto y acá no comparamos sus funciones, porque no las verificamos en este research: esta guía cubre específicamente el repo de @rmyndharis.
Otra fuente que indexa el proyecto es el mirror de SourceForge, que lo describe como un gateway de WhatsApp self-hosted pensado para desarrolladores que quieren control sobre su infraestructura de mensajería sin depender de un proveedor cerrado. Es solo un espejo del mismo proyecto, no una fuente distinta.
03 · ¿Por qué usar una API self-hosted en vez de la oficial?
- Cero fees por conversación. La API oficial de WhatsApp Business cobra por conversación; OpenWA no cobra nada.
- Control total. Los datos y las sesiones viven en tu servidor, no en un tercero.
- Deploy en minutos. Un
docker compose up -dy ya tenés la API corriendo. - Multi-sesión. Corrés varios números en una sola instancia (ventas, soporte, personal).
Sobre esta base podés montar desde un bot de atención hasta un CRM que califica leads por WhatsApp, sin pagar por cada conversación.
Pagás por cada conversación, esperás aprobaciones y tus datos pasan por un tercero. El costo escala con el volumen.
Levantás el contenedor, definís tu API key y automatizás sin pagar por mensaje. El costo es fijo: tu servidor.
04 · ¿Cuánto cuesta OpenWA gratis frente a una API comercial?
La comparación de precio no es una estimación nuestra: la publica la propia home oficial del proyecto, open-wa.org, en una tabla llamada "Why developers choose OpenWA".
| OpenWA | Proveedores comerciales típicos | |
|---|---|---|
| Precio | Gratis para siempre (Free Forever) | Desde USD 30+/mes hasta USD 50+/mes |
| Fee por conversación | No cobra | Cobra por conversación o por mensaje |
| Dónde corre | En tu propio servidor | En la infraestructura del proveedor |
| Costo real para vos | Solo el servidor donde lo despliegues | Suscripción mensual + fees de uso |
Con OpenWA tu costo es fijo y lo controlás vos: un VPS chico alcanza para arrancar. Con un proveedor comercial, el costo escala con el volumen de mensajes que mandes.
05 · ¿Cómo instalo OpenWA en 5 minutos?
Cloná, configurá el API key y levantá con Docker
El camino corto es Docker. No necesitás compilar nada: cloná el repo, definí tu clave y arrancá.
Camino 1 · Servidor con Docker (recomendado)
Pegá esto en la terminal de tu VPS o máquina:
Definí tu X-API-Key en el archivo de entorno y levantá el stack:
Para quien ya tiene un VPS y usó Docker alguna vez. Un servidor chico alcanza para empezar.
Garantía: el servicio queda escuchando en el puerto 2785 y el Swagger interactivo vive en localhost:2785/api/docs, donde probás cada endpoint sin escribir código.
06 · ¿Cuáles son los endpoints principales?
Todos los requests llevan el header X-API-Key con la clave que definiste. Estos son los cuatro que necesitás para arrancar:
| Comando | Qué hace | Cuándo usarlo |
|---|---|---|
POST /api/sessions | Crea una sesión nueva (un número) | Al dar de alta cada cuenta de WhatsApp |
POST /api/sessions/{sessionId}/start | Arranca la sesión | Después de crearla, para generar el QR |
GET /api/sessions/{sessionId}/qr | Devuelve el QR para vincular | Una vez, al conectar el número por primera vez |
POST /api/sessions/{sessionId}/messages/send-text | Manda un mensaje de texto | Cada vez que tu app o bot responde |
07 · ¿Cómo mando mi primer mensaje?
Creá la sesión, escaneá el QR y dispará el primer send-text
Con el servicio corriendo, el flujo son tres pasos. Primero creás y arrancás la sesión:
Pedís el QR y lo escaneás desde WhatsApp (Dispositivos vinculados):
Y mandás el primer mensaje:
Para quien quiere ver el sistema andando antes de escribir la integración completa.
08 · ¿Qué backends y motor puedo elegir?
OpenWA es configurable por variables de entorno. No estás atado a una sola base ni a un solo motor:
- Base de datos: SQLite por defecto (cero setup, ideal para probar) o PostgreSQL para producción.
- Motor de WhatsApp: whatsapp-web.js por defecto, o Baileys, seleccionable con la variable
ENGINE_TYPE. - Storage: filesystem local (
data/sessions,data/media), así las sesiones sobreviven a un reinicio.
Garantía: cambiás de SQLite a PostgreSQL sin tocar el código de tu app, solo ajustando la configuración.
No hace falta escribir el cliente HTTP a mano: la home oficial de OpenWA lista integraciones ya armadas (nodo para n8n, adaptador para ioBroker) y SDKs oficiales en JavaScript/TypeScript, Python y PHP.
09 · Antes de conectar un número real: riesgo de baneo y safe-sending guidelines
OpenWA no es la API oficial de Meta, así que el riesgo de que WhatsApp banee el número existe si lo usás mal. El repo de OpenWA lo dice explícito, con una sección de compliance dedicada, antes de conectar un número.
Las guías de envío seguro que recomienda el proyecto:
- Usá un número dedicado, no tu WhatsApp personal ni el de un cliente sin avisar.
- Empezá con volumen bajo y subí el ritmo de a poco (warm-up), en vez de mandar cientos de mensajes el primer día.
- No mandes el mismo texto masivo a contactos que no te escribieron primero: eso es lo que más gatilla el filtro antispam de WhatsApp.
- Elegí el motor según el riesgo: si tu prioridad es minimizar la chance de baneo, evaluá las diferencias de comportamiento entre
whatsapp-web.jsy Baileys antes de escalar volumen.
Nuestro criterio con clientes es simple: para prototipar un flujo o validar un caso de uso, OpenWA es la opción correcta. Para producción con volumen serio, sumá un plan de respaldo explícito (número alterno, límites de envío por hora) antes de depender de un único número. Sostener un canal de WhatsApp automatizado sin dejar mensajes sin responder es justo lo que operamos en los agentes de IA para clientes reales, con infraestructura propia y no necesariamente OpenWA.
10 · ¿Cómo aseguro el despliegue de OpenWA en producción?
Si vas a correr OpenWA con datos reales, el repo documenta una arquitectura de seguridad específica para producción, más allá del docker compose up -d inicial:
- Docker Socket Proxy: en vez de exponer el socket de Docker directo al contenedor de la API (un riesgo de seguridad conocido), el proyecto recomienda un proxy intermedio que limita qué puede hacer el contenedor sobre Docker.
- Ejecución non-root: el contenedor corre con un usuario sin privilegios de root, así que un problema dentro del contenedor no compromete el host completo.
Estas dos prácticas son parte de la guía de "Production Deployment" del repo: no son obligatorias para probar OpenWA en tu máquina, pero sí antes de conectar un número real con tráfico de un negocio.
11 · MCP Server: conectá un agente de IA a tu sesión de WhatsApp
El repo de OpenWA incluye un MCP Server propio, pensado para agentes de IA. En vez de que tu código llame cada endpoint a mano, el agente usa el MCP Server como una herramienta más: lee conversaciones y manda respuestas por WhatsApp directo desde su propio flujo.
Esto es lo que separa "tener una API de WhatsApp" de "tener un agente que opera WhatsApp por vos". Con el MCP Server activo, podés enchufar un agente que responda mensajes, escale a un humano cuando corresponda y deje cada conversación ordenada en un CRM propio para no perder el seguimiento después del primer mensaje.
12 · ¿OpenWA es lo mismo que openwa.ai?
No, y vale la pena aclararlo porque Google mezcla los dos resultados. El proyecto que cubre esta guía es github.com/rmyndharis/OpenWA, con su home en open-wa.org: un gateway HTTP self-hosted, gratis y MIT, que corre en tu propio servidor.
openwa.ai es un producto comercial distinto: se presenta textualmente como "an AI-powered chatbot", con planes de pago Basic (5.99€/mes), Premium (9.99€/mes) y Unlimited (14.99€/mes), más un plan "Plus" (4.99€/mes) con una estructura de precios diferente. No menciona self-hosting, Docker ni una API REST propia, y su footer trae el copyright "OpenWA 2023", una señal de que el contenido no se actualiza hace tiempo.
Si tu objetivo es montar tu propia API sin pagar por mensaje, el que necesitás es el proyecto self-hosted de esta guía, no el chatbot de openwa.ai.
13 · ¿Cuándo NO conviene usar OpenWA?
Toda herramienta tiene su borde. OpenWA no es la respuesta para todo:
Si mandás decenas de miles de mensajes o operás en un rubro regulado, la API oficial de Meta te da respaldo, plantillas aprobadas y menos riesgo de baneo.
Para validar una idea, automatizar turnos, correr bots personales o proyectos donde no querés pagar por mensaje, OpenWA es imbatible en costo y velocidad.
Al ser una librería no oficial, existe el riesgo de que Meta cambie el protocolo o de baneo si abusás del envío. Usá un número dedicado y volumen con criterio.
14 · ¿Qué conviene recordar de OpenWA?
- Es una API de WhatsApp open source (MIT), self-hosted, gratis y sin fees por mensaje.
- Se levanta con
docker compose up -den el puerto2785, con Swagger en/api/docs. - Cuatro endpoints te alcanzan para empezar: crear sesión, start, QR y send-text, todos con
X-API-Key. - Es multi-sesión y elegís base (SQLite/PostgreSQL) y motor (whatsapp-web.js/Baileys).
- Antes de conectar un número real: usá un número dedicado, empezá con volumen bajo y seguí las guías de envío seguro del repo para minimizar el riesgo de baneo.
- En producción, sumá Docker Socket Proxy y ejecución non-root, y usá el MCP Server si vas a operarla desde un agente de IA.
- No es lo mismo que openwa.ai: ese es un chatbot pago sin relación con este proyecto.
- Para monetizarla, no vendas "una API": vendé el resultado (turnos confirmados, leads respondidos solos).
El repo completo está en github.com/rmyndharis/OpenWA y la documentación en docs.open-wa.org. Si querés armar el bot arriba de esto, seguí con cómo armar un bot de WhatsApp con Claude.
Esta guía vive en claura-ai.com/resources/api-whatsapp-gratis-open-source-openwa y la actualizamos cada vez que el proyecto suma piezas nuevas, como el MCP Server o los ajustes de seguridad para producción que viste más arriba.
Aplícalo a tu caso
Pídeselo a tu agente
Copia este prompt y pégalo en Claude o ChatGPT. Te pregunta lo que necesita saber de tu caso y arma el plan con los pasos de esta guía.
Quiero aplicar a mi caso la guía "OpenWA: qué es y cómo montar tu API de WhatsApp gratis" de Claura.
Guía: https://claura-ai.com/resources/api-whatsapp-gratis-open-source-openwa
Mi caso: a qué me dedico, qué herramientas uso y qué quiero lograr
La guía cubre:
- ¿Qué es OpenWA?
- ¿Qué es el repo de OpenWA en GitHub y quién lo mantiene?
- ¿Por qué usar una API self-hosted en vez de la oficial?
- ¿Cuánto cuesta OpenWA gratis frente a una API comercial?
- ¿Cómo instalo OpenWA en 5 minutos?
- ¿Cuáles son los endpoints principales?
- ¿Cómo mando mi primer mensaje?
- ¿Qué backends y motor puedo elegir?
Lee la guía (si no puedes abrir el link, trabaja con los temas de arriba). Si te falta información sobre mi caso, hazme hasta 3 preguntas antes de empezar. Después arma un plan para aplicar la guía paso a paso a mi caso y dime qué puedo hacer hoy en menos de una hora.¿Prefieres que lo armemos nosotros? Agenda una llamada
¿Quieres el stack de IA correcto operando en tu negocio?
Sin demos infinitas. Sin contratar consultor. Sin elegir mal.
Agendar llamadaMarcas que confiaron en Claura
- Bissu Abogados
- Isha Judd
- Luxom Developments
- RE/MAX Patagon
- Bitget Wallet
- SpacePal
- Margaret Bissu
- Soy Andina
Preguntas frecuentes sobre API de WhatsApp open source
OpenWA es una API de WhatsApp open source, self-hosted y con licencia MIT: un gateway HTTP que corre en tu propio servidor y te deja controlar WhatsApp por código, sin pasar por un proveedor pago. Sirve para mandar mensajes y archivos, recibir eventos en tiempo real, armar bots de atención, automatizar flujos y correr varias cuentas a la vez. La diferencia con la API oficial de WhatsApp Business es que acá no pagás por conversación ni dependés de un intermediario: levantás el contenedor con Docker y tenés la documentación completa y el Swagger en localhost:2785/api/docs. Además trae un MCP Server propio, así un agente de IA opera la sesión de WhatsApp directo, sin que llames cada endpoint a mano. Si tu idea es un bot de atención, mirá también cómo armar un bot de WhatsApp con Claude.
Sí: el código de OpenWA es MIT, o sea gratis y de uso libre, incluso comercial. Lo único que pagás es el servidor donde lo corras (un VPS chico alcanza) y, si querés, PostgreSQL en vez del SQLite que trae por defecto. No hay fee por mensaje ni por sesión, que es justo lo que cobra la API oficial de WhatsApp Business por conversación. La contra honesta: al ser una librería no oficial, el riesgo de baneo del número existe si mandás spam, así que se usa con criterio. Para casos serios conviene un número dedicado y volumen moderado, con las guías de envío seguro que sumamos más abajo en esta guía.
El camino corto es con Docker. Cloná el repo de OpenWA, configurás tu X-API-Key en el archivo de entorno y levantás todo con docker compose up -d. El servicio queda escuchando en el puerto 2785 y el Swagger interactivo vive en localhost:2785/api/docs. Desde ahí creás una sesión con POST /api/sessions, la arrancás con POST /api/sessions/{sessionId}/start y escaneás el QR que devuelve GET /api/sessions/{sessionId}/qr con tu WhatsApp. Si preferís un motor distinto, OpenWA soporta whatsapp-web.js (default) o Baileys vía la variable ENGINE_TYPE. No hace falta compilar nada ni instalar dependencias a mano: Docker levanta la API, la base y el motor en un solo comando. Los pasos completos están más abajo en esta guía y en la documentación oficial.
La API oficial de WhatsApp Business es de Meta: aprobada, estable, con plantillas y verificación, pero cobra por conversación y te obliga a un proceso de alta con un BSP o la Cloud API. OpenWA es no oficial y self-hosted: gratis, sin fees, control total y deploy en minutos, a cambio de asumir el mantenimiento y el riesgo de que Meta cambie algo del protocolo. Regla práctica: para volúmenes grandes, marca regulada o soporte formal, la oficial; para prototipos, automatizaciones internas, bots personales o proyectos donde no querés pagar por mensaje, OpenWA. Muchos arrancan con OpenWA para validar la idea y migran a la oficial cuando escalan. Un ejemplo de flujo real es un CRM que califica leads por WhatsApp.
Sí, ese es uno de sus fuertes: OpenWA es multi-sesión, así que corrés varios números en una sola instancia. Cada número es una "sesión" que creás con POST /api/sessions, arrancás con /start y autenticás con su propio QR. Cada sesión guarda su estado en disco (data/sessions) y podés apuntar la base a SQLite para pruebas o a PostgreSQL para producción. Esto es ideal para agencias o para separar, por ejemplo, ventas de soporte en el mismo servidor. Cada request lleva el header X-API-Key, así que podés proteger y rotar el acceso por integración. Si vas a manejar muchos números, dejá el motor en whatsapp-web.js y monitoreá el uso de RAM: cada sesión levanta su propia instancia.
Al ser gratis y self-hosted, el margen queda del lado tuyo. Los caminos más comunes: cobrar por armar e instalar bots de atención a comercios, vender automatizaciones (recordatorios de turnos, confirmaciones, cobranzas), o montar un micro-SaaS que use OpenWA por debajo y le factures al cliente por número o por volumen. Como no pagás fee por mensaje, tu costo real es el servidor, y todo lo demás es servicio. La clave es empaquetar el valor: nadie paga por "una API", pagan por "los turnos confirmados solos" o "los leads respondidos en 10 segundos". Para diseñar ese flujo de captura y respuesta automática mirá cómo armar un bot de WhatsApp con Claude y la documentación de OpenWA para las piezas técnicas.
Sí, y conviene tenerlo claro antes de conectar un número real. Al ser una librería no oficial, el propio repo de OpenWA publica una sección de compliance con recomendaciones antes de conectar un número y "safe-sending guidelines" para no gatillar el comportamiento antispam de WhatsApp. La regla práctica: usá un número dedicado (no el tuyo personal), arrancá con volumen bajo, subí el ritmo de envío de forma gradual y evitá mandar el mismo texto masivo a contactos que no te escribieron primero. Nuestro criterio con clientes es simple: OpenWA sirve para prototipar un flujo o validar un caso de uso; para producción con volumen serio, sumá un plan de respaldo (número alterno, límites de envío por hora). Ampliamos estas guías de envío seguro más abajo en esta guía. Así sostenemos canales de WhatsApp sin tickets sin responder en los agentes de IA que operamos para clientes.
Fuentes e inspiración
Mira los posts originales donde desarrollamos estas ideas en redes.
