Inviare un template con variabili
Le variabili dei template sono posizionali, non nominate. Devi inviare una lista di parametri per componente, nell'ordine corretto, e il numero deve corrispondere esattamente a quello definito dal template. Tre errori diversi derivano da questo problema e ciascuno indica uno sbaglio specifico.
L'errore quando il numero di parametri non corrisponde al template.
L'errore quando il formato dei parametri non corrisponde.
L'errore quando nome e lingua del template non vengono risolti.
Come vengono associati i parametri
In base alla posizione, non al nome. Il primo parametro nella lista del corpo riempie il primo segnaposto, il secondo riempie il secondo e così via. Non puoi assegnare un nome a una variabile: scambiare due parametri produce un messaggio inviato correttamente, ma con i valori nei posti sbagliati.
Questo è il caso più pericoloso, perché non si verifica alcun errore. Un cliente riceve una conferma d'ordine con la data al posto dell'importo e non viene registrato alcun errore.
I componenti sono liste separate
Una variabile dell'header e una del corpo non condividono la stessa lista. Ogni componente contiene i propri parametri e unirli causa un errore nel numero di parametri.
- I parametri dell'header vanno in un componente header, che può essere al massimo uno.
- I parametri del corpo vanno in un componente body, nell'ordine corretto.
- I parametri dell'URL del pulsante vanno in un componente button, indicizzato per pulsante.
- Inviare un'unica lista piatta per tutti restituisce l'errore 132000.
Usare la lingua corretta
Un template è identificato insieme dal nome e dalla lingua, quindi lo stesso nome in due lingue corrisponde a due template. Inviare en quando il template è stato creato come en_US non attiva alcun fallback: la richiesta fallisce con l'errore 132001, che indica che il template non esiste.
Elenca i template del numero e copia la stringa della lingua esatta invece di presumerne il formato. È l'errore più comune con i template e quello meno descrittivo.
Parametri tipizzati
La maggior parte dei parametri è semplice testo. Alcuni non lo sono e inviarli come testo causa l'errore 132012.
- I parametri di valuta contengono un importo, un codice valuta e una stringa di fallback.
- I parametri di data e ora contengono un oggetto strutturato con un fallback.
- I parametri media dell'header contengono un ID media o un link, non un nome file.
- La stringa di fallback viene mostrata se l'app del destinatario non riesce a formattare il valore.
Cosa significa ogni errore
I tre errori sono distinguibili. Questo evita molte supposizioni se vengono registrati separatamente invece di essere raggruppati come un unico errore del template.
L'errore 132001 significa che la coppia nome e lingua non è stata risolta, quindi controlla prima la lingua. L'errore 132000 significa che il numero è errato, quindi confrontalo con la definizione del template. L'errore 132012 significa che il formato di un valore è errato, di solito perché un parametro tipizzato è stato inviato come semplice stringa.
Errori comuni
- Presumere che en faccia fallback su en_US. Non succede e l'errore indica che manca il template.
- Unire i parametri dell'header e del corpo in un'unica lista. Sono componenti separati.
- Inviare una valuta o una data come testo semplice. I parametri tipizzati hanno una struttura definita.
EasyCoexistence elenca i template con i nomi esatti e i codici lingua nel dashboard e tramite il connettore MCP, così l'invio usa i valori realmente memorizzati da Meta.
Domande frequenti
Le variabili dei template hanno un nome?
No. Sono posizionali, quindi l'ordine dei parametri è l'intero contratto.
Perché il mio template non esiste?
Di solito a causa del codice lingua. Un template è identificato da nome e lingua insieme e non esiste alcun fallback.
Cosa succede se invio troppi parametri?
Errore 132000. Troppi parametri causano lo stesso errore di un numero insufficiente.
Come invio un importo?
Come parametro di valuta con importo, codice valuta e stringa di fallback, non come testo semplice.
Continua a leggere
Pronto per iniziare?
Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.
Inizia la prova gratuitaVerificato il