Articoli

La WhatsApp Business API spiegata: accesso, template, costi e collegamento al CRM

La WhatsApp Business API è il modo ufficiale di Meta per collegare un numero a un software invece che a un telefono. Ecco cosa ti serve, quanto costa e cosa cambia nel lavoro di tutti i giorni.

In breve: La WhatsApp Business API, oggi offerta come Cloud API, è l'interfaccia ufficiale di Meta che permette a un software di inviare e ricevere messaggi WhatsApp per un numero aziendale. Ti servono un portfolio business di Meta, un'app, un numero di telefono con un nome visualizzato e template approvati per tutto ciò che invii fuori dalla finestra di 24 ore dall'ultimo messaggio del cliente. Meta addebita ogni messaggio consegnato in base a categoria e paese; i messaggi dei clienti sono gratuiti. NeuroCRM collega la Cloud API a mano con i tuoi token, ed è disponibile anche un gateway GREEN-API.

Cos'è la WhatsApp Business API?

È un'interfaccia, non un'app. Non si scarica e non c'è una schermata in cui accedere. È il tuo software (un CRM, un help desk, un tuo script) a parlare con WhatsApp attraverso di essa: i messaggi in arrivo raggiungono un indirizzo webhook e le risposte partono come chiamate all'API.

Oggi l'interfaccia documentata da Meta è la Cloud API, ospitata da Meta stessa. Chi cerca «whatsapp api», «api whatsapp» o «whatsapp cloud api» intende questa. «WhatsApp Business Platform» è il nome più ampio che Meta dà alla sua offerta di messaggistica per le aziende; la Cloud API è l'interfaccia che ne fa parte.

Cosa guadagni rispetto a un telefono: più persone possono rispondere dallo stesso numero, i messaggi possono partire da un software e ogni chat può stare accanto a un contatto e a una trattativa. Cosa accetti in cambio: regole sui template, una finestra di 24 ore e una tariffa per messaggio, tutte descritte qui sotto.

Che differenza c'è tra l'app WhatsApp Business, WhatsApp Business Web e l'API?

  • App WhatsApp Business. Un'app per telefono che WhatsApp descrive come pensata per il titolare di una piccola impresa. Un'attività, di solito una sola persona alla tastiera.
  • WhatsApp Business Web. Il termine con cui si cerca l'apertura dello stesso account aziendale nel browser. Resta la finestra di chat dell'app, non un'integrazione: niente è collegato a trattative, attività o report.
  • WhatsApp Business API (Cloud API). Un'interfaccia di programmazione. Il numero viene registrato sulla piattaforma, e a gestire le chat è un programma, non un telefono.

Se devi solo rispondere a poche persone da un portatile, l'app con la sua versione per browser può bastare. Passa all'API quando più persone del team condividono il numero, quando i messaggi devono partire in automatico o quando le conversazioni devono confluire in un CRM.

Chi può avere accesso e cosa serve?

La guida introduttiva di Meta chiede un account Facebook o un account Meta gestito, la registrazione come sviluppatore e un dispositivo con WhatsApp per i messaggi di prova. Nello stesso percorso scegli o crei un portfolio business di Meta, crei un'app con il caso d'uso WhatsApp e aggiungi un numero di telefono.

Il numero deve rispettare alcune regole, indicate nella documentazione di Meta sui numeri di telefono:

  • Un numero già usato con WhatsApp non si può registrare finché non lo elimini da WhatsApp.
  • Deve essere tuo, comprendere il prefisso internazionale e quello locale e poter ricevere un SMS o una chiamata vocale per la verifica.
  • Alla registrazione serve un nome visualizzato, che compare nel profilo WhatsApp del numero.

Per iniziare i test non servono template: la guida rapida di Meta invia un template già pronto, hello_world. Ti servono template tuoi approvati quando scrivi per primo o quando rispondi dopo che la finestra si è chiusa.

Come funziona la finestra di 24 ore?

Quando un cliente ti scrive o ti chiama, si apre una finestra di 24 ore. Ogni nuovo messaggio del cliente la fa ripartire da capo. Finché è aperta puoi inviare messaggi liberi. Quando si chiude, sono ammessi solo i messaggi template (la regola è riportata nella pagina dei prezzi di Meta).

I template rientrano in tre categorie: marketing, utility e autenticazione. Li crei in WhatsApp Manager e Meta li esamina; metti in conto un'attesa prima che un template nuovo si possa usare.

Come addebita Meta la WhatsApp Business API?

