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

Evolution API es un gateway self-hosted que permite conectar WhatsApp a tu stack sin pagar Cloud API oficial. En LATAM 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 el riesgo baja, pero no desaparece.
• 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 LATAM

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. Contenedor Evolution API (Node.js + TypeScript) — expone endpoints REST y maneja las sesiones de WhatsApp Web vía Baileys.
2. PostgreSQL — guarda instancias, contactos, mensajes, chats.
3. Redis (opcional pero recomendado) — caché de sesiones y cola de mensajes.
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. evolution-api — imagen atendai/evolution-api:v2.2.3 (o la última estable a 2026).
2. postgres — imagen postgres:16-alpine, volumen persistente.
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:

{
  "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. Parseás el payload (campos data.key.remoteJid, data.message.conversation, data.pushName).
2. Guardás el mensaje en PostgreSQL para analytics.
3. Clasificás la intención con OpenAI o Claude (nodo HTTP Request con GPT-5 o Claude API).
4. Consultás tu CRM (HubSpot, Tokko, lo que uses) vía API.
5. Mandá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 que más usamos en proyectos con WhatsApp.

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. 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. 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. Lenguaje natural, no templates repetitivos. Variá saludos, personalizá con el nombre, usá emojis moderados.
4. Respetá horarios. Nada de responder 3am a escala. Configurá ventanas 9-21hs AR en n8n.
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. Monitoreo de salud. Evolution expone endpoint /instance/fetchInstances con el estado. Si pasa a close repetidas veces, problema de sesión.

Con ese setup el riesgo baja, pero no desaparece: si el número es crítico para tu operación, ese riesgo es el argumento para pasar a Cloud API.

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 la opción que solemos recomendar, siempre que el riesgo de ban esté asumido.

5 casos de uso donde Evolution API se justifica

1. MVP de chatbot para validar antes de invertir en Cloud API.
2. Agencia de marketing con muchos clientes chicos donde Cloud API es overhead.
3. Atención interna de empresa (equipo de ventas, soporte) donde el número es dedicado.
4. Inmobiliarias y consultorios con 100-500 conversaciones/mes donde el costo Cloud API no paga el esfuerzo de verificación.
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

Evolution API casi nunca es el proyecto en sí: es la pieza que conecta WhatsApp con el resto de tus sistemas (CRM, ERP, tienda online, sistema de pedidos). Por eso trabajamos en tres pasos:

1. Entender la necesidad: una primera conversación, sin compromiso, sobre qué proceso querés resolver y con qué sistemas tiene que hablar.
2. Propuesta: alcance, entregables, dependencias y criterios de aceptación por escrito. Ahí se define si conviene Evolution API o Cloud API, y qué mantenimiento, hosting o servicios de terceros quedan incluidos.
3. Desarrollo y puesta en marcha: lo construimos, lo probamos con los responsables de tu equipo y acordamos la puesta en marcha y el mantenimiento.

Los plazos se fijan en cada propuesta, separando nuestro trabajo de lo que depende de tu equipo o de terceros, como la verificación de Meta si el proyecto va por Cloud API.

Links internos relacionados

• Guía pillar: automatización de WhatsApp en LATAM.
• Cluster relacionado: cómo medir el retorno de un chatbot de WhatsApp.
• Servicios: automatización e IA, incluidos asistentes de WhatsApp.
• Contacto técnico directo: WhatsApp +54 9 11 5499-7296.

CTA

Si querés usar Evolution API conectado a tus sistemas sin pelearte con Docker, Baileys y el warm-up manual, contanos qué proceso querés resolver. Escribinos al +54 9 11 5499-7296 o entrá a striqtech.com: después de esa primera conversación te proponemos el siguiente paso, con alcance, etapas y plazos.