Variables {{1}} / {{nom}}

Les 5 règles de variables : positionnel ou nommé, exemples requis, comptes exacts. La cause n°1 de rejet.

Variables de template

Important — La cause n°1 de rejet Meta
La quasi-totalité des rejets de template concernent les variables. Respectez ces cinq règles et votre template passe la revue sans accroc.

1. Positionnel OU nommé — jamais les deux

Positionnel : {{1}}, {{2}}, {{3}}… — numéroté, commençant à 1, sans trou ( {{1}} {{3}} est invalide).
Nommé : {{nom}}, {{order_id}}… — lettres, chiffres et _ uniquement. Meta les met en minuscules.
Mélanger les deux dans un même corps ( « Bonjour {{1}}, commande {{order_id}} » ) est rejeté.

2. Une valeur d'exemple par variable — REQUIS

Meta revoit le template avec des exemples réalistes. example_values doit contenir au moins autant d'entrées que le corps a de variables, dans le même ordre. Positionnel : mappe sur {{1}}, {{2}}… ; nommé : mappe sur l'ordre d'apparition des variables.

3. Les comptes doivent correspondre

2 variables ⇒ 2 valeurs d'exemple. Moins ⇒ 400 renvoyé par nous (avant même l'appel Meta) ; plus ⇒ ignoré.

4. Pas de {{}} vide ni d'accolade orpheline

5. Les valeurs à l'envoi doivent aussi correspondre

Lors du POST /v1/messages, template.variables doit fournir une valeur par variable, dans le même ordre — sinon Meta rejette l'envoi (#132000).

Exemples valides et invalides

// OK positionnel
{ "body_text": "Bonjour {{1}}, votre commande {{2}} est confirmée.", "example_values": ["Marc", "CMD-1043"] }

// OK nommé
{ "body_text": "Bonjour {{nom}}, votre commande {{order_id}} est confirmée.", "example_values": ["Marc", "CMD-1043"] }

// KO styles mélangés  -> 400 "Ne mélangez pas … numérotées … et nommées …"
{ "body_text": "Bonjour {{1}}, commande {{order_id}}", "example_values": ["Marc", "CMD-1043"] }

// KO trou dans la numérotation  -> 400 "… de {{1}} à {{2}} sans trou …"
{ "body_text": "Bonjour {{1}}, commande {{3}}", "example_values": ["Marc", "CMD-1043"] }

// KO exemple manquant  -> 400 "Le corps a 2 variable(s) — fournissez une valeur d'exemple pour chacune"
{ "body_text": "Bonjour {{1}}, commande {{2}}", "example_values": ["Marc"] }

Astuce — Nous validons en amont
Nous vérifions ces règles avant d'appeler Meta et renvoyons un 400 précis (ex. « Le corps a 2 variable(s) — fournissez une valeur d'exemple pour chacune »), pour vous éviter de brûler un cycle de revue.