Secondo la pagina dei prezzi di Meta, verificata il 18 novembre 2026:

  • Dal 1° luglio 2025 Meta addebita ogni messaggio consegnato, non più ogni conversazione. Il prezzo dipende dalla categoria del messaggio e dal prefisso internazionale del destinatario.
  • I messaggi che i clienti inviano a te non si pagano.
  • I template sono di marketing, utility o autenticazione; le risposte libere dentro la finestra sono messaggi di assistenza (service). Meta elenca anche Meta Business Agent.
  • Ogni numero di telefono aziendale ha 1.000 messaggi di assistenza gratuiti al mese, con azzeramento mensile. Dal 1° ottobre 2026 i messaggi di assistenza si pagano a partire dal 1.001°.
  • Senza un metodo di pagamento sull'account di messaggistica, Meta consegna i messaggi di assistenza solo entro la quota gratuita.
  • I template utility inviati dentro una finestra aperta erano gratuiti fino al 30 settembre 2026 e si pagano dal 1° ottobre 2026.
  • Se un cliente ti scrive da un annuncio Click to WhatsApp nell'app mobile e rispondi dentro la finestra, si apre una finestra gratuita del punto di ingresso, fino a 7 giorni, per i messaggi di marketing, utility, autenticazione e assistenza.

Le tariffe in dollari si trovano nei file dei listini che Meta collega da quella pagina e cambiano per paese e categoria. Prima di fare il budget, controlla il file dei paesi che ti interessano; qui non riportiamo nessuna tariffa.

I costi di Meta vanno sull'account WhatsApp che colleghi. Il fornitore del CRM o di un altro software aggiunge il proprio canone.

Posso inviare messaggi di marketing e usare un bot?

Sì, entro le regole di Meta: i template di marketing sono una categoria di messaggi con un prezzo proprio, e un bot è un software che usa la stessa API, con le stesse regole su finestra e template.

«Inviare un messaggio con la WhatsApp API», in pratica, vuol dire due tipi di chiamata: un messaggio libero dentro la finestra o un messaggio template fuori. Quale dei due hai a disposizione lo decide l'ora dell'ultimo messaggio del cliente.

Come si collega NeuroCRM alla WhatsApp Business API?

NeuroCRM offre due modi per collegare WhatsApp. Per un confronto più ampio tra i due, leggi CRM per WhatsApp: API ufficiale o gateway a QR. Questa pagina approfondisce il lato API.

Collegare la Cloud API a mano

In Impostazioni → Integrazioni scegli API Cloud di WhatsApp Business e compili quattro campi:

  1. ID Numero di Telefono, dalla schermata Configurazione API di Meta.
  2. Token di Accesso Permanente (Utente di Sistema), generato in Impostazioni Business → Utenti di sistema.
  3. App Secret, che serve a verificare la firma dei webhook in arrivo.
  4. ID Account WhatsApp Business (WABA ID).

Poi clicca «Verifica e connetti». NeuroCRM mostra un URL di Callback e un Token di Verifica: li incolli entrambi nella tua app Meta, in WhatsApp → Configurazione → Webhooks, e ti iscrivi al campo messages. Puoi aggiungere più numeri.

Non esiste un pulsante unico. L'app Meta, l'utente di sistema e il token li crei tu, quindi metti in conto che il primo collegamento richieda un po' di tempo. Prepara la parte su Meta prima di cominciare.

Cosa vedono gli operatori

Ogni chat WhatsApp arriva nella stessa casella degli altri canali, con una scheda contatto. NeuroCRM conta le 24 ore dall'ultimo vero messaggio WhatsApp inviato dal cliente e considera la finestra chiusa con cinque minuti di anticipo.

Quando la finestra è chiusa, NeuroCRM invia un template approvato al posto del tuo testo: quello che hai scelto, quello predefinito dello spazio di lavoro oppure un template approvato senza variabili né contenuti multimediali. La tua bozza resta nel campo di risposta finché il cliente non risponde. Senza un template approvato l'invio viene rifiutato, e un secondo template parte prima della risposta del cliente solo se lo scegli di nuovo dall'elenco.

Regole, automazioni e AI

  • Automazioni. Fuori dalla finestra un'automazione non invia nulla e non sceglie un template: il passaggio viene segnato come non inviato. Per gli eventi delle trattative, il messaggio va nella conversazione più vecchia del contatto, qualunque sia il canale.
  • Sequenze di vendita. Un passaggio WhatsApp invia il template approvato che indichi in quel passaggio.
  • Risposte AI. Neuro Contact Center è un modulo a pagamento: 200 $ al mese più 0,50 $ per ogni dialogo riuscito, con la tua chiave AI senza ricarico (0%) oppure tramite NeuroCRM con un +20%. Fuori dalla finestra di 24 ore non risponde e non invia template. Non prenota appuntamenti da solo.

L'alternativa GREEN-API

GREEN-API è un gateway non ufficiale. Colleghi un numero personale con un codice QR nella console di GREEN-API, poi inserisci idInstance e apiTokenInstance in NeuroCRM. Il suggerimento della stessa integrazione dice che è adatto a «casi in cui l'API ufficiale di WhatsApp Business non è disponibile». Non è la piattaforma di Meta, quindi le regole su template e finestra descritte sopra non lo riguardano.

