Come Creare e Configurare le API di WhatsApp Business Cloud

📱
Guida Ufficiale · Aggiornata 2026

Configurazione WhatsApp Cloud API
per WinSender

Guida passo-passo aggiornata per collegare il tuo numero WhatsApp Business alle API ufficiali di Meta e iniziare a inviare messaggi in modo sicuro e scalabile dal tuo PC.

✅ Nessun rischio di ban
✅ API ufficiali Meta
✅ Server gestiti da Meta
✅ Invio bulk da PC

💡 Cos’è la WhatsApp Cloud API?

La WhatsApp Cloud API è la soluzione ufficiale di Meta per inviare e ricevere messaggi WhatsApp su larga scala. I server sono ospitati direttamente da Meta (nessun server tuo da gestire), con aggiornamenti automatici e setup semplificato. Dal 2025 è l’unica modalità supportata per l’accesso diretto all’API.

📌 WinSender si collega direttamente a questa API: puoi inviare messaggi bulk, configurare auto-risposte e gestire tutte le conversazioni dal tuo PC Windows, senza rischi di ban.

📋 Cosa ti serve prima di iniziare

📧
Account Facebook
Un account Facebook personale attivo

🏢
Dati aziendali
Nome azienda, sito web, indirizzo

📱
Numero di telefono
Un numero non già attivo su WhatsApp

💳
Carta di pagamento
Richiesta da Meta per attivare l’API (anche con saldo zero)

⚠️ Numero già su WhatsApp? Se il numero è già registrato su WhatsApp o WhatsApp Business, devi prima eliminare quell’account dall’app mobile, attendere qualche minuto, e solo poi procedere con la registrazione nell’API.

Configurazione passo-passo

Segui ogni passaggio nell’ordine indicato. L’intera procedura richiede circa 20-30 minuti.

📑 Indice rapido

➊ Login su Meta for Developers
➋ Crea l’App Meta
➌ Selezione Use Case WhatsApp
➍ Completa impostazioni app
➎ Pannello API Setup
➏ Aggiungi metodo di pagamento
➐ Registra il tuo numero reale
➑ Crea System User
➒ Genera Token Permanente
➓ Configura WinSender

1

Login su Meta for Developers

Vai su developers.facebook.com/apps e clicca su Login in alto a destra. Accedi con il tuo account Facebook personale. Se è la prima volta, ti verrà chiesto di completare la registrazione come sviluppatore: accetta i termini e verifica il tuo account tramite email o SMS.

2

Crea una nuova App Meta

Nella dashboard clicca su Create App. Compila i campi richiesti: App name (es. “WinSender MyBusiness”) e App contact email.

Schermata creazione app Meta - dettagli

3

Seleziona il Use Case WhatsApp

Nella sezione Use cases filtra per “Business messaging” e seleziona Connect with customers with WhatsApp. Poi scegli il tuo Business Portfolio e clicca su Go to Dashboard.

Selezione Use Case WhatsApp
Go to Dashboard

4

Completa le impostazioni dell’app

Prima di procedere, Meta richiede di completare le impostazioni base dell’app. Vai su App Settings → Basic e compila almeno:

  • Privacy Policy URL – l’URL della tua policy (es. pagina del tuo sito)
  • Terms of Service URL – l’URL dei tuoi termini
  • App Icon – un’icona 1024×1024px

Impostazioni base app Meta

💡 Suggerimento: Se non hai una policy dedicata, puoi usare temporaneamente un link al tuo sito web o creare una pagina semplice. Potrai aggiornarlo in seguito.

5

Accedi al pannello API Setup

Dal menu di sinistra vai su Use cases → Customize (o direttamente su WhatsApp → API Setup). Qui trovi il pannello centrale di configurazione dell’API.

Use Cases - Customize

In questa schermata vedi il numero di test fornito da Meta (usabile subito, gratuito, fino a 5 contatti), il tuo Phone Number ID e il WhatsApp Business Account ID (WABA ID). Annotali: ti serviranno dopo.

