Een template met variabelen verzenden

Hoe parameters worden gekoppeld

Op positie, niet op naam. De eerste parameter in de hoofdtekstlijst vult de eerste tijdelijke aanduiding, de tweede de tweede, enzovoort. Je kunt een variabele niet benoemen. Als je twee parameters omwisselt, wordt het bericht succesvol verzonden, maar staan de waarden op de verkeerde plaats.

Dat laatste geval is gevaarlijk, omdat er niets mislukt. Een klant ontvangt een orderbevestiging met de datum waar het bedrag hoort te staan, zonder dat ergens een fout wordt geregistreerd.

Componenten zijn aparte lijsten

Een variabele in de koptekst en een variabele in de hoofdtekst delen geen lijst. Elk component bevat eigen parameters. Als je ze samenvoegt, ontstaat een verschil in het aantal parameters.

• Koptekstparameters staan in een koptekstcomponent, waarvan er maximaal één is.
• Hoofdtekstparameters staan in een hoofdtekstcomponent, in de juiste volgorde.
• Parameters voor knop-URL's staan in een knopcomponent, geïndexeerd per knop.
• Eén vlakke lijst voor alle parameters geeft fout 132000 terug.

De juiste taal gebruiken

Een template wordt samen op basis van naam en taal geïdentificeerd. Dezelfde naam in twee talen betekent dus twee templates. Als je en verstuurt terwijl het template als en_US is aangemaakt, wordt niet teruggevallen op een andere taal. Het verzoek mislukt met fout 132001, die eruitziet alsof het template niet bestaat.

Maak een lijst van de templates op het nummer en kopieer de exacte taalreeks in plaats van de opbouw ervan aan te nemen. Dit is de meest voorkomende templatefout en de minst duidelijke.

Getypeerde parameters

De meeste parameters zijn gewone tekst. Sommige niet, en als je die als tekst verstuurt, mislukt het verzoek met fout 132012.

• Valutaparameters bevatten een bedrag, een valutacode en een terugvaltekst.
• Datum- en tijdparameters bevatten een gestructureerd object met een terugvalwaarde.
• Media-koptekstparameters bevatten een media-id of een link, geen bestandsnaam.
• De terugvaltekst wordt getoond als de app van de ontvanger de waarde niet kan opmaken.

Welke fout betekent wat

De drie fouten zijn van elkaar te onderscheiden. Dat voorkomt veel giswerk als je ze afzonderlijk registreert in plaats van ze samen te voegen tot één templatefout.

Fout 132001 betekent dat de combinatie van naam en taal niet kon worden gevonden. Controleer dus eerst de taal. Fout 132000 betekent dat het aantal niet klopt. Vergelijk dit met de eigen definitie van het template. Fout 132012 betekent dat het formaat van een waarde niet klopt. Meestal is dan een getypeerde parameter als gewone tekenreeks verstuurd.

Veelgemaakte fouten

• Aannemen dat en terugvalt op en_US. Dat gebeurt niet en de fout lijkt op een ontbrekend template.
• Koptekst- en hoofdtekstparameters samenvoegen tot één lijst. Het zijn aparte componenten.
• Een valuta of datum als gewone tekst versturen. Getypeerde parameters hebben een vast formaat.

Veelgestelde vragen

Lees verder