Sign inGet started

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 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:
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);
Come per qualsiasi template gestito, ometti from: Bird sceglie il numero mittente in base alla categoria e alla regione, e impostarlo restituisce 422 E15018 WhatsAppSenderNotAllowed. Creare un template utility proprio e inviarlo funziona come qualsiasi invio con template personalizzato; consulta Inviare con un 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:
Esempio di codice
{ "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 e Componenti e parametri.

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 per sapere quando un invio viene addebitato e Tariffe WhatsApp 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 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 WhatsAppSenderWABAMismatch.

Prossimi passi