# 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%2Fgit-blob-e2516deda8bc911839483df17728de29b3f0f06d%2FScreenshot_89.png?alt=media" alt=""><figcaption><p>BO: Create a Telegram message</p></figcaption></figure></div>

📌 **Key Asset Configurations:**

* **Asset Name** – Used to identify and select the asset in campaigns.
* **Asset 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** - Select from sending a text message or one accompanied by an image.
* **Message** – The actual text of your message.
* **Button title** - The actual text of the button that the user will see.
* **Button deep link or URL -** Add interactive buttons to your messages, which can redirect users to the following:
  * specific URL (https\://)&#x20;
  * deep link (dp:) - seamless navigation to built-in gamification or specific integrated product screens or&#x20;
  * callback link (cb:) - Track engagement in the CRM without redirecting to any screen.

<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-494554bba926579e932d29811820eba6899f8e36%2Fimage.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.\
  If the message exceeds this limit, Telegram will automatically break it into separate parts.
* For Telegram messages accompanied by images, the caption limit is reduced to 1,024 characters.
  {% 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%2Fgit-blob-6400c92697c3dac5afa10575840ad8ed6ed6bac2%2Fimage.png?alt=media" alt=""><figcaption><p>BO: Telegram's content variations</p></figcaption></figure></div>
