Evolution API: WhatsApp self-hosted para startups argentinas (guía 2026)

Evolution API es un gateway self-hosted que permite conectar WhatsApp a tu stack sin pagar Cloud API oficial. En Argentina 2026 es la opción más usada para MVP de chatbots, con costo de infra de USD 10-20/mes y deploy en 30 minutos sobre Hostinger VPS con Docker Compose.

TL;DR

• Evolution API = wrapper open-source sobre Baileys que expone WhatsApp Web como REST API + webhooks.
• Se deploya en Docker Compose sobre cualquier VPS (Hostinger KVM 2 alcanza, USD 7-15/mes).
• Integra nativo con n8n, Chatwoot, Typebot y cualquier stack que consuma webhooks.
• Riesgo real: ban de número. Con warm-up correcto, la tasa de ban baja al 2%.
• Para producción crítica o volúmenes >1000 conversaciones/mes, migrá a Cloud API oficial de Meta.

Qué es Evolution API y por qué se usa tanto en Argentina

Evolution API es un proyecto open-source (licencia Apache 2.0) que expone el protocolo **Baileys** — una implementación no oficial del cliente WhatsApp Web — como una API REST con webhooks. En la práctica, significa que **podés mandar y recibir mensajes de WhatsApp desde cualquier sistema sin contrato con Meta**.

La razón por la que domina en AR y LatAm es simple: **Cloud API oficial cobra por conversación en USD** y exige número verificado en Business Manager. Para una pyme que recién arranca con un chatbot, eso es fricción y costo. Evolution API baja la barrera a una VPS de USD 10/mes y un número de teléfono cualquiera.

Arquitectura mínima

1. 1**Contenedor Evolution API** (Node.js + TypeScript) — expone endpoints REST y maneja las sesiones de WhatsApp Web vía Baileys.
2. 2**PostgreSQL** — guarda instancias, contactos, mensajes, chats.
3. 3**Redis** (opcional pero recomendado) — caché de sesiones y cola de mensajes.
4. 4**Webhook externo** — Evolution te manda cada mensaje entrante a la URL que definas (típicamente n8n o tu backend).

Cuando un cliente le manda un WhatsApp a tu número, el flujo es: WhatsApp Web → Evolution API → webhook POST → tu procesamiento (n8n, Python, Node) → respuesta vía Evolution → WhatsApp del cliente.

Evolution API vs Cloud API oficial de Meta

Diferencias clave que tenés que tener claras antes de decidir.

Evolution API (self-hosted, no oficial)

• **Costo**: solo VPS, USD 10-20/mes.
• **Volumen**: ilimitado técnicamente, limitado por el riesgo de ban.
• **Número**: cualquier celular, no requiere verificación en Business Manager.
• **Templates**: no aplica, mandás cualquier texto.
• **Ventajas**: rápido, barato, flexible, multi-instancia.
• **Desventajas**: viola ToS de WhatsApp, riesgo de ban, sin SLA oficial.

Cloud API oficial (WhatsApp Business Platform)

• **Costo**: USD 0,005-0,08 por conversación según categoría (utility, marketing, authentication, service).
• **Volumen**: ilimitado y sin riesgo de ban.
• **Número**: obligatorio verificar en Business Manager, display name aprobado.
• **Templates**: obligatorios para iniciar conversaciones fuera de la ventana de 24h.
• **Ventajas**: oficial, estable, botones interactivos nativos, compliance enterprise.
• **Desventajas**: burocracia de aprobación, costo variable, lenta iteración.

**En StriqTech recomendamos Evolution API para MVP y Cloud API para producción crítica**. Es la misma lógica que cualquier startup usa: validar rápido y barato, después escalar sobre infraestructura oficial.

Setup paso a paso de Evolution API en Hostinger con Docker Compose

Esta es la receta completa que usamos para desplegar Evolution API en clientes StriqTech. Asume Hostinger VPS con Easypanel o Docker Swarm instalado.

Paso 1: docker-compose.yml base

Creá un archivo `docker-compose.yml` con estos servicios:

1. 1`evolution-api` — imagen `atendai/evolution-api:v2.2.3` (o la última estable a 2026).
2. 2`postgres` — imagen `postgres:16-alpine`, volumen persistente.
3. 3`redis` — imagen `redis:7-alpine`, volumen persistente.

Exponé el puerto 8080 detrás de un reverse proxy (Traefik o nginx) con certificado Let's Encrypt.