Cosa NeuroCRM non fa con la WhatsApp Business API

  • Nessun collegamento con un clic. Le credenziali Meta si inseriscono a mano; il flusso Embedded Signup di Meta non è disponibile come pulsante.
  • Nessuna coesistenza. Un numero usato contemporaneamente nell'app WhatsApp Business e nell'API non funziona tramite NeuroCRM.
  • I costi dei messaggi di Meta non sono compresi nel prezzo della postazione e non li stabilisce NeuroCRM: Meta li addebita all'account che colleghi.
  • Nessuna scelta automatica del template da parte delle automazioni o dell'AI fuori dalla finestra di 24 ore.

Quanto costa usare WhatsApp in NeuroCRM?

Le postazioni costano 13 $ al mese per utente, oppure 10,40 $ se paghi un anno, e non esiste un piano gratuito. La prova di 14 giorni include tutto, con utenti illimitati, poi lo spazio di lavoro passa in sola lettura. Vedi i prezzi. Neuro Contact Center è il modulo a parte descritto sopra. I costi per messaggio di Meta sono una terza voce, addebitata da Meta.

Per confrontare i sistemi, vedi i confronti di NeuroCRM e la guida alle alternative a Kommo. Per WhatsApp accanto agli altri canali, leggi l'articolo sull'inbox unificata.

Checklist: prima di collegare

  1. Scegli un numero tuo, su cui puoi ricevere un SMS o una chiamata di verifica. Se è già su WhatsApp, preparati a eliminarlo prima da lì.
  2. Crea il portfolio business di Meta, l'app con il caso d'uso WhatsApp e un utente di sistema con un token permanente.
  3. Scegli il nome visualizzato.
  4. Aggiungi un metodo di pagamento sul lato Meta, altrimenti i messaggi di assistenza oltre la quota gratuita non verranno consegnati.
  5. Invia almeno un template utility in WhatsApp Manager e aspetta l'approvazione di Meta prima di partire.
  6. Annota l'ID del numero di telefono e il WABA ID dalla schermata Configurazione API.
  7. Collega il numero in NeuroCRM, copia in Meta l'URL di Callback e il Token di Verifica, iscriviti a messages.
  8. Mandati un messaggio, rispondi, poi aspetta che la finestra si chiuda e prova un template.

Domande frequenti

La WhatsApp Business API è gratuita?

Non del tutto. Meta addebita ogni messaggio consegnato, tranne i messaggi dei clienti, i primi 1.000 messaggi di assistenza per numero ogni mese e i messaggi in una finestra gratuita del punto di ingresso.

Che differenza c'è tra la WhatsApp API e la Cloud API?

Per una nuova configurazione, in pratica sono la stessa cosa: la Cloud API è la versione che Meta ospita e documenta, ed è quella che usa l'integrazione API Cloud di WhatsApp Business di NeuroCRM.

Posso usare con l'API il numero della mia app WhatsApp Business?

Meta dice che un numero già usato con WhatsApp va eliminato da WhatsApp prima della registrazione. Tramite NeuroCRM non funziona usare lo stesso numero nell'app e nell'API contemporaneamente (la cosiddetta coesistenza).

Perché il mio messaggio non è arrivato al cliente?

Due cause frequenti: la finestra di 24 ore era chiusa e il messaggio non era un template, oppure sull'account Meta mancava un metodo di pagamento quando i messaggi di assistenza gratuiti erano finiti. Con la finestra chiusa NeuroCRM non invia il tuo testo semplice: invia prima un template approvato e tiene il tuo testo nel campo di risposta.

Più persone possono rispondere da un unico numero API?

Sì. Le chat di un numero arrivano in una casella condivisa di NeuroCRM, e puoi collegare più numeri.

Fonti

  • Meta, WhatsApp Business Platform pricing — https://developers.facebook.com/docs/whatsapp/pricing (verificato il 18 novembre 2026)
  • Meta, Cloud API get started — https://developers.facebook.com/docs/whatsapp/cloud-api/get-started (verificato il 18 novembre 2026)
  • Meta, Phone numbers — https://developers.facebook.com/docs/whatsapp/cloud-api/phone-numbers (verificato il 18 novembre 2026)
  • App WhatsApp Business — https://whatsappbusiness.com/products/business-app/ (verificato il 18 novembre 2026)

Come è stato scritto questo articolo: il team di NeuroCRM lo ha redatto con l'aiuto dell'AI; le affermazioni sul prodotto sono state verificate nel codice e nella guida di NeuroCRM; i prezzi sono quelli del listino pubblicato alla data di aggiornamento.