# 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](https://bird.com/pricing/whatsapp) e [Costi e fatturazione](/docs/guides/whatsapp/sending-whatsapp#cost-and-billing) 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](/docs/guides/whatsapp/phone-number-setup).
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](/docs/knowledge-base/whatsapp/template-guidelines) 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**](https://bird.com/dashboard/w/whatsapp/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:

| Valore        | Significato                                                                    |
| ------------- | ------------------------------------------------------------------------------ |
| **Eligible**  | Meta accetterebbe una richiesta di onboarding per questo account               |
| **Onboarded** | L'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](https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/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à](https://developers.facebook.com/documentation/business-messaging/whatsapp/marketing-messages/features) 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](/docs/guides/whatsapp/message-log). 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](/docs/guides/whatsapp/opt-outs) per ambito e copertura.

## Prossimi passi

- [Linee guida per i template](/docs/knowledge-base/whatsapp/template-guidelines): le regole in base alle quali Meta esamina un template di marketing
- [Template WhatsApp](/docs/guides/whatsapp/templates): navigazione, stati e lettura del contenuto di un template tramite API
- [Invio di messaggi WhatsApp](/docs/guides/whatsapp/sending-whatsapp): indicare un template e un mittente in un invio
- [Qualità del numero e limite di messaggi](/docs/knowledge-base/whatsapp/number-quality-and-messaging-limit): l'effetto del volume di marketing sulla valutazione di un numero

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/products/whatsapp) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)