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 rischio scende, ma non sparisce.
- 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
- Container Evolution API (Node.js + TypeScript) — espone endpoint REST e gestisce le sessioni di WhatsApp Web via Baileys.
- PostgreSQL — memorizza istanze, contatti, messaggi, chat.
- Redis (opzionale ma raccomandato) — cache delle sessioni e coda dei messaggi.
- 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:
evolution-api— immagineatendai/evolution-api:v2.2.3(o l'ultima stabile al 2026).postgres— immaginepostgres:16-alpine, volume persistente.redis— immagineredis: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 conopenssl rand -hex 32).DATABASE_PROVIDER=postgresqleDATABASE_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=EvolutionAPIeCONFIG_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:
- Parsi il payload (campi
data.key.remoteJid,data.message.conversation,data.pushName). - Salvi il messaggio in PostgreSQL per analytics.
- Classifichi l'intenzione con OpenAI o Claude (nodo HTTP Request con GPT-5 o Claude API).
- Consulti il tuo CRM (HubSpot, Tokko, quello che usi) via API.
- 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 che usiamo di più nei progetti WhatsApp.
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
- 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.
- 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.
- Linguaggio naturale, non template ripetitivi. Varia i saluti, personalizza con il nome, usa emoji con moderazione.
- Rispetta gli orari. Niente rispondere alle 3 del mattino in massa. Configura finestre 9-21 AR in n8n.
- Numero dedicato. Non usare mai il numero personale del titolare o quello principale dell'azienda. Una SIM a parte costa USD 5.
- Monitoraggio dello stato. Evolution espone l'endpoint
/instance/fetchInstancescon lo stato. Se passa acloseripetutamente, problema di sessione.
Con quel setup il rischio scende, ma non sparisce: se il numero è critico per la tua operatività, quel rischio è l'argomento per passare a Cloud API.
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 è l'opzione che di solito raccomandiamo, purché il rischio di ban sia messo in conto.
5 casi d'uso dove Evolution API si giustifica
- MVP di chatbot per validare prima di investire in Cloud API.
- Agenzia di marketing con molti clienti piccoli dove Cloud API è overhead.
- Assistenza interna d'azienda (team vendite, supporto) dove il numero è dedicato.
- Immobiliari e studi medici con 100-500 conversazioni/mese dove il costo Cloud API non ripaga lo sforzo di verifica.
- 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
Evolution API non è quasi mai il progetto in sé: è il pezzo che collega WhatsApp al resto dei tuoi sistemi (CRM, ERP, negozio online, sistema degli ordini). Per questo lavoriamo in tre passi:
- Capire l'esigenza: una prima conversazione, senza impegno, su quale processo vuoi risolvere e con quali sistemi deve parlare.
- Proposta: ambito, deliverable, dipendenze e criteri di accettazione per iscritto. Lì si decide se conviene Evolution API o Cloud API, e quali servizi di manutenzione, hosting o di terzi sono inclusi.
- Sviluppo e avvio: lo costruiamo, lo testiamo con i responsabili del tuo team e concordiamo l'avvio e la manutenzione.
I tempi si fissano in ogni proposta, separando il nostro lavoro da ciò che dipende dal tuo team o da terzi, come la verifica di Meta se il progetto passa da Cloud API.
Link interni correlati
- Guida pillar: automazione di WhatsApp in LATAM.
- Cluster correlato: come misurare il ritorno di un chatbot WhatsApp.
- Servizi: automazione e IA, inclusi assistenti WhatsApp.
- Contatto tecnico diretto: WhatsApp +54 9 11 5499-7296.
CTA
Se vuoi Evolution API collegato ai tuoi sistemi senza combattere con Docker, Baileys e warm-up manuale, raccontaci quale processo vuoi risolvere. Scrivici al +54 9 11 5499-7296 o visita striqtech.com: dopo quella prima conversazione ti proponiamo il passo successivo, con ambito, fasi e tempi.