La WhatsApp Cloud API spiegata
La WhatsApp Cloud API è la versione dell'API della WhatsApp Business Platform che Meta ospita al posto tuo. Il tuo software invia i messaggi con richieste HTTPS e riceve risposte e stati di consegna tramite webhook. Meta ha chiuso la vecchia API On-Premises il 23 ottobre 2025, quindi oggi le aziende che usano l'API usano la Cloud API.
Di Mousa Alhelo, fondatore, E-SAFQA · Aggiornato il · 7 min di lettura · Come scriviamo e testiamo queste guide
Cos'è la WhatsApp Cloud API?
La WhatsApp Cloud API è l'interfaccia ospitata da Meta per accedere alla WhatsApp Business Platform. Uno sviluppatore, o un provider che costruisce l'integrazione per te, la chiama via HTTPS tramite la Graph API di Meta per inviare messaggi di testo, contenuti multimediali e messaggi interattivi da un numero di telefono aziendale. Le risposte e gli aggiornamenti di stato dei messaggi tornano a un URL webhook che controlli tu. Non gestisci nessun server WhatsApp in proprio, ed è per questo che il blog per sviluppatori di Meta la descrive come Cloud API, ospitata da Meta.
È un prodotto per sviluppatori, non un'app. Non c'è una casella di posta né una dashboard finché non le costruisci tu o un provider, ed è per questo che molti negozi incontrano la Cloud API tramite un Business Solution Provider o un'app costruita sopra di essa.
Che fine ha fatto l'API On-Premises?
Prima della Cloud API, un'azienda poteva ospitare il client On-Premises di WhatsApp sui propri server. Meta lo ha ritirato per fasi, e la sua pagina sulla dismissione indica le date qui sotto (verificate a ottobre 2026).
- Se un provider o un'integrazione vecchia parla ancora di hosting On-Premises, chiedi se è stato migrato alla Cloud API.
| Data | Cosa è cambiato |
|---|---|
| 9 gennaio 2024 | Le nuove funzioni arrivano solo sulla Cloud API. Il client On-Premises riceve solo correzioni di bug e di sicurezza. |
| 1° luglio 2024 | I nuovi numeri di telefono aziendali si possono registrare solo per la Cloud API. Tentare di registrarne uno per On-Premises restituisce il codice di errore 1005. |
| 23 ottobre 2025 | L'ultima versione On-Premises è scaduta. Non può più inviare messaggi, e i messaggi da o verso i numeri ancora registrati su di essa non vengono recapitati. |
Cosa serve per iniziare a usare la Cloud API?
La guida Get started di Meta elenca i prerequisiti a ottobre 2026: un account Facebook o un account Meta gestito, la registrazione come sviluppatore, un portfolio aziendale e un dispositivo con WhatsApp per i messaggi di prova. Ecco i passaggi principali.
- Crea un'app Meta con il caso d'uso WhatsApp nella Meta App Dashboard e collega il tuo portfolio aziendale.
- Collega un account WhatsApp e un account di messaggistica (Messaging account). La documentazione più recente di Meta usa questi due termini; l'account di messaggistica contiene i modelli di messaggio e i dati di fatturazione, e ora lo identifica il tuo vecchio WABA ID.
- Invia un messaggio di prova dal numero di prova con un token di accesso temporaneo.
- Configura un webhook in modo che gli aggiornamenti di stato e le risposte dei clienti arrivino al tuo server.
- Crea un utente di sistema e un token di accesso permanente con i permessi whatsapp_business_messaging e whatsapp_business_management.
- Registra il tuo numero di telefono aziendale e dagli un nome visualizzato. Un numero già in uso su WhatsApp deve prima essere eliminato, a meno che tu non lo registri con la funzione di coesistenza di Meta per gli utenti dell'app WhatsApp Business.
Come funzionano messaggi e limiti sulla Cloud API?
Meta elenca tre modi per portare il limite iniziale da 250 a 2.000: verificare la tua azienda, farla verificare da un partner o consegnare 2.000 messaggi modello di alta qualità entro 30 giorni. I livelli superiori da 10.000, 100.000 e illimitato si sbloccano automaticamente man mano che qualità e utilizzo crescono.
| Regola | Cosa documenta Meta |
|---|---|
| Opt-in | Puoi scrivere solo a persone che hanno accettato di ricevere messaggi dalla tua azienda. |
| Finestra di assistenza clienti | Quando un cliente ti scrive, si apre una finestra di 24 ore che si azzera a ogni nuovo messaggio del cliente. Al suo interno puoi inviare messaggi di assistenza in testo libero. |
| Messaggi modello | Fuori dalla finestra puoi inviare solo modelli pre-approvati nelle categorie marketing, utilità o autenticazione. |
| Limite di messaggistica | Il numero di clienti unici a cui puoi scrivere fuori da una finestra di assistenza in 24 ore mobili è fissato per ogni portfolio aziendale. I nuovi portfolio partono da 250. |
| Velocità di invio | Un numero di telefono aziendale invia per impostazione predefinita fino a 80 messaggi al secondo, e puoi chiederne di più. |
Quanto costa la WhatsApp Cloud API?
Meta addebita ogni messaggio consegnato. Dal 1° luglio 2025 il prezzo è per messaggio e non più per conversazione, e la tariffa dipende dalla categoria del messaggio (marketing, utilità, autenticazione o assistenza) e dal prefisso internazionale del destinatario. L'Arabia Saudita è uno dei mercati indicati nel listino di Meta, quindi i messaggi verso numeri +966 sono addebitati con una tariffa propria (vedi /it/blog/whatsapp-api-saudi-arabia-pricing). Meta non addebita i messaggi che i clienti inviano a un'azienda.
Dal 1° ottobre 2026 si pagano anche le risposte di assistenza all'interno della finestra di 24 ore. La pagina dei prezzi di Meta indica una fascia gratuita di 1.000 messaggi di assistenza per numero di telefono aziendale al mese. I provider aggiungono le proprie commissioni di piattaforma, che non sono nel listino di Meta. Per le tariffe attuali e un esempio di calcolo, vedi la nostra guida ai prezzi su /it/blog/whatsapp-business-api-pricing-explained.
Cloud API, app WhatsApp Business o app a dispositivo collegato?
| Cloud API | App WhatsApp Business | App a dispositivo collegato (WhatsApp Pilot) | |
|---|---|---|---|
| Chi costruisce l'esperienza | Uno sviluppatore o un provider | WhatsApp, come app gratuita | WhatsApp Pilot, un'app Shopify di E-SAFQA |
| Numero | Un numero di telefono aziendale registrato sull'API | Il tuo numero nell'app | Il tuo numero, collegato con un codice QR |
| Costi per messaggio di Meta | Sì, per ogni messaggio consegnato | Nessuno | Nessuno |
| Modelli | Obbligatori fuori dalla finestra di 24 ore | Non usati | Testo libero che modifichi nell'app |
| Stato di consegna e di lettura | Segnalato via webhook | Mostrato nell'app | Non disponibile con un dispositivo collegato |
| Ideale per | Volumi alti, campagne, più operatori, chatbot | Una persona che risponde alle chat | Un negozio che invia messaggi d'ordine dal proprio numero |
Un negozio Shopify ha bisogno della Cloud API?
Non sempre. Se ti servono volumi alti, modelli approvati, stato di consegna e di lettura o un chatbot, la Cloud API è la base giusta, di solito tramite un provider. Se un singolo negozio vuole soprattutto conferme d'ordine, avvisi di spedizione e promemoria basati sul consenso dal numero WhatsApp che i clienti già conoscono, un'app a dispositivo collegato è più semplice.
WhatsApp Pilot, un'app Shopify di E-SAFQA, collega il tuo numero WhatsApp come dispositivo collegato scansionando un codice QR. Non c'è la WhatsApp Business API né alcun costo per messaggio di Meta; Pro costa USD 15 ogni 30 giorni. Il compromesso è che le conferme di consegna e di lettura non sono disponibili. I dettagli sono su /it/how-it-works/whatsapp-connection.
Domande frequenti
Cos'è la WhatsApp Cloud API?
È l'API ospitata da Meta per la WhatsApp Business Platform. Il software le invia i messaggi via HTTPS e riceve risposte e aggiornamenti di stato tramite webhook, senza gestire server WhatsApp propri.
La WhatsApp Cloud API è gratuita?
No. Meta addebita ogni messaggio consegnato in base a categoria e paese, e i provider aggiungono commissioni di piattaforma. Dal 1° ottobre 2026 si pagano anche le risposte di assistenza, dopo una fascia gratuita di 1.000 al mese per numero di telefono.
Che fine ha fatto l'API On-Premises?
Meta ha smesso di aggiungere funzioni a gennaio 2024, ha chiuso le nuove registrazioni il 1° luglio 2024 e ha terminato il supporto il 23 ottobre 2025. I numeri aziendali oggi funzionano sulla Cloud API.
Posso usare la Cloud API e l'app WhatsApp Business sullo stesso numero?
Solo tramite la funzione di coesistenza di Meta, che si imposta durante la registrazione. Altrimenti un numero già in uso su WhatsApp deve essere eliminato prima di poterlo registrare per la Cloud API.
Mi serve la verifica dell'azienda per usare la Cloud API?
Puoi iniziare senza. Meta indica la verifica come uno dei modi per portare il limite di messaggistica da 250 a 2.000 clienti al giorno, e lo stato di Account aziendale ufficiale la richiede.
Pronto a far lavorare WhatsApp per il tuo negozio?
Inizia con il widget gratuito. Passa a Pro per i messaggi su ordini e spedizioni, il recupero carrelli, i codici per il riacquisto, il pulsante WhatsApp intelligente per i prodotti, gli avvisi di ritorno disponibile e Domanda prodotti.