Quasi tutti i progetti di integrazione WhatsApp si impantanano nello stesso punto, e non è mai quello che i team mettono a budget. La messaggistica funziona il primo pomeriggio. A prendersi le settimane restanti è l'idraulica intorno: quale numero puoi usare, di chi è, dove vive la prova del consenso, su quale identità agganci i clienti e cosa deve sapere il tuo sistema di un orologio di 24 ore che non controlla.
Qui trovi cosa richiede davvero collegare la WhatsApp Business API a uno stack esistente: le decisioni costose da annullare, i vincoli che si comportano da problemi di ingegneria più che da policy, e i casi in cui non dovresti integrare affatto.
Il numero è un impegno, non un'impostazione
Un numero di telefono può essere collegato a un solo Business Solution Provider alla volta. Da questo singolo fatto discendono quasi tutte le decisioni iniziali.
Usa un numero dedicato che non sia già attivo su WhatsApp. Un numero che gira già l'app consumer o l'app WhatsApp Business va migrato, e migrare significa disservizio su quel numero. Portarci dentro il centralino principale senza pianificare è il modo in cui un team scopre il vincolo di lunedì mattina.
Aspettati un cancello di verifica prima dei volumi veri. La business verification nel Business Manager di Meta è ciò che ti fa superare il livello iniziale: finché non passa, sei limitato a un numero ridotto di destinatari unici al giorno, che va bene per i test e non serve a niente per una campagna. Avviala presto: richiede documenti societari e un sito verificabile, ed è il passaggio che più facilmente resta in attesa di qualcun altro.
Decidi di chi è l'asset. Se è il BSP a detenere il numero per tuo conto, uscire più avanti richiede portabilità, non un export. Chiedilo prima di firmare, non quando vuoi andartene. Le meccaniche del cambio stanno in come scegliere un BSP WhatsApp.
Il consenso è un record, non una spunta
Ogni integrazione ha bisogno di un posto dove vive l'opt-in, e dev'essere un record che potresti mostrare a qualcuno: chi ha acconsentito, quando, da quale superficie, a quale testo.
L'errore è salvare un booleano. Un booleano ti dice che il cliente è iscritto; non ti dice se puoi dimostrarlo, e non regge alla domanda sul canale — un consenso raccolto per l'email non si estende a WhatsApp. Conserva timestamp, sorgente e il testo esatto mostrato, e tienilo agganciato al contatto invece che in un log di invii form che nessuno può interrogare.
Le regole vere e proprie, e come le documenta un'azienda italiana sotto il GDPR, stanno nella guida all'opt-in WhatsApp.
Il problema di identità che nessuno mette in conto
WhatsApp è indicizzato sul numero di telefono. Quasi tutti gli stack e-commerce e i CRM sono indicizzati sull'email. Integrare i due significa decidere, esplicitamente, che cos'è un cliente.
I duplicati li trovi subito: la stessa persona come record solo-email e come record solo-telefono. Troverai numeri salvati in cinque formati diversi, alcuni senza prefisso internazionale, che non combaciano con niente finché non li normalizzi in E.164. E troverai clienti il cui numero WhatsApp non è quello dell'ordine.
Normalizza in scrittura, non in lettura, e decidi da subito se la chiave primaria di una conversazione è il numero o l'id del CRM. Farlo dopo qualche migliaio di conversazioni è una migrazione.
La finestra di 24 ore è un vincolo di ingegneria
I documenti di policy descrivono la finestra di assistenza come una regola. Nel tuo sistema si comporta come stato: quando un cliente ti scrive si apre una finestra, e finché è aperta puoi rispondere liberamente; quando si chiude, raggiungerlo di nuovo richiede un template pre-approvato, che costa e ha una categoria.
Vuol dire che la tua applicazione deve sapere se una finestra è aperta prima di decidere come inviare. I sistemi che saltano questo passaggio mandano tutto come template e pagano messaggi che potevano essere gratuiti, oppure tentano risposte libere che falliscono in silenzio. In entrambi i casi il bug è invisibile in dashboard finché non arriva la fattura.
Anche i template aggiungono stato: ognuno va sottoposto ad approvazione, e l'approvazione non è istantanea. Metti in coda con largo anticipo tutto ciò che ha una scadenza. Le meccaniche della finestra e dei tipi di messaggio stanno in la finestra di 24 ore e in WhatsApp Business API per il marketing.
Cosa torna indietro, e dove deve atterrare
Un'integrazione che sa solo inviare è costruita a metà. Decidi prima del lancio cosa riceve il resto dello stack:
Stato di consegna e lettura per messaggio, agganciato al cliente: altrimenti non distingui una campagna fallita da una impopolare.
I messaggi in entrata, instradati dove un essere umano li vede. È il requisito che i team sottovalutano: aprire un canale crea l'obbligo di rispondere.
La conversazione stessa, o almeno un riassunto, sulla scheda cliente. Gli operatori che non vedono cosa ha già detto l'assistente automatico lo contraddiranno.
Cosa si rompe al secondo mese
Il quality rating. Meta assegna al tuo numero un punteggio basato su come reagiscono i destinatari: blocchi e segnalazioni lo abbassano, e un punteggio basso ti taglia i limiti di invio. È il meccanismo che punisce le liste comprate e gli invii eccessivi, e degrada gradualmente invece di rompersi in modo rumoroso.
Il template rifiutato nel momento peggiore. Un template che suona come marketing ma è stato presentato come utility viene rifiutato o riclassificato, e la campagna che ci contava perde la finestra.
Nessuno che risponde. Il fallimento più comune è organizzativo, non tecnico: il volume in entrata arriva e non c'è un turno. Un WhatsApp senza risposta, per il cliente, è peggio di nessun WhatsApp.
Quando non integrare
Se i volumi mensili sono bassi e il caso d'uso è la conversazione uno-a-uno, l'app WhatsApp Business gratuita fa il lavoro e l'API è complessità che non ti serve. L'API si ripaga quando ti servono automazioni, più operatori sullo stesso numero o un collegamento ai dati d'ordine.
Se non hai nessuno da mettere sulla casella, non aprirla. Se la tua lista non è stata raccolta con un consenso per questo canale, non importarla: il quality rating ti troverà. E se l'unico obiettivo è il broadcast, verifica prima che i conti tornino: ogni messaggio iniziato dall'azienda ha un prezzo, ed è trattato in quanto costa la WhatsApp Business API.
L'ordine che funziona
Prima numero e verifica, perché hanno tempi di attesa esterni. Poi il record di consenso, perché la prova non si ricostruisce a posteriori. Terza la normalizzazione delle identità, prima che il volume di conversazioni la trasformi in una migrazione. Poi l'invio consapevole della finestra, poi i template, poi l'automazione. I team che invertono quest'ordine consegnano una demo in una settimana e passano un trimestre a renderla sicura da usare.
Per lo strato di concierge che si appoggia sopra, una volta che l'idraulica è a posto, guarda il WhatsApp AI Concierge di TikJoy.