Personalization

{{ name }} variables in SMS broadcasts and call campaigns

Insert the name, amount owed, appointment date and any other data right into the message text. Thousands of personal SMS in one request, not a thousand.

Try it free →

What variables are

A variable is a tag in double curly braces, for example {{ name }} or {{ debt }}. At the moment of sending, the system replaces it with each recipient’s personal value from your contact list.

You write one template, and each contact gets their own message. This sharply raises response rates: people read and act on personal SMS many times more often than on an impersonal “dear customer”.

One broadcast instead of a thousand requests

Before, 1000 personal SMS took 1000 sends. Now it takes one.

Without variables 1000 recipients = 1000 requests
  • A separate request for each one
  • Complex integration and loops
  • Risk of hitting limits
  • Slow and inconvenient
With variables 1000 recipients = 1 request
  • One template with tags
  • Data lives in the contact list
  • Automatic insertion
  • Fast and simple

Two ways to upload variables

With Excel in your dashboard or through the API. Pick whichever suits you

Upload from Excel

Prepare an .xlsx file. The first row holds headers: leave columns A and B empty, and starting from column C enter the variable names (green cells). From the second row on come the data: A is the number, B is a description, the rest are variable values.

A B C D
1 name debt
2 +77010000001 Ivan Ivanov Ivan 15000
3 +77010000002 Anna Petrova Anna 3200

The name and debt headers become the {{ name }} and {{ debt }} variables.

Upload via API

Pass variables in each contact’s variables field. You can create a list in advance with POST /lists, where contacts go in the numbers field. Or you can skip the list and pass contacts right in the broadcast request POST /bulks or the call campaign request POST /autocalls, in the list_id field, mixed with IDs of existing lists.

POST
/bulks
POST /bulks
{
  "name": "Reminder",
  "text": "Hello, {{ name }}! You owe {{ debt }} KZT.",
  "list_id": [
    { "number": "+77010000001",
      "variables": { "name": "Ivan", "debt": "15000" } },
    { "number": "+77010000002",
      "variables": { "name": "Petr", "debt": "3200" } }
  ]
}

All fields are described in the API documentation.

Where variables work

Personalize both text broadcasts and messages sent after a call campaign

SMS broadcasts

Insert the name, amount, order number, date and any data right into the text of a bulk broadcast. Ideal for payment reminders, order statuses and personal offers.

Call campaigns with SMS

If an SMS is sent after a call campaign (for example, to those who did not answer), variables work in its text too. A customer you could not reach gets a personal message with their name and details.

Personal broadcast examples

A few ready-made scenarios for different tasks

Debt reminder

{{ name }}, a reminder: you owe {{ debt }} KZT. Please pay by {{ date }}.

Order status

{{ name }}, order #{{ order }} is ready for pickup at {{ address }}.

Appointment reminder

{{ name }}, we expect you on {{ date }} at {{ time }}. Address: {{ address }}.

Naming rules

A few simple limits that keep everything working reliably.

  • A variable name may contain only Latin letters, digits and _ (for example name, order_id), up to 30 characters. The API rejects a name with Cyrillic letters or spaces with an error.
  • Spaces inside the braces don’t matter: {{ name }} and {{name}} work the same.
  • A variable value is a string of up to 255 characters. Cyrillic is supported.
  • If a contact has no value for a variable, the tag is replaced with an empty string.
  • SMS cost is calculated for the “worst case”, using the longest value. Keep in mind that Cyrillic shrinks a segment from 160 to 70 characters.

Variables FAQ

What are variables in an SMS broadcast?

They are tags like {{ name }} that are replaced with each recipient’s personal data on sending: name, amount, date, order number and so on.

Can I send personal SMS to thousands of recipients in one request?

Yes. Upload a list with variables and write one template with tags. The system fills in each contact’s data automatically and sends to everyone.

How do I upload variables?

Two ways: with an Excel file (column headers become variable names) or through the API in each contact’s variables field.

What happens if a contact has no value for a variable?

The tag is simply replaced with an empty string. The message still goes out, with no leftover {{ name }} gaps in the text.

Do variables work in automated calls?

Yes, in SMS messages sent after a call campaign (for example, to those who did not answer the call). The text of such an SMS supports variables too.

Do variables affect the cost?

Cost is calculated from the longest variable value across all contacts. Long values and Cyrillic can increase the number of SMS segments, and this is taken into account in the calculation.

Launch a personal broadcast now

Sign-up is free. Your first messages go out in a couple of minutes.

Sign up free →