How to personalize template message broadcasts using Global Variables and Custom Attributes

You can personalize a broadcast by inserting {} variables in your approved template, so every recipient sees their own name, email, or any custom value when the message is sent.

How variables work in ChatMaxima

ChatMaxima supports two kinds of variables you can drop into a broadcast: Global Variables (system fields ChatMaxima already knows about each contact) and Custom Attributes (fields you define yourself, such as company name, order ID, or appointment date).

In any supported input field, simply type { and a picker appears listing every Global Variable and Custom Attribute available to you. Select the one you want and ChatMaxima inserts it in the correct {variable_name} format.

What are Global Variables?

Global Variables are built-in system fields. They start with the sys_ prefix and are resolved automatically at send time. You do not need to create or maintain them. The supported Global Variables are:

• {sys_account_contact_name}, the name of the contact associated with the chatbot session.
• {sys_account_contact_email}, the email address of the contact interacting with the chatbot.
• {sys_account_contact_mobile}, the mobile number associated with the contact's account.
• {sys_contact_reference_id}, the reference id for the current conversation.
• {sys_current_message}, the current message being processed in a bot.
• {sys_account_platform}, the current platform processed in a bot (for example, WhatsApp, Facebook, Telegram).
• {sys_current_date_time}, the current date and time at the moment of execution.
• {sys_current_page_url}, the URL of the webpage where the chatbot is currently active.
• {sys_current_conversation}, the complete conversation history including messages and timestamps.
• {sys_ai_intent}, the detected intent from the user's query in MaxIA blocks (for example, general_query, human_agent, booking_request).
• {sys_current_media}, the URL, type, and filename of the most recent media (image, video, audio, document) uploaded by the user as a JSON object. Use {sys_current_media.url} or {sys_current_media.type} for specific fields.

What are Custom Attributes and how to create them

Custom Attributes are fields you define for your own business needs, anything that is not covered by the Global Variables. Common examples are company_name, order_id, appointment_date, plan_type, or account_manager.

To create a Custom Attribute:

1. Go to Dashboard → Contacts and open the Attributes section.
2. Click Add Attribute, enter the attribute name (use lowercase with underscores, for example company_name) and choose its data type.
3. Save the attribute. It is now available across the platform.
4. Populate the value for each contact, either manually from the contact profile, in bulk through a CSV import, or automatically through a bot block, API call, or integration.

Once a Custom Attribute exists, it shows up in the same { picker alongside Global Variables.

How to use variables in a Broadcast

1. Open Dashboard → Campaigns → Create Broadcast.
2. Select the WhatsApp channel and choose your approved template.
3. The template's placeholders (such as {{1}}, {{2}}) are listed for you to map.
4. In each placeholder field, type { to open the picker and select the Global Variable or Custom Attribute you want, for example {sys_account_contact_name} for the recipient's name.
5. Select your audience, schedule the broadcast, and send. At send time, ChatMaxima replaces each variable with the matching value for each individual contact.

Example

If your approved template is:

Hello {{1}}, your order {{2}} has been confirmed.

Map {{1}} to {sys_account_contact_name} and {{2}} to your custom attribute {order_id}. Each recipient will then receive a fully personalized message such as "Hello Priya, your order ORD-1042 has been confirmed."

Important note about template approval

Before you can create a Broadcast, the template must first be created and approved by Meta. While creating the template you can only use Meta's placeholder format ({{1}}, {{2}}, and so on) along with sample values. Global Variables and Custom Attributes are mapped into those placeholders only during the broadcast step, not while drafting the template for approval.

Notes

• If a contact is missing a value for a variable (for example, no mobile saved), the placeholder will be blank, so keep your contact data clean before sending.
• Variable names are case-sensitive and must be wrapped in single curly braces, like {sys_account_contact_name}.
• The same { picker works in bot builder blocks, auto replies, and message templates, not just in broadcasts.