Setup

Collegare WhatsApp tramite la Meta Cloud API

Invia e ricevi WhatsApp direttamente da Meta (Cloud API), con il tuo numero e la tua app, come alternativa a Twilio. Modello BYO: il numero, il WhatsApp Business Account e l'app sono tuoi.

Modelli di messaggio

Dopo 24 ore senza risposta del cliente, WhatsApp non consente più il testo libero: per riprendere la conversazione serve un modello approvato. Create e gestite i modelli dentro il CRM, nella scheda WhatsApp in Impostazioni → Integrazioni — non serve passare dal Business Manager di Meta.

Fate clic su Nuovo modello e dite a cosa serve. Il nome tecnico si compila da solo (Meta accetta solo minuscole, cifre e trattino basso).
Scegliete la lingua e la categoria. Utilità per un messaggio che il cliente si aspetta, come un ordine o un appuntamento; Marketing per un'offerta. Meta esamina anche la categoria, e sbagliarla è un motivo frequente di rifiuto.
Scrivete il messaggio. Usate {{1}}, {{2}} per ciò che cambia da persona a persona, numerati in ordine e senza salti.
Compilate un esempio per ogni variabile. Meta lo richiede e rifiuta il modello senza — nessuno riceve quei valori, servono solo alla revisione.
Inviate in revisione. Il modello entra come in attesa e Meta di solito approva in pochi minuti; lo stato compare nell'elenco.

💡 Il CRM controlla il nome, la numerazione delle variabili e gli esempi mancanti prima di inviare qualsiasi cosa a Meta. Sono i tre rifiuti più comuni, e il messaggio di Meta per questi non dice cosa correggere.

Collega con un clic

Se in cima alla scheda compare il pulsante «Collega WhatsApp», usatelo: è la strada breve. Si apre una finestra Meta, scegliete (o create) l'account WhatsApp Business e il numero, e basta. Nessuna app da creare, nessun token da generare, niente da incollare. Funziona perché SellioCRM è un Tech Provider approvato da Meta: la connessione avviene sotto la nostra app invece che sotto una che dovreste costruire voi.

Il numero e l'account restano vostri. Potete disconnettere da Meta in qualsiasi momento e perdiamo l'accesso all'istante.
Non vediamo mai la vostra password di Facebook, e nessun nostro segreto arriva al vostro browser.
I messaggi restano fatturati da Meta sul vostro account.

💡 Se il pulsante non compare, la strada in un clic non è attiva per il vostro spazio e la configurazione manuale qui sotto è la via. Entrambe finiscono nello stesso posto: stesso invio, stessa casella, stessi modelli.

Configurazione manuale (app Meta propria)

Oltre a Twilio, puoi inviare e ricevere WhatsApp direttamente da Meta, utilizzando la Cloud API ufficiale. È un'alternativa: quando questa integrazione è attiva, WhatsApp passa attraverso Meta; gli SMS continuano a usare Twilio. Modello BYO (porti il tuo account): il numero, il WhatsApp Business Account (WABA) e l'app Meta sono tuoi, e i messaggi vengono fatturati sul tuo account Meta, senza alcun costo, margine o intermediazione da parte nostra.

L'integrazione parte inerte: non viene inviato nulla finché non compili i campi e attivi. Il token di accesso e l'app secret sono memorizzati cifrati nel CRM e non vengono mai mostrati di nuovo.

Prerequisiti

Un'app Meta (developers.facebook.com) con il prodotto WhatsApp aggiunto e un WhatsApp Business Account (WABA).
Un numero WhatsApp registrato sul tuo WABA e il relativo Phone Number ID (in WhatsApp > API Setup).
Un token di accesso permanente (consigliato: un System User in Business Manager) e l'App secret dell'app (in Impostazioni > Basic).
In Sellio, accesso da amministratore per salvare le credenziali e attivare l'integrazione in Impostazioni → Integrazioni.

Cosa devi compilare

Phone Number ID: l'identificatore del tuo numero WhatsApp presso Meta (è un ID, non il numero di telefono stesso).
WABA ID (facoltativo): l'ID del tuo WhatsApp Business Account, utile per la gestione e i modelli.
Versione Graph: la versione della Graph API da chiamare (es. v21.0). Se vuoto, usa quella predefinita.
Verify token: una stringa che scegli tu. Deve essere identica nel CRM e nel pannello Meta al momento della sottoscrizione del webhook.
Token di accesso: il token permanente che autorizza l'invio (memorizzato cifrato nel CRM).
App secret: il segreto dell'app, usato per verificare la firma dei webhook ricevuti (memorizzato cifrato nel CRM).

Come configurare

