Variables de modèle vs Variables personnalisées - Quelle est la différence ?

Updated 10 February 2026

C'est l'une des sources de confusion les plus courantes pour les utilisateurs de WhatChimp : quand devez-vous utiliser des Variables de modèle plutôt que des Variables personnalisées (Champs personnalisés) ? Les deux vous permettent de personnaliser les messages WhatsApp, mais elles fonctionnent de manières fondamentalement différentes.

Comprendre la différence est essentiel, surtout si vous utilisez l'API WhatChimp. Utiliser le mauvais type peut faire échouer vos messages ou afficher des données incorrectes.

Comparaison rapide

Variables de modèle

Les Variables de modèle sont des espaces réservés temporaires qui changent avec chaque message que vous envoyez. Elles ne sont stockées nulle part — vous fournissez la valeur à chaque fois.

Quand utiliser les Variables de modèle

Utilisez les Variables de modèle pour les informations qui sont :

• Uniques à chaque message (changent à chaque fois)
• Sensibles au temps ou à usage unique
• Ne valent pas la peine d'être stockées de façon permanente

Exemples :

• Codes OTP (expirent en quelques minutes)
• Numéros de confirmation de commande
• Heures de rendez-vous ou liens de réunion
• Numéros de suivi
• Montants de facture
• Jetons de réinitialisation de mot de passe

Où créer les Variables de modèle

Étape A. Allez dans Bot Manager > Message Template et sélectionnez votre bot.

Étape B. Faites défiler jusqu'à la section "Template Variables" (sous le corps de votre modèle).

Étape C. Définissez vos variables ici (par exemple, variable1, variable2).

Vidéo : Tutoriel Variables de modèle

Video: https://www.youtube.com/watch?v=R5jz8SkAM9I

Comment fonctionnent les Variables de modèle dans les modèles

Dans le corps de votre modèle WhatsApp (celui que vous soumettez à Meta), vous utilisez {{1}}, {{2}}, {{3}} comme espaces réservés :

Your OTP code is {{1}}. It will expire in {{2}} minutes.

When you send the message, you pass the actual values.

How Template Variables Work in the API

When sending a template message via API that uses Template Variables, you MUST include the variable values in your API call:

https://app.whatchimp.com/api/v1/whatsapp/send?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID&phone_number=919999999999&template_name=otp_verification&language_code=en_US&variable1=123456&variable2=5

The API Console automatically generates these variable1=, variable2= placeholders for you when you select your template in the generator.

Custom Variables (Custom Fields)

Custom Variables — also called Custom Fields — are permanent data points stored on each subscriber's profile. Once you set them, they stay there until you update or delete them.

When to Use Custom Variables

Use Custom Variables for information that is:

• Persistent (doesn't change often)
• Applicable to the contact, not the message
• Reusable across multiple messages

Examples:

• Full name
• Company name
• Email address
• Country or city
• Industry or job title
• Customer tier (Gold, Silver, Bronze)
• Account manager name

Where to Create Custom Variables

Step A. Go to Subscriber Manager > Manage Custom Fields.

Or navigate directly to: /whatsapp/subscriber/manager/custom-field/list

Step B. Click Create and define your field name (e.g., company_name, country, email).

Step C. Set these fields on your subscribers using:

• The Subscriber Manager UI (manual entry)
• CSV import
• The WhatChimp Subscriber API

Video: Custom Variables Walkthrough

Video: https://www.youtube.com/watch?v=yd1O0Sd_zDQ

How Custom Variables Work in Templates

When creating your template in WhatChimp, you insert Custom Fields using the "Custom Fields" dropdown (NOT the "Variables" dropdown).

In your WhatsApp template body, they appear as:

Hi {{first_name}}, your company {{company_name}} has been verified!

How Custom Variables Work in the API

This is the critical difference: When you send a template via API that uses Custom Variables, you do NOT pass the variable values in the API call.

https://app.whatchimp.com/api/v1/whatsapp/send?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID&phone_number=919999999999&template_name=special_offer&language_code=en_US

Notice: No variable1= parameters. The system automatically pulls the custom field values from the subscriber's stored data.

Important: You must set these custom field values on the subscriber BEFORE sending the message. If the subscriber doesn't have a value for company_name, that part of the message will be blank or show an error.

Which Should You Use?

Ask yourself: "Will this data change every time I send a message to this person?"

• Yes → Use Template Variables (e.g., OTP codes, order numbers)
• No → Use Custom Variables (e.g., name, company, email)

Can You Use Both?

Yes! You can combine both in the same template:

Hi {{first_name}}, your order {{1}} will arrive on {{2}}.

• {{first_name}} is a Custom Variable (pulled from subscriber data)
• {{1}} and {{2}} are Template Variables (you pass variable1=ORD-123 and variable2=Feb 10 in the API)

How This Affects the API

This is where most developers get confused. The API behavior is completely different for each type.

Template Variables in API Calls

You MUST pass values using variable1=, variable2=, etc.

curl "https://app.whatchimp.com/api/v1/whatsapp/send?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID&phone_number=919999999999&template_name=order_update&language_code=en_US&variable1=ABC123&variable2=Feb%2015"

If you forget to include the variable parameters, your message will fail or show blank placeholders.

Custom Variables in API Calls

You do NOT pass values. The system pulls them from the subscriber's profile.

curl "https://app.whatchimp.com/api/v1/whatsapp/send?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID&phone_number=919999999999&template_name=special_offer&language_code=en_US"

Before sending, you must set the custom fields on the subscriber using the WhatChimp Subscriber API:

curl -X POST "https://app.whatchimp.com/api/v1/whatsapp/subscriber/update" \
  -d "apiToken=API-KEY" \
  -d "phone_number_id=PHONE-NUMBER-ID" \
  -d "phone_number=919999999999" \
  -d "custom_fields[company]=Acme Corp" \
  -d "custom_fields[country]=United States"

See the WhatChimp Subscriber Management API for the full reference on assigning custom fields.

Common mistake: Developers try to pass custom field values as variable1=, variable2= dans l'API de message de modèle. Cela ne fonctionne pas. Les champs personnalisés sont extraits des données de l'abonné, pas des paramètres de l'appel API.

Tutoriels vidéo

Regardez ces tutoriels vidéo étape par étape par Anant (fondateur de WhatChimp) :

Variables de modèle

Video: https://www.youtube.com/watch?v=R5jz8SkAM9I

Variables personnalisées (Champs personnalisés)

Video: https://www.youtube.com/watch?v=yd1O0Sd_zDQ

Articles connexes

• Envoyer des messages de modèle avec des variables via l'API WhatChimp
• Envoyer des messages de modèle via l'API WhatChimp
• API de gestion des abonnés WhatChimp
• Comment gérer les champs personnalisés et les étiquettes
• Commencer avec l'API développeur WhatChimp