Risposta breve
Per inviare un messaggio WhatsApp tramite API, collegate un account WhatsApp Business tramite un partner Meta o la Cloud API di Meta, raccogliete l’opt-in e fate approvare un modello di messaggio (template). Inviate il template per avviare la conversazione. Dopo la risposta del cliente potete inviare testo libero, contenuti multimediali o messaggi interattivi entro la finestra di assistenza clienti di 24 ore.
Cosa serve prima del primo invio
- Un account WhatsApp Business (WABA), di solito creato tramite il flusso Meta Embedded Signup di un partner, con un numero di telefono aziendale verificato e un nome visualizzato.
- Almeno un template approvato nella categoria marketing, utilità (utility) o autenticazione (authentication).
- L’opt-in di ciascun destinatario, come richiedono le policy di Meta.
- Un accordo di fatturazione. Dal 1° luglio 2025 Meta addebita per messaggio consegnato in base a categoria e mercato del destinatario; consultate il listino Meta aggiornato.
Template o messaggio libero?
Dal 1° ottobre 2026 Meta addebita anche i messaggi di servizio e i template di utilità inviati dentro la finestra, dopo 1.000 messaggi di servizio gratuiti al mese per numero di telefono aziendale.
| Situazione | Cosa potete inviare |
|---|---|
| Siete voi ad avviare la conversazione | Solo un template approvato |
| Il cliente vi ha scritto nelle ultime 24 ore | Qualsiasi tipo di messaggio: testo, contenuti multimediali, interattivo o template |
| La finestra di 24 ore si è chiusa | Solo un template approvato |
| Invio di un codice monouso | Un template di autenticazione |
Passaggi per l’invio
- Create il template con nome, lingua, categoria e valori di esempio delle variabili, e inviatelo a Meta per la revisione.
- Attendete che lo stato del template sia approvato.
- Chiamate l’endpoint di invio con destinatario, nome del template, lingua e valori delle variabili.
- Salvate l’ID restituito, poi monitorate SENT, DELIVERED, READ o FAILED sul vostro webhook.
Esempio: invio di un template
Su OmniChannels.ai ogni messaggio WhatsApp passa da POST https://api.broadnet.me/whatsapp/message/sendbulk come multipart form data con un token Bearer. Impostate messageType su TEMPLATE e passate destinationNo, templateName, templateLanguage e bodyTemplateVariables. La chiamata restituisce un batchId e gli stati per destinatario arrivano sul vostro webhook o da GET /whatsapp/message/bulk-insights.