Apri Impostazioni → Integrazioni e trova la scheda "WhatsApp (Meta Cloud API)".
Compila il Phone Number ID, il Verify token (scegli una stringa), il Token di accesso e l'App secret; WABA ID e Versione Graph sono facoltativi. Clicca su "Salva credenziali".
Copia l'"URL webhook (Meta)" che appare. Nel pannello Meta, in WhatsApp → Configurazione → Webhook, incolla quell'URL nel campo Callback URL e lo stesso Verify token nel campo Verify token.
Sempre in Meta, sottoscrivi il campo "messages" per ricevere messaggi e stati.
Torna al CRM e clicca su "Attiva". Da quel momento, gli invii WhatsApp passano attraverso Meta.

Come inviare un messaggio

Apri un Contatto o Lead che abbia un telefono (campo Telefono o Cellulare).
Nel pannello "Messaggi (SMS/WhatsApp)", clicca su "Invia SMS/WhatsApp" e scegli il canale WhatsApp.
Verifica il numero, scrivi il messaggio e clicca su "Invia".
Il messaggio viene registrato nella cronologia del record. Le risposte del cliente arrivano tramite il webhook e appaiono nella stessa cronologia.

💡 Finestra di 24h e modelli: al di fuori della finestra di 24 ore dall'ultimo messaggio del cliente, Meta accetta solo messaggi TEMPLATE approvati. All'interno della finestra, il testo libero funziona. Crea e fai approvare i tuoi modelli nel pannello Meta.

Sicurezza: il CRM verifica l'X-Hub-Signature-256 di ogni webhook ricevuto usando il tuo App secret (una chiamata non firmata o con firma non valida viene rifiutata). Tratta il token di accesso e l'app secret come segreti: sono memorizzati cifrati e non vengono mai mostrati di nuovo.

Più numeri nella stessa app

Puoi avere più di un numero WhatsApp nella stessa integrazione (ad es. un numero USA come predefinito e un numero brasiliano per le conversazioni locali). Nella scheda dell'integrazione, aggiungili in "Numeri aggiuntivi" (Phone Number ID, WABA ID opzionale e un'etichetta) e salva. Quando avvii una conversazione, scegli il mittente in "Invia da"; le risposte dalla posta in arrivo escono automaticamente dal numero su cui è arrivata ogni conversazione. Il numero principale resta il predefinito.

Come testare

Apri un Contatto o Lead con un telefono e invia un breve messaggio WhatsApp a uno dei tuoi numeri.
Conferma che il messaggio sia arrivato al telefono e che sia stato registrato nella cronologia del record.
Rispondi dal telefono e verifica che la risposta appaia nella stessa cronologia (questo convalida il webhook in ingresso).

Risoluzione dei problemi

La verifica del webhook fallisce in Meta: il Verify token nel CRM e nel pannello Meta devono essere identici. Verifica che la Callback URL sia l'"URL webhook (Meta)" mostrato nella scheda.
Errore nell'invio: verifica il Phone Number ID e il Token di accesso. Un token scaduto o senza permesso WhatsApp fa sì che Meta rifiuti l'invio.
WhatsApp non invia fuori dalla finestra: usa un modello approvato. Il testo libero funziona solo entro la finestra di 24h.
Non ricevo risposte: nel pannello Meta, sottoscrivi il campo "messages" e conferma la Callback URL + Verify token.
Webhook rifiutato (403): l'X-Hub-Signature-256 non corrisponde. Reinserisci lo stesso App secret nel CRM (non viene restituito dal server).
Continua a passare da Twilio: l'integrazione Meta deve essere "Attivata". Senza attivarla, WhatsApp continua a usare Twilio.

Usare lo STESSO numero già presente nell'app WhatsApp Business

Puoi tenere il numero attivo nell'app del telefono e collegato al CRM allo stesso tempo — Meta lo chiama coesistenza. Il venditore continua a rispondere dal telefono e ogni messaggio inviato compare automaticamente nella conversazione del CRM. All'attivazione vengono importati fino a sei mesi di conversazioni precedenti.

Non lo attivi tu nel Business Manager: avviene tramite la procedura di collegamento del CRM e si conferma con un codice che arriva sul tuo WhatsApp.
L'app continua a funzionare normalmente: cambia solo che la conversazione viene registrata anche qui, sul contatto giusto.
L'importazione dello storico ha una scadenza: Meta concede 24 ore dopo l'attivazione. Tieni l'app aperta durante il processo — la schermata mostra l'avanzamento.
Se cambi telefono o registri di nuovo il numero, il collegamento cade e va rifatto. Il CRM ti avvisa quando succede.

💡 Cosa smette di funzionare nell'app con la coesistenza attiva: gruppi, chiamate voce e video, catalogo e ordini, messaggi di marketing e risposte rapide dell'app. Le liste broadcast esistenti diventano di sola lettura. Se qualcosa di questo ti è essenziale, usa un numero dedicato nel CRM e lascia l'app intatta.

Apri questo articolo dentro il sistema →