Variables de modèle WhatsApp : {{1}} ou paramètres nommés

{
  "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" }
    ]
  }
}

Comment envoyer les paramètres dans l'appel d'API ?

Vous envoyez le nom du modèle, la langue et un tableau components contenant les valeurs. Voici la forme pour un modèle positionnel :

{
  "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" }
      ] }
    ]
  }
}

Pour un modèle nommé, chaque entrée porte aussi parameter_name, qui doit correspondre à l'espace réservé :

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

Comment fonctionnent les paramètres d'en-tête média ?

Un en-tête média n'a pas de variable texte. À la création, l'en-tête contient l'identifiant d'un fichier d'exemple issu du processus d'envoi de Meta, et l'exemple est examiné avec le modèle. À l'envoi, vous passez le fichier, par exemple une image par identifiant de média :

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

L'identifiant ci-dessus est l'exemple de la documentation de Meta, pas un vrai fichier.

À quoi cela ressemble-t-il avec l'API OmniChannels.ai ?

Notre point de terminaison sendbulk reçoit le modèle sous forme de champs de formulaire, conformément à la documentation de l'API WhatsApp :

Exemple concret : un modèle de commande expédiée

« Souq Rafiq » (fictif), un détaillant des Émirats arabes unis, veut un suivi d'expédition avec une image du produit et un bouton de suivi.

1. Rédiger le modèle pour qu'il ne commence ni ne finisse par une variable : « Hi {{1}}, your order {{2}} has shipped and should arrive on {{3}}. Tap the button to follow it. »
2. Ajouter l'en-tête sous forme d'image, le pied de page en texte simple, et un bouton URL https://shop.example/track/{{1}} avec un exemple tel que OM-4821.
3. Soumettre avec des exemples réalistes pour chaque variable, puis attendre le statut d'approbation.
4. Envoyer avec les trois valeurs du corps, le suffixe de suivi et, si vous le remplacez, l'image d'en-tête.

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

Cet extrait montre les noms de champs pour une seule valeur. Pour plusieurs variables de corps par destinataire, utilisez un import personnalisé plutôt que de répéter la commande. Confirmez l'encodage avec notre équipe pour votre première campagne.

Comment personnaliser un modèle depuis un CSV ?

Utilisez une ligne par destinataire et une colonne par variable, puis importez le fichier dans un envoi personnalisé.

1. Mettez le numéro du destinataire au format international dans la première colonne. Voir format de numéro de téléphone E.164.
2. Ajoutez une colonne par variable, et confirmez la disposition des colonnes avec notre équipe pour votre première campagne.
3. Nettoyez d'abord les données : supprimez les espaces superflus, corrigez la casse, utilisez un seul format de date et retirez les valeurs vides, car une variable vide produit un message cassé ou un envoi en échec.
4. Prévisualisez plusieurs lignes et envoyez d'abord à votre propre numéro.

Le nettoyage des données est traité dans envoyer des SMS en masse depuis Excel ou CSV ; il s'applique aussi à WhatsApp.

Comment choisir entre positionnel et nommé ?

Choisissez selon le nombre de personnes qui toucheront au modèle et le nombre de variables.

1. Une ou deux variables, un seul responsable : le positionnel convient et c'est la valeur par défaut.
2. Trois variables ou plus, ou plusieurs équipes qui modifient les modèles : utilisez le nommé, pour que chaque espace réservé s'explique de lui-même.
3. Même texte en plusieurs langues : gardez les mêmes noms ou numéros dans toutes les versions, pour qu'une seule routine d'envoi remplisse toutes les langues.
4. Conservez toujours la correspondance entre colonne source et variable, pour qu'une modification ultérieure du modèle ne décale pas les données.

Avant de soumettre, relisez à voix haute le message terminé avec les valeurs d'exemple. S'il sonne faux, les relecteurs et les clients le penseront aussi.

Quelles sont les erreurs courantes ?

• Commencer ou finir par une variable, ce que Meta cite comme motif de rejet.
• Sauter des numéros ou réutiliser le même numéro dans le désordre dans un modèle positionnel.
• Exemples bidons comme « test », qui n'apprennent rien aux relecteurs.
• Caractères spéciaux comme #, $ ou % dans les variables.
• Mauvais ordre à l'envoi dans un modèle positionnel, qui met les bonnes données au mauvais endroit.
• parameter_name non concordant dans un modèle nommé.
• Utiliser une variable pour masquer la vraie finalité du message. Un modèle dont la catégorie ne correspond pas au contenu peut être rejeté ou recatégorisé ; voir le guide des catégories.
• Limites : ce guide rapporte ce que la documentation de Meta indique au moment de la rédaction. Les décisions de validation restent à Meta et les règles évoluent : vérifiez les pages citées.

Comment OmniChannels.ai vous aide

BroadNet est un fournisseur de solutions d'entreprise (Business Solution Provider) officiel de Meta. Dans OmniChannels.ai, vous pouvez créer des modèles WhatsApp avec variables, médias et boutons, les prévisualiser et suivre leur statut d'approbation, puis les envoyer avec des valeurs personnalisées depuis l'API ou depuis un import Excel ou CSV dans une campagne. Le filtrage des doublons et les rapports de livraison sont inclus. Consultez la page API WhatsApp Business et la plateforme de campagnes.