Pannello API Setup

6

Aggiungi metodo di pagamento OBBLIGATORIO

⚠️ Novità 2024-2025: Meta ora richiede l’aggiunta di una carta di credito/debito per poter usare l’API con numeri reali. La carta non viene addebitata immediatamente ma è necessaria per l’attivazione. Potrai iniziare a pagare solo quando i messaggi supereranno la soglia gratuita.

Sempre nella sezione API Setup, clicca su Add Payment Method e inserisci i dati della tua carta. Questo sblocca la possibilità di inviare messaggi oltre la sandbox di test.

Aggiunta numero e metodo di pagamento

7

Registra il tuo numero di telefono reale

Clicca su Add Phone Number nel pannello API Setup. Inserisci il numero con prefisso internazionale (es. +39 3XX XXXXXXX) e scegli il metodo di verifica (SMS o chiamata vocale). Inserisci il codice ricevuto per completare la verifica.

✅ Dopo la verifica, il tuo numero apparirà nel menu a tendina “From” del pannello API Setup. Vedrai aggiornati anche il Phone Number ID relativo al tuo numero reale.

Puoi inviare subito un messaggio di test tramite il pulsante Send message nel pannello per verificare che tutto funzioni correttamente.

8

⭐ Crea un System User in Meta Business Manager

⚠️ Perché è fondamentale: Il token visibile nel pannello API Setup è temporaneo e scade ogni 24 ore. Se lo usi in WinSender, il software smetterà di funzionare ogni giorno. Per un uso continuativo devi creare un token permanente (non expiring) tramite un System User.

Passaggio 1: Vai su Meta Business Settings → Utenti → Utenti di sistema. Clicca su + Aggiungi.

Meta Business Settings - Users System Users

Passaggio 2: Nella finestra che appare, scegli un nome (es. “WinSender Bot”), imposta il ruolo su Admin e clicca Crea utente di sistema.

Creazione System User Admin

Passaggio 3: Clicca su Aggiungi asset → scheda App → seleziona l’app che hai creato → attiva Controllo completo → Aggiungi asset.

Assegnazione asset app al System User

Passaggio 4: Torna su Aggiungi asset → scheda Account WhatsApp → seleziona il tuo WABA → attiva Controllo completo → Aggiungi asset.

Assegnazione WhatsApp Business Account al System User

9

⭐ Genera il Token Permanente

Dalla pagina System Users (sempre in Business Settings), trova l’utente che hai creato e clicca su Genera nuovo token.

Nel popup che appare:

  1. Seleziona la tua App dal menu a tendina
  2. Imposta la scadenza su Mai (Never)
  3. Spunta i permessi:
    • whatsapp_business_messaging
    • whatsapp_business_management
  4. Clicca Genera token
🔴 IMPORTANTE: Il token viene mostrato una sola volta. Copialo immediatamente e salvalo in un posto sicuro (ad es. un file di testo riservato). Non sarà possibile visualizzarlo di nuovo: potrai solo rigenerarne uno nuovo.

✅ Hai ora tutti i dati necessari per WinSender:

  • Access Token → il token permanente appena generato
  • Phone Number ID → visibile nel pannello API Setup dopo aver selezionato il tuo numero
  • WhatsApp Business Account ID → visibile nel pannello API Setup
  • Phone Number → il tuo numero con prefisso internazionale

10

Configura WinSender

Apri WinSender sul tuo PC, vai in SETTINGS e inserisci i quattro dati raccolti nei passi precedenti:

🔑 Access Token
Token permanente del System User

📞 Phone Number
Numero con prefisso (es. +39…)

🆔 Phone Number ID
ID numerico dal pannello API Setup

🏢 Business Account ID
WABA ID dal pannello API Setup

Schermata Settings di WinSender

Clicca su APPLY SETTINGS. Se non compare nessun messaggio di errore, la connessione è avvenuta con successo. 🎉

