> For the complete documentation index, see [llms.txt](https://help.smartico.ai/welcome/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smartico.ai/welcome/products/crm-automation/communication-channels/telegram.md).

# Telegram

Telegram is a highly effective communication channel for player retention, even when users are offline. You can deliver timely and impactful messages through real-time or scheduled campaigns, driving consistent engagement.\
Telegram messages will be delivered through **1-1 personal channels (using a bot)**, exclusively between you and the recipient. This enables you to send specific messages tailored to the individual needs and interests of each user.

Check how to setup a Telegram chat bot here:

{% embed url="<https://help.smartico.ai/welcome/products/crm-automation/activities-of-flows/activity-telegram-bot>" %}

### Creating & Managing Telegram asset

Before sending any Telegram messages in a campaign, you must first create an asset (resource).

**📌 Where to create a Telegram asset?**

* Navigate to the Marketing tab in the BO (Back Office).
* Go to the Assets section, select Instant Messages click on Create and choose Telegram from the drop down

<div data-with-frame="true"><figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2FpGng0sdenXKbYriH0eOU%2Fr2-037-crop-1-2fce422c-cfe560.png?alt=media" alt=""><figcaption><p>BO: Create a Telegram message</p></figcaption></figure></div>

📌 **Key Asset Configurations:**

* **Name** – Used to identify and select the asset in campaigns.
* **Status** – Can be Active, Draft, or Archived.

{% hint style="danger" %}
**Important:** If an asset is in Draft or Archived status but is already used in a campaign, the communication <mark style="color:green;">**will still be sent.**</mark> However, variations within the asset that are in Draft or Archived status <mark style="color:red;">**will not be sent**</mark> in campaigns.
{% endhint %}

* **Content type** - You can select from **Text/HTML** for simple text or web links, **Image & Text/HTML** for static photos with text, **Video & Text/HTML** for playable video files, or **Animation GIF & Text/HTML** for short, looping silent visuals accompanied by text.
* **Message** – The actual text of your message. You can use these HTML tags: `<b>`, `<strong>`, `<i>`, `<em>`, `<u>`, `<ins>`, `<s>`, `<strike>`, `<del>`, `<a>`, `<code>`, `<pre>` and `<blockquote>`. The Back Office does not save a message with any other tag.

You can configure up to 5 buttons in the **Reply buttons** section:

* **1st Button title** … **5th Button title** - The actual text of the button that the user will see.
* **1st Button deep link or URL** … **5th Button deep link or URL** - Add interactive buttons to your messages. Configure up to five buttons per message. Each button can redirect users or trigger an action using one of these formats:
  * **Direct web URL (`https://`):** Redirects users to an external website, promotional page, or deposit screen. For example, `https://yourbrand.com/promotions`. Enter standard web URLs directly. Do not add a `dp:` or `dp:go&url=` prefix.
  * **Gamification deep link (`dp:`):** Seamlessly navigates users to internal Smartico gamification widgets or sections. For example, `dp:gf_missions`, `dp:gf_store`, `dp:gf_tournaments`, or `dp:saw`.
  * **Callback link (`cb:`):** Records interaction and engagement in the CRM. It does not open a browser or navigate away from the chat. For example, `cb:claim_offer` or `cb:confirm_optin`. Use callback links to branch Journey campaign flows from button clicks.
  * **Telegram Mini App (`web_app:`):** Opens a web page inside Telegram as a Mini App. For example, `web_app:https://yourbrand.com/promotions`. Smartico always opens the page over `https://`.

<div data-with-frame="true"><figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2F7LYicQ41lPLSTOCZqZF9%2Fr2-038-crop-2-b82aa6fb-bf4d71.png?alt=media" alt=""><figcaption><p>BO: General setup of Telegram message</p></figcaption></figure></div>

{% hint style="info" %}
Telegram messages have the following character limits:

* Telegram messages can include up to 4,096 characters.\
  Smartico does not split a longer message into parts, and Telegram does not deliver it. Keep the text, with personalization tags resolved, under this limit.
* For Telegram messages with an image, a video or a GIF, the text is a caption. The Back Office allows up to 1,024 characters, but Smartico sends only the first 1,000 characters of a caption (HTML tags count as characters here). Keep captions shorter than that.
  {% endhint %}

### **Buttons action in Campaigns**

When setting up buttons for the Telegram message, make sure to link them within the Journey flow while creating the campaign. You need to define the outcome for any button click to ensure that the user engagement is completed.

{% hint style="warning" %}
**If you're setting a CAP limit for Telegram, note that** in rare cases, CAP limits might be slightly exceeded if multiple messages are scheduled close together. This happens because the system checks CAPs based on messages already sent so if a previous message is still in the queue, the check may temporarily allow another one through.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fgit-blob-b5b0c4b1ebbba16c59ca5c48bac8d9dd7bc214ac%2Fimage.png?alt=media" alt=""><figcaption><p>BO: Telegram buttons connections in Campaigns</p></figcaption></figure></div>

### Personalized Content with Content Variations

You can tailor content based on the end user's profile using Content Variations. This feature allows you to present different offers based on user segmentation, such as level, language, currency, country, or other customizable properties.

💡 How It Works:

* Configure the properties you want to use (e.g., Language, Level, Currency, Country).
* Create different content variations tailored to specific user segments.
* Once the asset is added to a campaign, end users will receive the most relevant variation based on their profile and matching conditions.

<div data-with-frame="true"><figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fnxha1YKD3t7IwwF7Yndb%2Fr2-039-crop-4-94e9450a-16c8d2.png?alt=media" alt=""><figcaption><p>BO: Telegram's content variations</p></figcaption></figure></div>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.smartico.ai/welcome/products/crm-automation/communication-channels/telegram.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.