Skip to main content
This article walks you through everything you need to send Telegram campaigns from Maestra using Fasttrack as the messaging provider — from the initial connection to creating templates, building campaigns, and tracking results.

​
In this article

​
Connecting Telegram

  1. Create an account in Fasttrack — the service used to deliver messages to messengers.
  2. In Maestra, create a custom field to store Telegram identifiers for your customers.
  3. Go to Settings → Campaigns → Connections and add a new connection for Telegram.
  4. Fill in every field in the connection settings:
    • Brand — select the brand you need. This matters for multi-brand projects.
    • Provider — Fasttrack.
    • Recipient contact — choose the custom field you created in step 2.
  5. To finish the setup, select the bot in Fasttrack and save the connection.
  6. Enable the Notifications and Messengers module.
The Notifications and Messengers module must be active on your project before Telegram campaigns can be created or sent. If it isn’t enabled, ask your account manager to turn it on.

​
Settings in Fasttrack

​
Click tracking

For clicks to be recorded in Maestra, enable link shortening in Fasttrack under Settings → System settings. Without this option turned on, click-throughs from your Telegram messages will not flow back into Maestra reporting.

​
Creating templates

In Fasttrack, create templates for each type of message you plan to send: text only, text with an image, text with a button, and so on. Here is an example of how to build a template that contains text, an image, and a button.
  1. In the Fasttrack interface, open the Constructor → Node group tab and go to Campaign templates.
  2. Add a new template.
  3. Enter a name for the template. You’ll need this name later when you set up the campaign in Maestra. Click Create message.
  4. Fill in the body of the template. Mark every variable part of the message (text, image URL, button URL, and so on) with a placeholder — the values for these placeholders will be substituted in from Maestra when the campaign is sent. Use the following syntax for variables: 
    {{ get_params.* }}
    • Text and image — use Markdown formatting (see the Markdown syntax section below).
    • Button — add the button element and reference variables for both the button label and the destination URL.
  5. Save every element in the constructor before leaving the screen.
Build a separate template for each message structure you expect to use (plain text, text + image, text + button, text + image + button). Reusing well-named templates makes it much easier to maintain Telegram campaigns over time.

​
Creating a campaign in Maestra

Once your template exists in Fasttrack, you can use it to create and send campaigns from Maestra.
  1. Go to the Campaigns section.
  2. Click Create campaign and choose the campaign type — bulk or automated.
  3. Select the Telegram channel, pick a folder, and click Create.

​
Message

Fill in the message section as follows:
  • Sender — created automatically when you add the provider.
  • Template name — copy the template name exactly as it appears in Fasttrack.
  • Template parameters — fill these in if your Fasttrack template uses variables:
    • Key — the name of the variable (the part after get_params.).
    • Value — the content that should replace the variable in the outgoing message. You can use template engine parameters and Markdown formatting in the value.
The template name in Maestra must match the name in Fasttrack character-for-character. A mismatch will prevent the message from being assembled and sent.

​
Sending the campaign

The delivery flow works the same way as in every other channel:
  • Bulk campaigns — pick the recipients and launch the campaign immediately or schedule it for a later date.
  • Automated campaigns — these are sent from flows after the campaign has been moved to the Ready for use status.

​
Who can receive Telegram messages?

A customer can receive a Telegram message only if their messenger identifier is filled in. Always add a check for the presence of this identifier in your segment or flow conditions. When a customer blocks the bot, every future message to them will fail with the undelivered reason Number not supported by provider. You can use this event to identify those customers and exclude them from future campaigns. Keep in mind that a customer may later unblock the bot — in that case, they should automatically become eligible to receive your campaigns again, so build your segments so they re-enter the recipient list once delivery becomes possible. Example: build a segment that includes customers who have a Telegram identifier filled in and whose last Telegram message did not fail with the “not supported by provider” reason.

​
After the send

Customer interaction with the campaign is tracked through delivery statuses. The Telegram channel reports the following statuses:
  • Sent — the message was accepted by the provider and delivered.
  • Not sent — the message could not be sent (for example, the recipient has no Telegram identifier).
  • Undelivered — the provider attempted delivery but it failed (for example, the bot was blocked).
You can use these statuses in segments, filters, and reports just like you would for any other channel.

​
Markdown syntax

Telegram messages use basic Markdown for formatting. You can apply Markdown both when you build the template in Fasttrack and when you fill in variables in the Maestra campaign. The basic formatting options are:
ElementSyntax
Image![](image-url)
Image with caption text in the same message![text](image-url)
Link inside text[link text](destination-url)
Bold*text*
Italic_text_
Monospace`text`
Example 
*Hello, {{ customer.firstName }}!*

Check out our new arrivals: [Shop now](https://example.com/new)

_Free shipping on orders over $50._
This produces a message with bolded greeting, an inline link, and an italicized note about free shipping.