Paso 2: variables de entorno críticas

Las que no podés omitir:

• `AUTHENTICATION_API_KEY` — clave maestra para llamar a la API (generá una con `openssl rand -hex 32`).
• `DATABASE_PROVIDER=postgresql` y `DATABASE_CONNECTION_URI=postgresql://user:pass@postgres:5432/evolution`.
• `CACHE_REDIS_ENABLED=true` + `CACHE_REDIS_URI=redis://redis:6379`.
• `WEBHOOK_GLOBAL_URL` — URL de tu n8n (http://n8n:5678/webhook/evolution).
• `WEBHOOK_GLOBAL_ENABLED=true`.
• `CONFIG_SESSION_PHONE_CLIENT=EvolutionAPI` y `CONFIG_SESSION_PHONE_NAME=Chrome` (reduce flags de detección).

Paso 3: crear la primera instancia

Con la API levantada, POST a `/instance/create` con body JSON:

```json

{

"instanceName": "ventas",

"qrcode": true,

"integration": "WHATSAPP-BAILEYS"

}

```

Respuesta incluye el QR en base64. Abrís WhatsApp del celular → Dispositivos vinculados → escaneás.

Paso 4: verificar el webhook

Mandate un mensaje de prueba al número. En los logs de Evolution vas a ver el POST al webhook global. Si usás n8n, configurá un Webhook node con path `/evolution` y ya tenés el mensaje como JSON parseable.

Paso 5: reverse proxy y dominio

Apuntá un subdominio (ej. `wa.tudominio.com`) al VPS, configurá Traefik o nginx para que haga proxy al puerto 8080 con HTTPS. **Nunca expongas Evolution API por HTTP plano**: los tokens viajan en headers.

Integración con n8n y Chatwoot

El stack real de producción que implementamos en StriqTech es **Evolution API + n8n + Chatwoot + PostgreSQL**. Cada pieza hace algo concreto.

Evolution API + n8n

En n8n creás un Webhook node que recibe cada mensaje de Evolution. Ahí armás el flujo:

1. 1Parseás el payload (campos `data.key.remoteJid`, `data.message.conversation`, `data.pushName`).
2. 2Guardás el mensaje en PostgreSQL para analytics.
3. 3Clasificás la intención con OpenAI o Claude (nodo HTTP Request con GPT-5 o Claude API).
4. 4Consultás tu CRM (HubSpot, Tokko, lo que uses) vía API.
5. 5Mandás la respuesta vía HTTP Request a `POST /message/sendText/{instance}` de Evolution.

Importante: **nunca uses `fetch()` dentro de Code nodes de n8n**, usá siempre HTTP Request nodes. Es convención interna StriqTech y evita problemas de timeout.

Evolution API + Chatwoot

Chatwoot es el dashboard de atención multiagente. La integración es nativa desde Evolution v2: configurás en la instancia los campos `chatwoot_account_id`, `chatwoot_token`, `chatwoot_url`. Cada conversación de WhatsApp aparece como inbox en Chatwoot, agentes humanos responden desde ahí, y el mensaje sale por Evolution.

El combo n8n (para lógica automática) + Chatwoot (para humanos cuando el bot no sabe) es el patrón más usado en los 40+ proyectos WhatsApp que llevamos.

Riesgos de ban y cómo mitigarlos

Este es el punto que más te va a importar si vas a producción. **Meta banea números que detecta automatizados**. La detección usa señales como: volumen de mensajes salientes, patrones horarios, contenido repetitivo, ratio saliente/entrante, reportes de spam.

Mitigaciones probadas

1. 1**Warm-up progresivo**. Día 1: 50 mensajes salientes. Día 7: 200. Día 14: 500. Día 30: lo que necesites. Nunca arranques con volumen alto.
2. 2**Conversaciones reales, no broadcasts**. Si sólo respondés a quien te escribe primero, el riesgo baja al mínimo. El broadcast a contactos sin opt-in es el que dispara bans.
3. 3**Lenguaje natural, no templates repetitivos**. Variá saludos, personalizá con el nombre, usá emojis moderados.
4. 4**Respetá horarios**. Nada de responder 3am a escala. Configurá ventanas 9-21hs AR en n8n.
5. 5**Número dedicado**. Nunca uses el número personal del dueño o el principal de la empresa. Un SIM aparte USD 5.
6. 6**Monitoreo de salud**. Evolution expone endpoint `/instance/fetchInstances` con el estado. Si pasa a `close` repetidas veces, problema de sesión.

Con ese setup, **en StriqTech la tasa de ban en 2025-2026 se mantuvo bajo 2%** sobre 60+ números activos.

Costos reales en 2026: Evolution API vs Cloud API

Números concretos para que compares.

Escenario A: pyme con 300 conversaciones/mes

• Evolution API en Hostinger KVM 2: USD 7,99/mes + 1 instancia activa. Total: **USD 8/mes**.
• Cloud API oficial: 300 conversaciones service category a USD 0,0147 c/u (tarifa AR 2026): **USD 4,4/mes** + costo desarrollo integración.

A bajo volumen, Cloud API es más barato en infra pero cobra por conversación y exige burocracia.

Escenario B: e-commerce con 5000 conversaciones/mes

• Evolution API en Hostinger KVM 4: USD 15/mes. Total: **USD 15/mes**.
• Cloud API oficial: 5000 conversaciones mix service+utility a promedio USD 0,02: **USD 100/mes**.

A volumen alto, Evolution API es **6-7x más barato** pero asumís el riesgo de ban.

Escenario C: agencia con 10 clientes y 10 instancias

• Evolution API en Hostinger KVM 4: USD 15/mes, 10 instancias en el mismo contenedor.
• Cloud API: 10 números verificados × costo por cliente, burocracia x10.

Para agencias y operaciones multi-cliente, Evolution API es lo que recomendamos en el modelo B de 72h de StriqTech.

5 casos de uso donde Evolution API se justifica

1. 1**MVP de chatbot** para validar antes de invertir en Cloud API.
2. 2**Agencia de marketing** con muchos clientes chicos donde Cloud API es overhead.
3. 3**Atención interna** de empresa (equipo de ventas, soporte) donde el número es dedicado.
4. 4**Inmobiliarias y consultorios** con 100-500 conversaciones/mes donde el costo Cloud API no paga el esfuerzo de verificación.
5. 5**Automatización de cobranza** con disparos a contactos que ya te deben (relación comercial establecida, bajo riesgo de reporte spam).

Si tu caso no encaja ninguno de esos, empezá directo con Cloud API.

Cuándo migrar a Cloud API oficial

Señales claras de que tu Evolution API ya cumplió su ciclo:

• Superás 1000 conversaciones/mes sostenidas.
• Un cliente enterprise te exige compliance y SLA oficial.
• Ya tuviste 1 ban y no querés volver a pasarlo.
• Necesitás botones interactivos, list messages, payments nativos de Meta.
• Tu negocio depende 100% de WhatsApp (si se cae, cae la empresa).

**La migración no es trivial**: tenés que verificar el número en Business Manager, aprobar display name, migrar templates, reescribir la capa de envío en tu backend. Presupuestá 1-2 semanas de trabajo técnico.

Cómo lo implementamos en StriqTech

En StriqTech desplegamos Evolution API bajo dos modelos:

• **Modelo B (72h)**: stack standard — Evolution API + n8n + Chatwoot + PostgreSQL en Hostinger VPS, 1-3 instancias, webhook a n8n con flows pre-armados. Desde USD 499 setup + USD 199/mes.
• **Modelo A (a medida)**: integración con CRM específico (HubSpot, Tokko, Pipedrive), lógica de negocio compleja, multi-instancia con enrutamiento por cliente. Desde USD 1500 setup + USD 299/mes.

Ambos incluyen warm-up del número, monitoreo de health, backups automáticos y plan de migración a Cloud API cuando el volumen lo justifique.

Links internos relacionados

• Guía pillar: automatización de WhatsApp en Argentina.
• Cluster relacionado: chatbot WhatsApp con ROI en 30 días.
• Servicios: [chatbots WhatsApp](https://striqtech.com/#servicios).
• Contacto técnico directo: [WhatsApp +54 9 11 5499-7296](https://wa.me/5491154997296).

CTA

Si querés desplegar Evolution API sin pelearte con Docker, Baileys y warm-up manual, **StriqTech lo deja productivo en 72h** con Chatwoot, n8n y backups incluidos. Escribinos al [+54 9 11 5499-7296](https://wa.me/5491154997296) o entrá a [striqtech.com](https://striqtech.com) para pedir presupuesto.