Collega WhatsApp (Meta Cloud API)
Questa è la guida più lunga del sito, e non c’è scorciatoia: WhatsApp passa da Meta, e Meta vuole un’azienda, un’app e un numero verificato. Metti da parte 30–40 minuti tranquilli. Tu mantieni la proprietà del numero e del WhatsApp Business Account — noi non li deteniamo mai.
Cosa ti serve
- Un account Meta Business, verificato o con verifica in corso
- Un numero di telefono NON registrato nell’app WhatsApp normale o WhatsApp Business — se lo è, elimina prima quell’account e attendi qualche minuto
- Accesso a quel numero per ricevere il codice di conferma via SMS o chiamata vocale
- 30–40 minuti, più 1–2 giorni perché Meta revisioni il tuo nome visualizzato
Passaggi
- 1
Crea un’app Meta
Vai su
developers.facebook.com→ "My Apps" → "Create App". Scegli "Other" come caso d’uso e "Business" come tipo di app, poi collega l’app al tuo account Meta Business. - 2
Aggiungi il prodotto WhatsApp
Nella dashboard dell’app trova "WhatsApp" e premi "Set up". Meta crea per te un WhatsApp Business Account, oppure ti permette di selezionarne uno esistente.
- 3
Aggiungi e verifica il tuo numero di telefono
In "WhatsApp" → "API Setup" premi "Add phone number". Inserisci il nome visualizzato che vedranno i clienti, la categoria della tua attività e il numero, poi conferma il codice che Meta invia via SMS o chiamata vocale.
Il nome visualizzato va in revisione e di solito richiede 1–2 giorni. Nel frattempo puoi completare tutta la configurazione e fare test con il numero di prova temporaneo di Meta.
- 4
Copia il Phone number ID e il WABA ID
Entrambi si trovano in cima alla pagina "API Setup":
Phone number IDeWhatsApp Business Account ID. Tienili in un appunto — li incollerai al passaggio 7. - 5
Copia l’App ID e l’App secret
Dashboard dell’app → "App settings" → "Basic".
App IDè sulla pagina; premi "Show" accanto aApp secrete copia anche quello. - 6
Crea un System User e un token permanente
Apri
business.facebook.com→ "Business settings" → "Users" → "System users" → "Add". Dagli un nome e il ruolo Admin. Poi "Add assets": dagli il controllo completo sia della tua app sia del tuo WhatsApp Business Account. Infine "Generate new token" — scegli la tua app, spuntawhatsapp_business_messagingewhatsapp_business_management, e imposta la scadenza su "Never".Il token mostrato nella pagina "API Setup" è temporaneo e smette di funzionare dopo 24 ore. Solo il token del System User mantiene il tuo assistente online.
- 7
Incolla tutto nel pannello
Nel pannello: "Channels" → "Add channel" → "WhatsApp". Incolla il Phone number ID, il WABA ID, l’App ID, l’App secret e il token permanente. Tutto viene cifrato prima di essere memorizzato.
- 8
Punta il webhook verso di noi
Il pannello mostra un callback URL e un verify token nella stessa schermata. Copiali in Meta → la tua app → "WhatsApp" → "Configuration" → "Webhooks" → "Edit", poi premi "Manage" e iscriviti al campo
messages. - 9
Fai un test dal tuo telefono
Scrivi al tuo numero WhatsApp business da un telefono personale e chiedi qualcosa che l’assistente dovrebbe sapere. La risposta dovrebbe arrivare entro pochi secondi e la conversazione dovrebbe apparire in "Inbox".
WhatsApp consente messaggi in formato libero solo entro 24 ore dall’ultimo messaggio del cliente. Fuori da questa finestra serve un template di messaggio approvato — motivo per cui non esiste un pulsante "scrivi per primo al cliente".
Cosa succede dopo
Una volta approvato il nome visualizzato, il tuo numero si comporta come qualsiasi altro numero WhatsApp Business: i clienti gli scrivono e l’assistente risponde 24 ore su 24, nella loro lingua, dalla tua base di conoscenza. Meta ti fa partire con un limite giornaliero di messaggi basso e lo alza automaticamente man mano che gestisci conversazioni di qualità. Tieni d’occhio il quality rating nella dashboard di Meta — essere bloccati dai clienti è l’unica cosa che lo abbassa.
Altre guide
Preferisci che ce ne occupiamo noi?
Colleghiamo i canali, importiamo la tua base di conoscenza e mettiamo a punto il tono nelle tue lingue. Tu approvi il risultato.
Vedi la configurazione chiavi in manoAncora bloccato?
Scrivici su qualsiasi canale. Risponde una persona, di solito entro poche ore.