Vai al contenuto
StriqTech Logo
Torna al blog
Chatbot & IA14 min di lettura

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

Evolution API è il gateway self-hosted per WhatsApp più usato in AR: Docker, webhook verso n8n e costo VPS USD 5-15/mese. Guida tecnica 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

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)

Cloud API ufficiale (WhatsApp Business Platform)

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:

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 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

  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 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

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

Scenario B: e-commerce con 5000 conversazioni/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

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

  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:

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:

  1. Capire l'esigenza: una prima conversazione, senza impegno, su quale processo vuoi risolvere e con quali sistemi deve parlare.
  2. 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.
  3. 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.

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.

Domande frequenti

È legale usare Evolution API in LATAM?

Tecnicamente non è ufficiale di Meta, usa WhatsApp Web sotto protocollo Baileys. Non c'è sanzione legale in AR, ma viola i Termini di Servizio di WhatsApp. Per operazioni critiche o volumi alti, migra a Cloud API ufficiale.

Mi possono bannare il numero se uso Evolution API?

Sì, è il rischio reale. Meta rileva pattern di automazione. Mitigazione: warm-up progressivo (50 msg giorno 1, scalare), non inviare massivi senza consenso, rispettare gli orari e usare linguaggio naturale. Con un setup corretto il rischio scende, ma non sparisce.

Posso usare il numero della mia azienda con Evolution API?

Puoi ma non è raccomandato per il principale. Usa un numero secondario dedicato. Se il numero è già verificato in Business Manager, non collegarlo a Evolution: perdi la verifica ufficiale.

Quanto costa avere Evolution API in esecuzione?

Un VPS Hostinger KVM 2 basta per 3-5 istanze: USD 7-15/mese. Aggiungi PostgreSQL (incluso) e Redis. Totale infra: USD 10-20/mese vs Cloud API che addebita USD 0,005-0,08 per conversazione a seconda della categoria.

Come faccio il backup delle istanze di Evolution API?

Backup di 3 cose: (1) PostgreSQL dump giornaliero dello schema evolution, (2) cartella delle sessioni baileys (token di WhatsApp Web), (3) variabili d'ambiente. Con Easypanel puoi programmare backup automatici su S3 o Backblaze.

Quando conviene migrare da Evolution API a Cloud API ufficiale?

Migra se: (1) superi 1000 conversazioni/mese ad alta criticità, (2) ti servono template messages verificati, (3) il cliente esige compliance enterprise, (4) hai già subito un ban. Evolution serve per MVP, test e volumi piccoli; Cloud API per produzione seria.

Vuoi applicarlo nella tua azienda?

Raccontaci quale processo vuoi sistemare e quali sistemi usi oggi. Esaminiamo la tua richiesta e concordiamo il passo successivo.

Scrivici su WhatsApp

Potrebbe interessarti anche