Documentazione
Sign inGet started
Inizia ora
Guide
Riferimento API
SDK
CLI
Knowledge Base
Changelog

Template di marketing

Ogni template WhatsApp appartiene a una delle tre categorie di Meta: authentication, utility o marketing. Marketing è quella promozionale, ed è l'unica categoria che Meta instrada attraverso una seconda API. Gli invii di marketing passano per le Marketing Messages API di Meta, mentre tutte le altre categorie passano per la Cloud API, sullo stesso numero di telefono.
La categoria determina anche il prezzo. Un template di marketing ha il costo della tariffa marketing per il paese del destinatario, indipendentemente da quale delle due API lo trasporta. Le tariffe sono nella pagina dei prezzi WhatsApp e Costi e fatturazione spiega quando viene addebitata ogni parte di un invio.

Cosa serve per inviarne uno

Il nostro catalogo gestito contiene solo template di autenticazione e utility, quindi un invio di marketing usa sempre un template creato dal tuo spazio di lavoro:
  1. Collega un WhatsApp Business Account di tua proprietà, perché un template che crei viene registrato sul tuo account e non sul nostro. Vedi Configurazione del numero di telefono.
  2. Crea un template con la categoria marketing e invialo per la revisione. Meta esamina la categoria insieme al contenuto e ricategorizza un template che è promozionale nella sostanza. Linee guida per i template descrive cosa supera la revisione.
  3. Invia da un numero sull'account che detiene il template. Un template appartiene a un singolo WhatsApp Business Account, quindi un invio che indica un numero su un account diverso viene rifiutato prima di raggiungere Meta.

Marketing Messages API sull'account business

Apri Numbers, seleziona un numero e apri il relativo account business per vedere cosa riporta Meta sull'account da cui il numero invia. La riga Marketing Messages API è lo stato di onboarding dell'account:
ValoreSignificato
EligibleMeta accetterebbe una richiesta di onboarding per questo account
OnboardedL'account ha completato l'onboarding e i suoi invii marketing sono ottimizzati
La riga è assente finché Meta non ha comunicato un valore. È un dato del provider memorizzato, non un controllo di idoneità in tempo reale. Bird aggiorna periodicamente i metadati degli account collegati; ritardi ed errori possono lasciare singoli campi più vecchi dell'ultima lettura riuscita. Conferma l'onboarding in WhatsApp Manager quando un invio dipende da esso.
Meta accetta le condizioni una sola volta per un intero portfolio business, quindi il pannello mostra anche un secondo stato a livello di portfolio: not_started, request_sent o term_of_service_signed. Meta assegna a entrambi i campi lo stesso nome ma due vocabolari diversi. Leggi la riga dell'account per l'idoneità e la riga del portfolio per l'avanzamento nell'accettazione delle condizioni.
L'onboarding avviene su Meta, non nella dashboard di Bird. Una persona con pieno controllo del portfolio business accetta le condizioni delle Marketing Messages API in WhatsApp Manager, sotto Overview > Accept terms to get started. La guida all'onboarding di Meta contiene i passaggi aggiornati.

Invio prima che l'account abbia completato l'onboarding

Il percorso di invio include il product_policy di CLOUD_API_FALLBACK di Meta, consentendo ai messaggi di marketing idonei di usare la Cloud API mentre l'onboarding delle Marketing Messages API è incompleto. La categoria marketing determina comunque la tariffa applicabile. Questo fallback non aggira le restrizioni su destinatario, account o contenuto e non garantisce la consegna. I formati che richiedono le Marketing Messages API, incluse le intestazioni GIF, richiedono comunque l'onboarding.

Funzionalità aggiuntive e impostazioni di invio

Meta offre funzionalità aggiuntive di ottimizzazione e misurazione del marketing per account e mercati idonei. Verifica le funzionalità disponibili per il tuo account nel confronto delle funzionalità di Meta prima di far dipendere un lancio da esse. L'onboarding da solo non dimostra che ogni funzionalità di ottimizzazione o reportistica sia attiva per ogni destinatario.
L'attuale percorso di invio di Bird seleziona le Marketing Messages API per i template di marketing e include CLOUD_API_FALLBACK. Non fornisce limiti di ottimizzazione per singolo invio, override delle funzionalità creative dei template, configurazione della misurazione delle conversioni o configurazione dei deep link Android. Non dare per scontato che queste impostazioni siano configurate perché un template è stato approvato.
Quando Meta riporta la categoria di prezzo marketing_lite, Bird la mappa sulla categoria tariffaria marketing. Consulta il costo riportato del messaggio e i record di fatturazione per l'addebito effettivo; un messaggio inviato e un messaggio consegnato hanno trigger di addebito diversi.

Verifica le restrizioni su destinazione e destinatario

L'idoneità al marketing può variare per paese del destinatario, account, formato e limiti per destinatario di Meta. Verifica le restrizioni attuali nella documentazione di Meta e in WhatsApp Manager per le destinazioni della tua campagna. Il paese di un numero business non implica che tutti i destinatari previsti possano ricevere template di marketing.
L'errore Meta 131049 è riportato da Bird come rate_limited. Esamina i dettagli del provider, l'idoneità della destinazione e i limiti per destinatario prima di riprovare. Non trattare un invio accettato o un template approvato come prova dell'idoneità del destinatario e non reinviare ripetutamente un messaggio soggetto a restrizioni.

Quando un destinatario interrompe i messaggi di marketing

WhatsApp offre a ogni destinatario un controllo Offers and announcements sul profilo della tua attività. Scegliere Not interested alimenta i limiti per utente di Meta, e bloccare del tutto la consegna impedisce i tuoi template di marketing lasciando inalterati i messaggi di utility e autenticazione.
Un rifiuto del provider può riportare l'errore Meta 131050. Leggi il codice del provider in last_error.meta_error_code insieme all'errore normalizzato di Bird e al registro dei messaggi. Quando Bird ha già una preferenza di opt-out applicabile, può rifiutare il messaggio prima della consegna al provider. Esamina la scelta registrata del destinatario prima di riprovare.
Quando Bird riceve un evento di stop valido da Meta, registra una preferenza di origine destinatario, non transazionale, con ambito limitato al WhatsApp Business Account. Questa va nella scheda Preferences, non nella lista Suppressions. Un evento di ripresa aggiorna quella preferenza; i blocchi indipendenti restano attivi. Controlla entrambe le schede e la cronologia degli eventi prima di aggiungere una soppressione separata per tutti i messaggi. Un rifiuto del provider può arrivare prima che la preferenza corrispondente sia registrata. Vedi Opt-out per ambito e copertura.

Prossimi passi

Risorse correlate

Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.

Guarda la guidaConnecting WhatsApp to Bird: from buying a number to a live channelComprendi il concettoWhat is the 24-hour customer service window on WhatsApp?Usa lo strumentoWhatsApp message builderEsplora la funzionalitàWhatsApp
Prova l'esercitazione e ottieni un brief di implementazione