Evolution API: WhatsApp self-hosted per startup argentine (guida 2026)

Evolution API è un gateway self-hosted che permette di collegare WhatsApp al tuo stack senza pagare Cloud API ufficiale. In LATAM 2026 è l'opzione più usata per MVP di chatbot, con costo di infra di USD 10-20/mese e deploy in 30 minuti su Hostinger VPS con Docker Compose.

TL;DR

• Evolution API = wrapper open-source su Baileys che espone WhatsApp Web come REST API + webhook.
• Si deploya in Docker Compose su qualsiasi VPS (Hostinger KVM 2 basta, USD 7-15/mese).
• Integra in modo nativo con n8n, Chatwoot, Typebot e qualsiasi stack che consumi webhook.
• Rischio reale: ban del numero. Con warm-up corretto, il tasso di ban scende al 2%.
• Per produzione critica o volumi >1000 conversazioni/mese, migra a Cloud API ufficiale di Meta.

Cos'è Evolution API e perché si usa tanto in LATAM

Evolution API è un progetto open-source (licenza Apache 2.0) che espone il protocollo Baileys — un'implementazione non ufficiale del client WhatsApp Web — come una API REST con webhook. In pratica, significa che puoi inviare e ricevere messaggi WhatsApp da qualsiasi sistema senza contratto con Meta.

Il motivo per cui domina in AR e LatAm è semplice: Cloud API ufficiale addebita per conversazione in USD ed esige numero verificato in Business Manager. Per una PMI che inizia con un chatbot, questo è attrito e costo. Evolution API abbassa la barriera a un VPS di USD 10/mese e un numero di telefono qualsiasi.

Architettura minima

1. Container Evolution API (Node.js + TypeScript) — espone endpoint REST e gestisce le sessioni di WhatsApp Web via Baileys.
2. PostgreSQL — memorizza istanze, contatti, messaggi, chat.
3. Redis (opzionale ma raccomandato) — cache delle sessioni e coda dei messaggi.
4. Webhook esterno — Evolution invia ogni messaggio entrante all'URL che definisci (tipicamente n8n o il tuo backend).

Quando un cliente invia un WhatsApp al tuo numero, il flusso è: WhatsApp Web → Evolution API → webhook POST → la tua elaborazione (n8n, Python, Node) → risposta via Evolution → WhatsApp del cliente.

Evolution API vs Cloud API ufficiale di Meta

Differenze chiave che devi avere chiare prima di decidere.

Evolution API (self-hosted, non ufficiale)

• Costo: solo VPS, USD 10-20/mese.
• Volume: tecnicamente illimitato, limitato dal rischio di ban.
• Numero: qualsiasi cellulare, non richiede verifica in Business Manager.
• Template: non si applicano, puoi inviare qualsiasi testo.
• Vantaggi: rapido, economico, flessibile, multi-istanza.
• Svantaggi: viola i ToS di WhatsApp, rischio ban, senza SLA ufficiale.

Cloud API ufficiale (WhatsApp Business Platform)

• Costo: USD 0,005-0,08 per conversazione in base alla categoria (utility, marketing, authentication, service).
• Volume: illimitato e senza rischio di ban.
• Numero: obbligatorio verificare in Business Manager, display name approvato.
• Template: obbligatori per iniziare conversazioni fuori dalla finestra di 24h.
• Vantaggi: ufficiale, stabile, pulsanti interattivi nativi, compliance enterprise.
• Svantaggi: burocrazia di approvazione, costo variabile, iterazione lenta.

In StriqTech raccomandiamo Evolution API per MVP e Cloud API per produzione critica. È la stessa logica che usa qualsiasi startup: validare rapido ed economico, dopodiché scalare su infrastruttura ufficiale.

Setup passo passo di Evolution API su Hostinger con Docker Compose

Questa è la ricetta completa che usiamo per fare deploy di Evolution API nei clienti StriqTech. Presuppone Hostinger VPS con Easypanel o Docker Swarm installato.

Passo 1: docker-compose.yml base

Crea un file docker-compose.yml con questi servizi:

