# Template marketing WhatsApp Un template di marketing veicola contenuti promozionali, come un'offerta, l'annuncio di un prodotto o un coupon. Prima di inviare, prepara contenuti approvati, il consenso del destinatario e un modo chiaro per gestire le risposte e le revoche del consenso. ## Prima di inviare Il catalogo gestito di Bird non contiene alcun template marketing, quindi un invio marketing usa sempre un template creato dal tuo spazio di lavoro, su un WhatsApp Business Account di tua proprietà: 1. Collega un WhatsApp Business Account e un numero di tua proprietà. Vedi [Configurazione del numero di telefono](/docs/guides/whatsapp/phone-number-setup). 2. Crea un template con categoria `marketing` e invialo per la revisione. Vedi [Linee guida per i template](/docs/knowledge-base/whatsapp/template-guidelines) per i criteri di approvazione. 3. Invia da un numero sullo stesso WhatsApp Business Account del template. `from` è obbligatorio per un invio marketing, e un mittente su un account diverso viene rifiutato `422` [`E15023`](/docs/api/errors/E15023) `WhatsAppSenderWABAMismatch` prima di qualsiasi addebito. ## Invio di un template marketing `POST /v1/whatsapp/messages` con `from` impostato e un oggetto `template` che indica il tuo slug: **TypeScript** ```typescript const msg = await bird.whatsapp.send({ to: "+16505551234", from: "+13125550101", template: { slug: "summer_sale", language: "en", components: [ { type: "header", parameters: [{ type: "image", url: "https://cdn.example.com/banners/summer.png" }], }, { type: "body", parameters: [{ type: "text", name: "first_name", text: "Pablo" }] }, { type: "button", parameters: [{ type: "text", text: "SUMMER25" }] }, ], }, }); console.log(msg.id, msg.status); ``` Examples: [TypeScript](/it-it/documentazione/guides/whatsapp/templates/marketing.ts.md) · [Python](/it-it/documentazione/guides/whatsapp/templates/marketing.py.md) · [Go](/it-it/documentazione/guides/whatsapp/templates/marketing.go.md) · [PHP](/it-it/documentazione/guides/whatsapp/templates/marketing.php.md) · [CLI](/it-it/documentazione/guides/whatsapp/templates/marketing.cli.md) · [MCP](/it-it/documentazione/guides/whatsapp/templates/marketing.mcp.md) · [cURL](/it-it/documentazione/guides/whatsapp/templates/marketing.curl.md) - **I parametri del body sono nominati**, come per utility. Ogni parametro porta un `name`, e l'ordine nell'array non ha alcun significato. - **Il codice di un pulsante coupon è un normale parametro `text`**, come quello sul pulsante qui sopra. Non esiste un tipo di parametro separato per i codici coupon. - **Un header `gif` richiede un parametro `gif`**, non `video` o `image`. Marketing è l'unica categoria che accetta un header con GIF animata. - **I valori di un carosello vanno su `cards`, non su `parameters`**, e l'invio deve fornire esattamente il numero di card con cui il template è stato approvato. Bird instrada automaticamente ogni invio marketing verso l'API Marketing Messages di Meta; non devi attivarlo e non esiste un'opzione per singolo invio. Lo stato di onboarding dell'account business con quell'API condiziona le ottimizzazioni di Meta, non la consegna in sé, con un'eccezione: un header `gif` richiede un account che ha completato l'onboarding, altrimenti l'invio fallisce a WhatsApp. Vedi [Template marketing](/docs/knowledge-base/whatsapp/marketing-templates) per lo stato dell'account, cosa sblocca l'onboarding e dove il marketing è limitato per paese. ## Rinunce Quando Bird riceve da Meta un evento valido di interruzione del marketing, registra una preferenza del destinatario per quell'account business. Questa preferenza è separata da una soppressione di tutti i messaggi. Controlla entrambi i record prima di inviare. Un errore di consegna può arrivare prima dell'evento di preferenza corrispondente: preserva la scelta del destinatario e indaga quello storico invece di riprovare. Consulta [Revoche del consenso](/docs/guides/whatsapp/opt-outs) per la registrazione e la lettura di questi record. ## Costi Usa la tariffa di marketing pubblicata per la destinazione e la valuta. Bird addebita la propria commissione in uscita prima dell'invio; un esito di consegna o lettura fatturabile può aggiungere la commissione di Meta. Consulta [Costi e fatturazione](/docs/guides/whatsapp/sending-whatsapp#cost-and-billing) e [Tariffe WhatsApp](/products/whatsapp/pricing). ## Aspetti da tenere d'occhio - **Meta ricategorizza verso marketing, mai da marketing ad altre categorie, e questo comporta un cambio di prezzo.** Un template che Meta ritiene promozionale nella sostanza diventa `marketing` qualunque categoria tu abbia indicato, e l'invio continua a uscire al nuovo prezzo, più alto. Non c'è possibilità di rinuncia né modo di ripristinare la categoria; l'unico rimedio è un nuovo template. - **`131049` è una pausa nella consegna, non una limitazione di frequenza configurata da te, e riprovare peggiora la situazione.** Meta segnala `131049` sia per la sua pausa generale negli USA sia per un limite marketing per utente, e la sua stessa indicazione è di attendere circa un giorno prima di reinviare. Reinviare prima può rendere l'account non disponibile per quel destinatario più a lungo e altera il tuo tasso di consegna. Bird segnala l'errore come `rate_limited`. - **`131050` significa che il destinatario ha disattivato "Offers and announcements", e non va mai riprovato.** Meta accetta l'invio e poi rifiuta di consegnarlo. La risposta corretta è il percorso delle preferenze di messaggistica, non un reinvio: blocca tu stesso gli invii al destinatario oppure attendi che riabiliti la consegna, cosa che Bird apprende tramite lo stesso meccanismo di preferenze che ha segnalato la rinuncia. Vedi [Rinunce](/docs/guides/whatsapp/opt-outs). - **`132015` e `132016` indicano la sospensione del template, non un problema del destinatario.** `132015` è una pausa per bassa qualità; `132016` è la disabilitazione permanente dopo sospensioni ripetute, e l'unico rimedio è un nuovo template con contenuto diverso. Controlla lo stato della singola lingua anziché quello del template, poiché una lingua sospesa blocca immediatamente l'invio. - **Un mittente sul WhatsApp Business Account sbagliato viene rifiutato prima di qualsiasi addebito.** `from` deve trovarsi sullo stesso account del template, altrimenti l'invio fallisce `422` [`E15023`](/docs/api/errors/E15023) `WhatsAppSenderWABAMismatch`. ## Passi successivi - [Template WhatsApp](/docs/guides/whatsapp/templates): consultare il catalogo e il contratto condiviso di invio tramite template - [Template marketing](/docs/knowledge-base/whatsapp/marketing-templates): l'API Marketing Messages, lo stato di onboarding e dove il marketing è limitato - [Rinunce](/docs/guides/whatsapp/opt-outs): registrazione e consultazione di soppressioni e preferenze - [Template utility](/docs/guides/whatsapp/templates/utility): aggiornamenti sugli ordini, promemoria per appuntamenti e notifiche sull'account ## 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)