✅ WinSender è connesso a WhatsApp Cloud API. Sei pronto per inviare!

💰 Prezzi WhatsApp Cloud API

Aggiornati alla modifica di Meta del 1° luglio 2025.

📅 Cambio luglio 2025: dal pagamento per conversazione al pagamento per messaggio

Dal 1° luglio 2025 Meta ha abbandonato il vecchio sistema che addebitava una tariffa per ogni finestra di conversazione di 24h. Ora ogni singolo template message inviato viene fatturato individualmente, in base alla sua categoria e al paese del destinatario. I messaggi liberi (non-template) e i template Utility inviati durante una finestra di servizio attiva rimangono gratuiti.

🆓 Cosa rimane gratuito

  • Risposte libere (testo, immagini, audio) inviate entro 24h dall’ultimo messaggio del cliente
  • Template Utility inviati durante una finestra di servizio attiva (Customer Service Window)
  • Tutti i messaggi nelle 72h dopo una conversazione avviata da un’inserzione Click-to-WhatsApp

Categorie di messaggi template

📣
Marketing
Promozioni, offerte, newsletter, campagne
Tariffato
varia per paese

🔧
Utility
Conferme ordine, spedizioni, notifiche
Ridotto
gratis in CSW aperta

🔐
Authentication
Codici OTP, verifica identità
Ridotto
sconti per volume

💬
Service
Risposte a messaggi ricevuti (entro 24h)
GRATIS
dentro la CSW

Tariffe indicative per messaggi Marketing (USD per messaggio)

PaeseMarketingUtilityAuthentication
🇮🇹 Italia~$0.040~$0.008~$0.010
🇩🇪 Germania~$0.115~$0.013~$0.016
🇬🇧 Regno Unito~$0.038~$0.008~$0.009
🇺🇸 USA / Canada~$0.025~$0.004~$0.006
🇧🇷 Brasile~$0.0625~$0.008~$0.009
🇮🇳 India~$0.011~$0.001~$0.002

* Tariffe indicative, soggette a variazioni. Consulta la pagina prezzi ufficiale Meta per i valori aggiornati.

❓ Domande frequenti

Il token scade: cosa succede?

Il token temporaneo (dal pannello API Setup) scade ogni 24 ore. Se lo usi in WinSender, il software smetterà di funzionare. Per questo è obbligatorio usare il token permanente generato tramite System User (Step 8-9 di questa guida).

Posso usare il mio numero di cellulare personale?

Sì, ma solo se non è già registrato su WhatsApp. Se lo è, dovrai prima eliminare quell’account dall’app mobile, attendere qualche minuto, e poi procedere con la registrazione nell’API.

Quanti messaggi posso inviare al giorno?

Il limite iniziale è di 1.000 contatti unici al giorno (Tier 1). Man mano che invii messaggi e completi la verifica business, il limite aumenta automaticamente: Tier 2 (10.000/giorno), Tier 3 (100.000/giorno), fino a illimitato.

È obbligatorio inserire la carta di credito?

Sì, dal 2024 Meta richiede un metodo di pagamento per poter usare numeri reali e uscire dalla sandbox. Non viene addebitato nulla fino al superamento della soglia gratuita, ma la carta va inserita per sbloccare l’accesso completo.

L’API ufficiale evita davvero i ban?

Sì. A differenza dei metodi non ufficiali che simulano WhatsApp Web, la Cloud API usa i server ufficiali di Meta, eliminando il rischio di ban da automazione. Occorre tuttavia rispettare le policy di WhatsApp Business: no spam, opt-in esplicito dei contatti.

Hai bisogno di aiuto?

Se hai riscontrato problemi durante la configurazione o vuoi saperne di più su WinSender, il nostro team è a tua disposizione.

📩 Contatta il Supporto

Lascia un commento

Il tuo indirizzo email non sarà pubblicato. I campi obbligatori sono contrassegnati *