# Template utility WhatsApp Un template utility fa seguito a un'azione già compiuta dal destinatario: un ordine, un pagamento, una prenotazione, un accesso. Il catalogo di Bird ne contiene otto, tra cui `bird_signin_alert` e `bird_delivery_update`. Ricava la categoria di uno slug dalla lista dei template, non dal nome: `bird_signin_alert` sembra un template di autenticazione ma non lo è, è utility. ## Prima di inviare Scegli un template dal catalogo gestito oppure creane uno sul tuo account business collegato. Inviare i template a catalogo precaricati di Bird non richiede alcuna verifica da parte tua, come per l'autenticazione. Neanche creare un template utility proprio ne richiede: a differenza dell'autenticazione, il requisito di verifica aziendale di Meta non si applica mai a utility, quindi puoi creare e modificare template utility su uno spazio di lavoro non verificato. Consulta [Verifica aziendale WhatsApp](/docs/knowledge-base/whatsapp/business-verification) per sapere cosa sblocca la verifica altrove. `to` può essere un numero di telefono E.164 o un ID utente con ambito aziendale. Un template utility non contiene un pulsante OTP, quindi non richiede il destinatario con solo numero di telefono previsto dall'autenticazione. Ogni template utility del catalogo gestito è registrato solo in `en`, con `on_missing_language: fail`. Richiedere una lingua non presente nel catalogo fa fallire l'invio anziché ripiegare sull'inglese o su qualsiasi altra lingua. ## Inviare un template utility `POST /v1/whatsapp/messages` con un oggetto `template` che indica uno slug del catalogo: **TypeScript** ```typescript const msg = await bird.whatsapp.send({ to: "+16505551234", template: { slug: "bird_order_confirmation", language: "en", components: [ { type: "body", parameters: [ { type: "text", name: "ref", text: "A1B2C3D4" }, { type: "text", name: "amount", text: "USD 49.99" }, ], }, ], }, }); console.log(msg.id, msg.status); ``` Examples: [TypeScript](/it-it/documentazione/guides/whatsapp/templates/utility.ts.md) · [Python](/it-it/documentazione/guides/whatsapp/templates/utility.py.md) · [Go](/it-it/documentazione/guides/whatsapp/templates/utility.go.md) · [PHP](/it-it/documentazione/guides/whatsapp/templates/utility.php.md) · [CLI](/it-it/documentazione/guides/whatsapp/templates/utility.cli.md) · [MCP](/it-it/documentazione/guides/whatsapp/templates/utility.mcp.md) · [cURL](/it-it/documentazione/guides/whatsapp/templates/utility.curl.md) Come per qualsiasi template gestito, ometti `from`: Bird sceglie il numero mittente in base alla categoria e alla regione, e impostarlo restituisce `422` [`E15018`](/docs/api/errors/E15018) `WhatsAppSenderNotAllowed`. Creare un template utility proprio e inviarlo funziona come qualsiasi invio con template personalizzato; consulta [Inviare con un template](/docs/guides/whatsapp/templates#sending-with-a-template) per il contratto generale. ## Compilare le variabili I parametri utility sono nominati, l'opposto del singolo codice posizionale dell'autenticazione. Ogni parametro ha un `name`, e l'ordine di un parametro nominato nell'array non ha alcun significato. Invia una voce `components` per ogni blocco che contiene effettivamente un segnaposto; un body senza variabili non richiede alcuna voce `components`. Un pulsante URL è l'unica eccezione: la sua variabile è sempre posizionale `{{1}}`, e l'invio contiene solo il valore anziché un indirizzo completo: ```json { "type": "button", "parameters": [{ "type": "text", "text": "A-4192" }] } ``` Per le regole condivise su componenti, `sub_type`, e su come i `components` di un invio si allineano ai segnaposto dichiarati di un template, consulta [Inviare con un template](/docs/guides/whatsapp/templates#sending-with-a-template) e [Componenti e parametri](/docs/guides/whatsapp/sending-whatsapp#components-and-parameters). ## Costo Un template utility consegnato all'interno di una finestra di assistenza clienti aperta può rientrare nella tariffa gratuita di Meta. La tariffa in uscita di Bird viene addebitata durante l'elaborazione del messaggio, prima dell'invio. Un successivo callback di consegna o lettura determina se si applica una tariffa Meta. Considera entrambe le componenti quando stimi il totale. Consulta [Costi e fatturazione](/docs/guides/whatsapp/sending-whatsapp#cost-and-billing) per sapere quando un invio viene addebitato e [Tariffe WhatsApp](/products/whatsapp/pricing) per le tariffe. ## Aspetti da tenere d'occhio - **Meta può ricategorizzare un template utility come marketing di propria iniziativa**, e il messaggio continua a essere inviato al nuovo prezzo più alto. Un'azienda che Meta ha già avvertito per errata categorizzazione non riceve più alcun preavviso da aprile 2025; la modifica si applica all'istante. Evita linguaggio promozionale, offerte o upsell nel testo di un template utility, perché è quello che provoca il cambio. Consulta [Linee guida per i template](/docs/knowledge-base/whatsapp/template-guidelines) per sapere cosa viene considerato promozionale. - **Un header `gif` o un pulsante `copy_code` viene rifiutato fuori da marketing.** Entrambi sono componenti riservati al marketing; dichiararli su un template utility causa un errore. - **Un invio con template personalizzato non viene verificato nel conteggio dei parametri prima dell'addebito.** Invia il numero sbagliato di parametri su un template tuo e il messaggio viene accettato e addebitato, poi rifiutato da Meta. Gli invii con template gestiti dal catalogo non hanno questo problema. - **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`. ## Prossimi passi - [Template WhatsApp](/docs/guides/whatsapp/templates): sfogliare il catalogo e il contratto condiviso per l'invio tramite template - [Template di autenticazione](/docs/guides/whatsapp/templates/authentication): codici di verifica monouso e il requisito di verifica per crearne uno - [Template di marketing](/docs/guides/whatsapp/templates/marketing): invii promozionali e l'account necessario per crearne uno ## 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)