Variabili dei template WhatsApp: {{1}} o parametri con nome

{
  "type": "BODY",
  "text": "Hi {{1}}! Your order {{2}} ships on {{3}}.",
  "example": { "body_text": [["Layla", "OM-4821", "12 November"]] }
}

{
  "type": "BODY",
  "text": "Hi {{first_name}}! Your order {{order_number}} ships on {{ship_date}}.",
  "example": {
    "body_text_named_params": [
      { "param_name": "first_name", "example": "Layla" },
      { "param_name": "order_number", "example": "OM-4821" },
      { "param_name": "ship_date", "example": "12 November" }
    ]
  }
}

Come invio i parametri nella chiamata API?

Inviate il nome del template, la lingua e un array components con i valori. Questa è la struttura per un template posizionale:

{
  "messaging_product": "whatsapp",
  "to": "971500000000",
  "type": "template",
  "template": {
    "name": "order_shipped",
    "language": { "code": "en" },
    "components": [
      { "type": "body", "parameters": [
        { "type": "text", "text": "Layla" },
        { "type": "text", "text": "OM-4821" },
        { "type": "text", "text": "12 November" }
      ] }
    ]
  }
}

Per un template con nome, ogni voce contiene anche parameter_name, che deve corrispondere al segnaposto:

{ "type": "text", "parameter_name": "order_number", "text": "OM-4821" }

Come funzionano i parametri multimediali dell’intestazione?

Un’intestazione multimediale non ha variabili di testo. Alla creazione, l’intestazione contiene un handle di asset di esempio ottenuto dal flusso di upload di Meta, e l’esempio viene rivisto insieme al template. All’invio passate l’asset, per esempio un’immagine tramite ID multimediale:

{ "type": "header", "parameters": [ { "type": "image", "image": { "id": "1558081531584829" } } ] }

L’ID qui sopra è l’esempio della documentazione di Meta, non un asset reale.

Com’è tramite l’API di OmniChannels.ai?

Il nostro endpoint sendbulk riceve il template come campi di modulo, secondo la documentazione dell’API WhatsApp:

Esempio pratico: un template di ordine spedito

“Souq Rafiq” (fittizio), un rivenditore degli EAU, vuole un aggiornamento di spedizione con l’immagine del prodotto e un pulsante di tracciamento.

1. Scrivete il template in modo che non inizi né finisca con una variabile: “Hi {{1}}, your order {{2}} has shipped and should arrive on {{3}}. Tap the button to follow it.”
2. Aggiungete l’intestazione come immagine, il piè di pagina come testo semplice e un pulsante URL https://shop.example/track/{{1}} con un esempio come OM-4821.
3. Inviate per la revisione con esempi realistici per ogni variabile, poi attendete lo stato di approvazione.
4. Inviate i messaggi con i tre valori del corpo, il suffisso di tracciamento e, se la sostituite, l’immagine dell’intestazione.

curl -X POST https://api.broadnet.me/whatsapp/message/sendbulk \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -F batchId=0 \
  -F campaignName=order-shipped \
  -F destinationNo=971500000000 \
  -F messageType=TEMPLATE \
  -F templateName=order_shipped \
  -F templateLanguage=en \
  -F bodyTemplateVariables=Layla \
  -F buttonsTemplateVariable=OM-4821

Questo frammento mostra i nomi dei campi per un singolo valore. Per più variabili del corpo per destinatario, usate un caricamento personalizzato invece di ripetere il comando. Confermate la codifica con il nostro team per la vostra prima campagna.

Come personalizzo un template da un CSV?

Usate una riga per destinatario e una colonna per variabile, poi caricatelo in un invio personalizzato.

1. Inserite il numero del destinatario in formato internazionale nella prima colonna. Vedi formato dei numeri di telefono E.164.
2. Aggiungete una colonna per ogni variabile e confermate la struttura delle colonne con il nostro team per la prima campagna.
3. Pulite prima i dati: eliminate gli spazi, correggete le maiuscole, usate un solo formato di data e rimuovete i valori vuoti, perché una variabile vuota produce un messaggio rotto o un invio non riuscito.
4. Controllate l’anteprima di più righe e inviate prima al vostro numero.

La pulizia dei dati è trattata in inviare SMS massivi da Excel o CSV; vale allo stesso modo per WhatsApp.

Come scelgo tra posizionale e con nome?

Decidete in base a quante persone toccheranno il template e a quante variabili ha.

1. Una o due variabili, un solo responsabile: il posizionale va bene ed è il predefinito.
2. Tre o più variabili, o più team che modificano i template: usate il formato con nome, così ogni segnaposto si spiega da solo.
3. Stessa formulazione in più lingue: mantenete gli stessi nomi o numeri in tutte le versioni, così una sola routine di invio può compilare ogni lingua.
4. Tenete sempre traccia di quale colonna di origine alimenta quale variabile, perché una modifica successiva al template non sposti i dati.

Prima di inviare per la revisione, leggete a voce alta il messaggio finito con i valori di esempio. Se suona innaturale, lo penseranno anche i revisori e i clienti.

Quali sono gli errori più comuni?

• Iniziare o finire con una variabile, che Meta indica come motivo di rifiuto.
• Saltare numeri o riutilizzare lo stesso numero fuori ordine in un template posizionale.
• Esempi segnaposto come “test”, che non dicono nulla ai revisori.
• Caratteri speciali come #, $ o % dentro le variabili.
• Ordine sbagliato all’invio in un template posizionale, che mette i dati giusti nel punto sbagliato.
• parameter_name non corrispondente in un template con nome.
• Usare una variabile per nascondere lo scopo reale del messaggio. Un template la cui categoria non corrisponde al contenuto può essere rifiutato o ricategorizzato; vedi la guida alle categorie.
• Limiti: questa guida riporta ciò che la documentazione di Meta afferma al momento della stesura. Le decisioni di revisione restano a Meta e le regole cambiano, quindi controllate le pagine collegate.

Come vi aiuta OmniChannels.ai

BroadNet è un Meta Business Solution Provider ufficiale. In OmniChannels.ai potete creare template WhatsApp con variabili, contenuti multimediali e pulsanti, vederne l’anteprima e seguire lo stato di approvazione, poi inviarli con valori personalizzati dall’API o da un caricamento Excel o CSV in una campagna. Sono inclusi il filtro dei duplicati e i rapporti di consegna. Consultate la pagina WhatsApp Business API e la piattaforma per le campagne.