1. evolution-api — immagine atendai/evolution-api:v2.2.3 (o l'ultima stabile al 2026).
2. postgres — immagine postgres:16-alpine, volume persistente.
3. redis — immagine redis:7-alpine, volume persistente.

Esponi la porta 8080 dietro un reverse proxy (Traefik o nginx) con certificato Let's Encrypt.

Passo 2: variabili d'ambiente critiche

Quelle che non puoi omettere:

• AUTHENTICATION_API_KEY — chiave master per chiamare l'API (generane una con openssl rand -hex 32).
• DATABASE_PROVIDER=postgresql e DATABASE_CONNECTION_URI=postgresql://user:pass@postgres:5432/evolution.
• CACHE_REDIS_ENABLED=true + CACHE_REDIS_URI=redis://redis:6379.
• WEBHOOK_GLOBAL_URL — URL del tuo n8n (http://n8n:5678/webhook/evolution).
• WEBHOOK_GLOBAL_ENABLED=true.
• CONFIG_SESSION_PHONE_CLIENT=EvolutionAPI e CONFIG_SESSION_PHONE_NAME=Chrome (riduce i flag di rilevamento).

Passo 3: creare la prima istanza

Con l'API attiva, POST a /instance/create con body JSON:

{
  "instanceName": "ventas",
  "qrcode": true,
  "integration": "WHATSAPP-BAILEYS"
}

La risposta include il QR in base64. Apri WhatsApp dal cellulare → Dispositivi collegati → scansiona.

Passo 4: verificare il webhook

Inviati un messaggio di prova al numero. Nei log di Evolution vedrai il POST al webhook globale. Se usi n8n, configura un Webhook node con path /evolution e hai già il messaggio come JSON parsabile.

Passo 5: reverse proxy e dominio

Punta un sottodominio (es. wa.tuodominio.com) al VPS, configura Traefik o nginx in modo che faccia proxy alla porta 8080 con HTTPS. Non esporre mai Evolution API su HTTP in chiaro: i token viaggiano negli header.

Integrazione con n8n e Chatwoot

Lo stack reale di produzione che implementiamo in StriqTech è Evolution API + n8n + Chatwoot + PostgreSQL. Ogni pezzo fa qualcosa di concreto.

Evolution API + n8n

In n8n crei un Webhook node che riceve ogni messaggio da Evolution. Lì costruisci il flusso:

1. Parsi il payload (campi data.key.remoteJid, data.message.conversation, data.pushName).
2. Salvi il messaggio in PostgreSQL per analytics.
3. Classifichi l'intenzione con OpenAI o Claude (nodo HTTP Request con GPT-5 o Claude API).
4. Consulti il tuo CRM (HubSpot, Tokko, quello che usi) via API.
5. Invii la risposta via HTTP Request a POST /message/sendText/{instance} di Evolution.

Importante: non usare mai fetch() dentro i Code node di n8n, usa sempre HTTP Request node. È convenzione interna StriqTech ed evita problemi di timeout.

Evolution API + Chatwoot

Chatwoot è il dashboard di assistenza multiagente. L'integrazione è nativa da Evolution v2: configuri nell'istanza i campi chatwoot_account_id, chatwoot_token, chatwoot_url. Ogni conversazione di WhatsApp appare come inbox in Chatwoot, gli agenti umani rispondono da lì e il messaggio esce tramite Evolution.

Il combo n8n (per logica automatica) + Chatwoot (per gli umani quando il bot non sa) è il pattern più usato nei 40+ progetti WhatsApp che gestiamo.

Rischi di ban e come mitigarli

Questo è il punto che più ti interesserà se vai in produzione. Meta banna i numeri che rileva come automatizzati. Il rilevamento usa segnali come: volume di messaggi in uscita, pattern orari, contenuto ripetitivo, ratio uscita/entrata, segnalazioni di spam.

Mitigazioni provate

1. Warm-up progressivo. Giorno 1: 50 messaggi in uscita. Giorno 7: 200. Giorno 14: 500. Giorno 30: ciò che ti serve. Non iniziare mai con volume alto.
2. Conversazioni reali, non broadcast. Se rispondi solo a chi ti scrive per primo, il rischio scende al minimo. Il broadcast a contatti senza opt-in è ciò che fa scattare i ban.
3. Linguaggio naturale, non template ripetitivi. Varia i saluti, personalizza con il nome, usa emoji con moderazione.
4. Rispetta gli orari. Niente rispondere alle 3 del mattino in massa. Configura finestre 9-21 AR in n8n.
5. Numero dedicato. Non usare mai il numero personale del titolare o quello principale dell'azienda. Una SIM a parte costa USD 5.
6. Monitoraggio dello stato. Evolution espone l'endpoint /instance/fetchInstances con lo stato. Se passa a close ripetutamente, problema di sessione.

Con quel setup, in StriqTech il tasso di ban nel 2025-2026 si è mantenuto sotto il 2% su 60+ numeri attivi.

Costi reali nel 2026: Evolution API vs Cloud API

Numeri concreti per confrontare.

Scenario A: PMI con 300 conversazioni/mese

• Evolution API su Hostinger KVM 2: USD 7,99/mese + 1 istanza attiva. Totale: USD 8/mese.
• Cloud API ufficiale: 300 conversazioni service category a USD 0,0147 cad. (tariffa AR 2026): USD 4,4/mese + costo sviluppo integrazione.

A basso volume, Cloud API è più economico in infra ma addebita per conversazione ed esige burocrazia.

Scenario B: e-commerce con 5000 conversazioni/mese

• Evolution API su Hostinger KVM 4: USD 15/mese. Totale: USD 15/mese.
• Cloud API ufficiale: 5000 conversazioni mix service+utility a media USD 0,02: USD 100/mese.

A volume alto, Evolution API è 6-7x più economico ma ti assumi il rischio di ban.

Scenario C: agenzia con 10 clienti e 10 istanze

• Evolution API su Hostinger KVM 4: USD 15/mese, 10 istanze nello stesso container.
• Cloud API: 10 numeri verificati × costo per cliente, burocrazia x10.

Per agenzie e operazioni multi-cliente, Evolution API è ciò che raccomandiamo nel modello B di 72h di StriqTech.

5 casi d'uso dove Evolution API si giustifica

1. MVP di chatbot per validare prima di investire in Cloud API.
2. Agenzia di marketing con molti clienti piccoli dove Cloud API è overhead.
3. Assistenza interna d'azienda (team vendite, supporto) dove il numero è dedicato.
4. Immobiliari e studi medici con 100-500 conversazioni/mese dove il costo Cloud API non ripaga lo sforzo di verifica.
5. Automazione di recupero crediti con invii a contatti che ti devono già qualcosa (relazione commerciale stabilita, basso rischio di segnalazione spam).

Se il tuo caso non rientra in nessuno di questi, parti direttamente con Cloud API.

Quando migrare a Cloud API ufficiale

Segnali chiari che il tuo Evolution API ha completato il suo ciclo:

• Superi 1000 conversazioni/mese sostenute.
• Un cliente enterprise esige compliance e SLA ufficiale.
• Hai già subito 1 ban e non vuoi ripassarci.
• Ti servono pulsanti interattivi, list messages, pagamenti nativi di Meta.
• Il tuo business dipende al 100% da WhatsApp (se cade, cade l'azienda).

La migrazione non è banale: devi verificare il numero in Business Manager, approvare il display name, migrare i template, riscrivere il layer di invio nel tuo backend. Stima 1-2 settimane di lavoro tecnico.

Come lo implementiamo in StriqTech

In StriqTech facciamo deploy di Evolution API con due modelli:

• Modello B (72h): stack standard — Evolution API + n8n + Chatwoot + PostgreSQL su Hostinger VPS, 1-3 istanze, webhook verso n8n con flow pre-costruiti. Da USD 499 setup + USD 199/mese.
• Modello A (su misura): integrazione con CRM specifico (HubSpot, Tokko, Pipedrive), logica di business complessa, multi-istanza con instradamento per cliente. Da USD 1500 setup + USD 299/mese.

Entrambi includono warm-up del numero, monitoraggio dello stato, backup automatici e piano di migrazione a Cloud API quando il volume lo giustifica.

Link interni correlati

• Guida pillar: automazione di WhatsApp in LATAM.
• Cluster correlato: chatbot WhatsApp con ROI in 30 giorni.
• Servizi: chatbot WhatsApp.
• Contatto tecnico diretto: WhatsApp +54 9 11 5499-7296.

CTA

Se vuoi fare deploy di Evolution API senza combattere con Docker, Baileys e warm-up manuale, StriqTech lo rende produttivo in 72h con Chatwoot, n8n e backup inclusi. Scrivici al +54 9 11 5499-7296 o visita striqtech.com per chiedere un preventivo.