API WhatsApp ufficiale e API non ufficiali (WAHA, Baileys…)
Whapi.Cloud, WAHA, Green API, Baileys: come funzionano le API WhatsApp non ufficiali, i loro rischi di ban e di affidabilità, e cosa cambia con l'API ufficiale.
Un'API WhatsApp non ufficiale (Whapi.Cloud, WAHA, Green API, Evolution API in modalità Baileys, Baileys, whatsapp-web.js) controlla un account WhatsApp come fa WhatsApp Web, dopo la scansione di un codice QR. È rapida e non richiede alcuna approvazione da parte di Meta, ma viola i Termini di servizio di WhatsApp e il numero può essere bannato. L'API ufficiale passa dalla Cloud API di Meta.
Ultimo aggiornamento: 17 novembre 2026
Come è stata scritta questa pagina
Genuka vende l'accesso all'API ufficiale, quindi abbiamo un interesse in questo confronto. Per mantenerlo equo, ogni affermazione su uno strumento proviene dalla documentazione di quello stesso strumento, e ogni regola di WhatsApp dai testi di WhatsApp, letti l'8 ottobre 2026 ed elencati in Fonti. Non abbiamo trovato alcun tasso di ban pubblicato, né da WhatsApp né da questi progetti, quindi non ne citiamo nessuno.
Come funziona un'API WhatsApp non ufficiale?
WhatsApp ti permette di collegare dispositivi secondari a un account: è così che funziona WhatsApp Web. Un'API non ufficiale si fa passare per uno di questi dispositivi. Scansioni un codice QR da Dispositivi collegati sul tuo telefono, o inserisci un codice di abbinamento, e lo strumento invia e riceve i messaggi dell'account come farebbe un browser.
Esistono due tecniche:
- Controllare il vero WhatsApp Web in un browser. whatsapp-web.js e i motori WEBJS e WPP di WAHA avviano Chromium con Puppeteer e chiamano le funzioni interne di WhatsApp Web.
- Parlare direttamente il protocollo di WhatsApp Web. Baileys, e i motori NOWEB e GOWS di WAHA, aprono una connessione WebSocket senza browser.
A questo, alcuni progetti aggiungono un'API HTTP e dei webhook: WAHA ed Evolution API girano sul tuo server, mentre Green API e Whapi.Cloud sono servizi ospitati che mantengono la sessione per te.
| Strumento | Tipo | Come si collega a WhatsApp | Prezzo indicato | Cosa dice il progetto |
|---|---|---|---|---|
| Baileys | Libreria TypeScript, licenza MIT | WebSocket, codice QR o codice di abbinamento | Gratuito | "not affiliated […] with WhatsApp"; "Do not spam people with this" |
| whatsapp-web.js | Libreria Node.js, licenza Apache 2.0 | WhatsApp Web controllato da Puppeteer | Gratuito | "it is not guaranteed you will not be blocked by using this method" |
| WAHA | Server HTTP self-hosted (Docker), licenza Apache 2.0 | Browser (WEBJS, WPP) o WebSocket (NOWEB, GOWS), codice QR | Gratuito; livello di assistenza opzionale da 5 USD al mese | "WhatsApp does not allow bots or unofficial clients on their platform" |
| Evolution API | Server REST self-hosted, licenza Apache 2.0 con condizioni aggiuntive (avviso d'uso obbligatorio, altrimenti licenza commerciale) | A tua scelta: Baileys (WhatsApp Web) o la Cloud API ufficiale di Meta | Gratuito | La modalità Baileys "may have limitations compared to official APIs" |
| Green API | Servizio ospitato | Codice QR tramite Dispositivi collegati; il telefono resta carico e online, oppure è ospitato da loro | Developer gratuito, Business 12 USD al mese, Chatbot 24 USD al mese | "The decision to block an account is made by WhatsApp" |
| Whapi.Cloud | Servizio ospitato | Sessione di dispositivo collegato, codice QR o codice di abbinamento | Sandbox gratuita limitata; Developer Premium a 29 USD al mese per numero (mostrato barrato da 40 USD) | "Any automation can carry a risk of WhatsApp restrictions" |
Evolution API è non ufficiale solo in modalità Baileys: il suo connettore Cloud API passa dalla piattaforma di Meta, con le stesse regole di Genuka WA.
Perché gli sviluppatori scelgono un'API non ufficiale?
- Si parte in pochi minuti. Basta la scansione di un codice QR: nessun portafoglio aziendale Meta, nessun Embedded Signup, nessun modello da far approvare.
- Scrivere a chiunque, in qualsiasi momento. Whapi.Cloud pubblicizza "No templates or approvals". Sull'API ufficiale, un messaggio inviato al di fuori della finestra di 24 ore deve essere un modello approvato da Meta.
- Un prezzo fisso, nessuna tariffa per messaggio. Whapi.Cloud non applica "no per-message, per-conversation, or per-request fees"; WAHA è gratuito, senza limiti sui messaggi. Sull'API ufficiale, Meta addebita i modelli e, dal 1° ottobre 2026, le risposte libere oltre i 1.000 messaggi di servizio gratuiti per numero al mese.
- Gruppi, Canali e Stato. Whapi.Cloud e WAHA li espongono. L'API di Genuka WA non gestisce i gruppi.
- Tieni il tuo telefono. La sessione si aggiunge accanto ai tuoi dispositivi esistenti; l'app continua a funzionare come prima.
Sono motivi reali. La domanda è quanto costano.
Quali sono i rischi di un'API WhatsApp non ufficiale?
Cosa dicono i Termini di servizio di WhatsApp?
I Termini di servizio di WhatsApp vietano le comunicazioni che comportano "bulk messaging, auto-messaging, auto-dialing, and the like", così come qualsiasi "non-personal use of our Services unless otherwise authorized by us". Vietano anche di sfruttare il servizio "through automated or other means" in modo non autorizzato, e di "create software or APIs that function substantially the same as our Services and offer them for use by third parties in an unauthorized manner". Quando i termini vengono violati, WhatsApp può "modify, suspend, or terminate your access".
Lo dicono i progetti stessi: whatsapp-web.js e WAHA scrivono che WhatsApp non consente bot né client non ufficiali, e i manutentori di Baileys dichiarano di non approvare alcun uso che violi i Termini di servizio di WhatsApp.
Il mio numero può essere bannato?
Sì, e nessuno di questi strumenti sostiene il contrario. Green API scrive che la decisione di bloccare un account spetta a WhatsApp e non dipende dal suo servizio. Elenca i segnali di automazione, i reclami dei destinatari e il tasso di risposta, raccomanda di "scaldare" un nuovo numero per almeno 10 giorni e consiglia di non scrivere a più di 200 clienti al giorno. Whapi.Cloud riconosce che qualsiasi automazione comporta un rischio di restrizioni. Sul repository di Baileys, gli utenti segnalano ancora account bannati dopo invii in massa (issue aperta il 7 ottobre 2026).
Un ban non ti costa solo l'integrazione: ti costa il numero che i tuoi clienti conoscono, insieme alle sue conversazioni.
Perché non avere modelli è un problema?
Sulla piattaforma ufficiale, la policy di WhatsApp Business richiede il consenso del destinatario: "You may only contact people on WhatsApp if: (a) they have given you their mobile phone number […]; and (b) you have received opt-in permission […]". Al di fuori della finestra di 24 ore, può partire solo un modello revisionato da Meta, e ogni portafoglio aziendale ha un limite di messaggistica, condiviso tra i suoi numeri, che sale quando i suoi messaggi sono di alta qualità e viene usata almeno la metà del limite.
In una sessione non ufficiale, nessuna di queste protezioni esiste: nulla ti impedisce di scrivere a una lista fredda. E i reclami dei destinatari sono tra le cause di blocco elencate da Green API.
Una sessione può disconnettersi?
Sì. Whapi.Cloud indica che di solito devi usare WhatsApp sul telefono almeno una volta ogni 14 giorni per mantenere attiva la sessione, e che WhatsApp può comunque reimpostare le sessioni collegate e richiedere una nuova autorizzazione. Green API ricorda che l'invio passa dal telefono, che deve restare carico e online, a meno che tu non noleggi un telefono ospitato da loro. WAHA avverte che le risposte dell'API e i payload dei webhook differiscono in modo significativo da un motore all'altro. Per le notifiche d'ordine o i codici di accesso, è un punto di guasto da mettere in conto.
Chi può leggere le tue conversazioni?
Un dispositivo collegato riceve le conversazioni dell'account, non solo quelle che interessano la tua integrazione: Baileys documenta perfino il recupero dell'intera cronologia. Con un servizio ospitato, è quel fornitore a detenere la sessione del tuo numero.
Quando può avere senso un'API non ufficiale?
Questi usi restano fuori dal quadro previsto da WhatsApp. Il rischio è lo stesso ovunque; cambia quanto ti costa. Resta sopportabile quando perdere il numero non costa quasi nulla:
- Automatizzare il tuo account personale: promemoria personali, archiviazione dei tuoi messaggi, notifiche inviate a te stesso.
- Un prototipo o una demo, su un numero dedicato che accetti di perdere, con destinatari che sanno di partecipare a un test.
- Uno strumento interno a basso volume, tra persone che ti conoscono e che ti hanno scritto.
Non appena dal numero dipendono clienti, codici di accesso o pagamenti, o scrivi a persone che non hanno chiesto di sentirti, il bilancio si ribalta.
In cosa è diversa l'API ufficiale tramite Genuka WA?
La Cloud API è la strada che Meta prevede per le aziende. Genuka è un Meta Tech Provider: colleghi il tuo numero WhatsApp Business tramite l'Embedded Signup di Meta, poi invii notifiche, codici monouso e campagne via HTTP, senza dover fare tu stesso domanda a Meta come fornitore.
| API ufficiale, tramite Genuka WA | API non ufficiale | |
|---|---|---|
| Consentita da WhatsApp | Sì, è la piattaforma pensata per le aziende | No: i Termini di servizio vietano l'accesso automatizzato non autorizzato |
| Collegamento del numero | Embedded Signup di Meta, sul tuo WhatsApp Business Account (WABA) | Scansione di un codice QR, come un dispositivo collegato |
| Scrivere per primi a un cliente | Un modello approvato da Meta | Qualsiasi messaggio |
| Volume | 250 destinatari unici ogni 24 ore per un nuovo portafoglio aziendale, poi 2,000, 10,000, 100.000 e illimitato | Nessun limite pubblicato; Green API consiglia di restare sotto i 200 clienti al giorno |
| Velocità | Il tetto di Meta di 80 messaggi al secondo per numero di default, 20 in coesistenza | Quello che la sessione consente |
| Gruppi, Canali, Stato | Non supportati da Genuka WA | Sì, a seconda dello strumento |
| Stati di consegna | Webhook firmati con HMAC-SHA256, ritentati, ripetibili | I webhook dello strumento |
| Costo | Le tariffe per messaggio di Meta, fatturate al tuo WABA, più un abbonamento Genuka per numero | Un abbonamento fisso, o gratuito se self-hosted |
| Rischio principale | Un modello rifiutato; una valutazione della qualità più bassa se i destinatari si lamentano | Un numero bannato, una sessione caduta |
A cosa rinunci, onestamente:
- Non puoi scrivere per primo senza un modello approvato da Meta.
- Il volume parte basso: 250 destinatari unici ogni 24 ore. Sale a 2.000 dopo che Meta ha verificato l'azienda, oppure dopo 2.000 messaggi consegnati fuori dalla finestra entro 30 giorni usando modelli di alta qualità, poi cresce automaticamente. Vedi cosa funziona senza la verifica di Meta.
- I modelli hanno un costo Meta, in base alla categoria e al paese del destinatario. Dal 1° ottobre 2026, Meta addebita anche le risposte libere inviate all'interno della finestra di 24 ore, oltre i 1.000 messaggi di servizio gratuiti per numero al mese.
- Genuka WA non invia a gruppi, Canali o Stato.
Cosa ottieni:
- Sei dentro il quadro previsto da WhatsApp. Il rischio che resta è la qualità: i messaggi indesiderati abbassano la valutazione del numero, e Meta può limitarlo.
- Nessun telefono, browser o codice QR da tenere in vita.
- Le risposte e gli stati (
sent,delivered,read,failed) arrivano su webhook firmati, ritentati 5 volte e ripetibili dal log. - Le disiscrizioni dal marketing vengono rispettate: Genuka WA rifiuta un modello di marketing che
conosce quando è destinato a un contatto che si è disiscritto (
403 recipient_opted_out), e una campagna di marketing salta quei contatti (statoskipped). - Meta fattura direttamente i tuoi messaggi, senza ricarico di Genuka. L'abbonamento parte da 5.000 FCFA o 12,99 USD al mese per numero, con una prova di 7 giorni e senza carta. Vedi la pagina dei prezzi.
Come passo da un'API non ufficiale all'API ufficiale?
Scopri quale app usa il numero
- Il numero usa l'app WhatsApp Business: tienilo. È la coesistenza di Meta: l'app continua a funzionare per le chat individuali e la cronologia delle chat si sincronizza. Ti serve l'app versione 2.24.17 o successiva, e la sincronizzazione della cronologia deve avvenire entro 24 ore. Quando colleghi il numero, Meta scollega dall'account ogni dispositivo associato, sessione non ufficiale compresa: non ricollegarla dopo.
- Il numero è registrato sulla normale app WhatsApp: deve essere liberato prima, eliminando l'account WhatsApp su quel numero, oppure usi un altro numero.
In coesistenza, Meta indica che le chat di gruppo non vengono sincronizzate e che le liste broadcast dell'app vengono disattivate. I dettagli sono nella guida Coesistenza.
Collega il numero a Genuka WA
Crea un account: l'onboarding ti propone di collegare un numero. In seguito il percorso è Numeri > Aggiungi un numero > Collega WhatsApp, che apre l'Embedded Signup di Meta. Il numero, il suo WABA e i suoi modelli compaiono nel tuo spazio di lavoro. Aggiungi un metodo di pagamento all'account WhatsApp Business: è Meta a fatturare i messaggi. Vedi Collegare un numero.
Invia i tuoi modelli
Ogni messaggio che invii per primo (conferma d'ordine, promemoria, promozione) diventa un modello che
Meta deve approvare: inviali presto. I codici monouso usano la categoria AUTHENTICATION, riservata
alle aziende che hanno superato la verifica dell'azienda di Meta (o un altro dei percorsi di crescita
di Meta): vedi inviare un OTP WhatsApp da Node.js.
Raccogli il consenso dei tuoi contatti
Scrivi solo alle persone che hanno accettato di ricevere tue notizie su WhatsApp, e smetti non appena si disiscrivono: la disiscrizione ti arriva via webhook.
Sostituisci la chiamata di invio e collega i webhook
Crea una chiave API, sostituisci la tua chiamata di invio (vedi sotto), poi registra l'URL del tuo webhook e verifica la firma prima di elaborare qualsiasi cosa: vedi ricevere risposte e stati via webhook.
Cosa cambia nel codice di invio?
Prima, con una sessione WAHA, un messaggio libero va a qualsiasi numero:
curl -X POST https://waha.example.com/api/sendText \
-H "X-Api-Key: $WAHA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"session": "default",
"chatId": "[email protected]",
"text": "Hi Awa, your order #1042 has shipped."
}'Con Genuka WA, lo stesso messaggio diventa un modello approvato, e passi solo le sue variabili:
curl -X POST https://wa.genuka.com/api/v1/messages \
-H "Authorization: Bearer $GENUKA_WA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"connectionId": "cnx_...",
"to": "+237699001122",
"template": {
"name": "order_shipped",
"language": "en_US",
"variables": ["Awa", "#1042"]
}
}'
# { "data": { "messageId": "wamid.HBg..." } }Per rispondere a un cliente che ti ha scritto nelle ultime 24 ore, sostituisci template con
text: basta un messaggio libero. Al di fuori di quella finestra l'API risponde comunque 200, con
un campo warning (outside_service_window, o unverified_service_window quando non risulta alcun
messaggio in entrata da quel contatto). Meta non consegna il messaggio, e di solito lo segnala più
tardi come stato failed con l'errore 131047 sui tuoi webhook. Ogni
tipo di messaggio è descritto in Inviare messaggi.
FAQ
Un'API WhatsApp non ufficiale è legale?
Viola i Termini di servizio di WhatsApp, che WhatsApp fa rispettare sospendendo o chiudendo l'accesso al servizio. Oltre a questo, norme come la protezione dei dati o la legge sul marketing diretto del tuo paese si applicano qualunque strumento tu usi.
Il mio numero verrà sicuramente bannato?
No, ma nessuno può prometterti il contrario, e non abbiamo trovato alcun tasso di ban pubblicato. Gli strumenti stessi indicano i fattori che aumentano il rischio: un numero nuovo, invii in massa, destinatari che non rispondono o che si lamentano.
Posso tenere il mio numero quando passo all'API ufficiale?
Sì, se il numero usa l'app WhatsApp Business: la coesistenza di Meta lo collega alla Cloud API senza toccare l'app. Un numero registrato sulla normale app WhatsApp deve essere liberato prima. In ogni caso, la sessione non ufficiale deve sparire.
L'API ufficiale può pubblicare nei gruppi WhatsApp?
Sì, fino a un certo punto: Meta offre una Groups API sulla Cloud API, aperta agli Official Business Account, con al massimo 8 partecipanti per gruppo, che entrano tramite un link di invito. Non è disponibile su un numero che usa anche l'app WhatsApp Business. Genuka WA non la espone: invia messaggi individuali, modelli e campagne. In coesistenza, le chat di gruppo dell'app non vengono sincronizzate.
Quanto costa l'API ufficiale con Genuka WA?
Due livelli: Meta fattura i tuoi messaggi a pagamento al tuo WhatsApp Business Account, in base alla categoria e al paese del destinatario, e Genuka applica un abbonamento per numero, da 5.000 FCFA o 12,99 USD al mese, senza ricarico sui messaggi. Vedi Piani e fatturazione.
Fonti
Lette l'8 ottobre 2026.
- WhatsApp, Terms of Service
- WhatsApp, WhatsApp Business Messaging Policy
- Baileys, repository GitHub e README
- Baileys, issue #2850: account bannati dopo invii in massa
- whatsapp-web.js, repository GitHub e README
- WAHA, panoramica
- WAHA, motori
- WAHA, invio dei messaggi
- Evolution API, repository GitHub e README
- Green API, panoramica e prezzi
- Green API, prima di iniziare
- Green API, come proteggere un numero dal ban
- Whapi.Cloud, panoramica e FAQ
- Whapi.Cloud, prezzi
- Meta, modelli di messaggio
- Meta, limiti di messaggistica
- Meta, informazioni sulla WhatsApp Business Platform (Cloud API)
- Meta, Groups API
- Meta, collegare gli utenti dell'app WhatsApp Business (coesistenza)
- Meta, prezzi della WhatsApp Business Platform
- Meta, fatturazione dei messaggi di servizio dal 1° ottobre 2026
- WATI, Understanding Wati's pricing structure (1.000 messaggi di servizio gratuiti per numero al mese)
- Trengo, modifiche ai prezzi di WhatsApp dal 1° ottobre 2026