# View: Telegram Mini App

With a Telegram Mini App, users interact with the  Enable3-powered experiences (Missions, Quests, Rewards, etc.) **within the Telegram interface** instead of a standalone website or mobile app.

{% hint style="success" %}
Telegram Mini Apps are especially effective as part of acquisition funnels built around community platforms such as:

* Telegram/Discord channels
* YouTube channels
* Influencer communities on social media platforms (e.g., Instagram)
* Third-party marketplaces (e.g., Etsy, Redbubble)

These environments already drive user attention and traffic. By connecting them to a Telegram bot, you can convert passive audiences into active participants in your engagement campaigns.
{% endhint %}

### Why Use Telegram Mini App

#### Case #1: You don’t have a dedicated app for your products/services 

**Problem**: You sell your products or services through an Etsy shop, Instagram page, or a Telegram channel. What matters is – you can’t add a loyalty widget to the app or webpage itself, but still want to engage with your customers better.

**Solution**: Enable the Telegram Mini App so your customers can participate in a loyalty program without downloading any additional apps.

**How it works**: You share a link to the Telegram bot with the customers, they interact with it, and open the loyalty widget inside the Telegram app.

**How to do it**: Configure the Telegram Mini App option in your Enable3 admin panel.

**Outcome**: You strengthen your customers’ loyalty, improve retention, and boost conversion by supplying them with an easy way to participate in your loyalty program.

#### Case #2: Your customers are active Telegram users

**Problem**: Your customers open their messaging app multiple times a day, every day. Your app? Not so much. 

**Solution**: Gently guide your customers toward your web or mobile app by getting them started with a loyalty campaign in an already familiar environment. Enable the Telegram Mini App so your customers can participate in a loyalty program without friction.

**How it works**: Share a link to the Telegram bot with the customers. They interact with it and open the loyalty widget inside the Telegram app. Customers get used to interacting with your brand, and are more likely to accomplish Missions tied to logging into your app if they see a clear motivation.

**How to do it**: Configure the Telegram Mini App option in your Enable3 admin panel.

**Outcome**: By meeting your customers where they are, you’ll strengthen your relationship with them. Afterwards, with cleverly configured Missions and Quests, you’ll be able to steer them in the direction of your own app or website.

#### 🎯 Telegram Mini App benefits

* No app installation required (runs directly inside Telegram) → **Low onboarding friction**
* Access through a familiar messaging environment users already open frequently → **Increased engagement frequency and higher repeat interactions**
* Bot links can be distributed instantly via Telegram channels, communities, and social media → **Faster campaign launch and broader reach without additional distribution infrastructure**
* Telegram bot handles communication while the Mini App handles interactive UI → **Ability to combine conversational messaging with complex loyalty mechanics** 
* Integration requires only connecting a bot API token instead of building a separate mobile product → **Reduced development cost and faster time-to-market** 
* Enable3 can host the Telegram server infrastructure by default → **Minimal operational workload for your team** 

### Telegram Mini App Capabilities

<details>

<summary>Widget-based experience inside Telegram</summary>

The Enable3 loyalty interface runs as a widget inside a Telegram Mini App opened through a Telegram bot. Users interact with Missions, Quests, Rewards, and campaigns without leaving the Telegram app.

</details>

<details>

<summary>Flexible hosting options</summary>

The Telegram Mini App can be deployed in two ways:

1. Enable3-hosted setup: fastest launch with minimal technical work
2. Self-hosted setup: run the Mini App infrastructure on your own server for full control

</details>

<details>

<summary>Automatic language detection</summary>

The Mini App automatically adapts to the language set in the user’s Telegram messaging app if this language is enabled in the Localization settings.

</details>

<details>

<summary>Audience segmentation</summary>

All Enable3 Segmentation capabilities remain available. Meaning, you can target different user groups with different campaigns.

<a href="../../segments" class="button secondary">Learn more about Segmentation</a>&#x20;

</details>

<details>

<summary>Telegram message templates</summary>

Predefined templates help structure Telegram bot messages and campaign flows.

</details>

<details>

<summary>Customization options</summary>

You can customize how the Widget will look inside Telegram (set your brand images and colors, choose the desired fonts, etc.), configure the loyalty mechanics and reward logic.

</details>

<details>

<summary>Testing environments</summary>

You can create testing environments in Enable3 to safely test Telegram campaign flows before launching them to production.

</details>

<details>

<summary>Bot appearance configuration via BotFather</summary>

Bot name, description, commands, and button naming are configured directly in Telegram using BotFather.

</details>

### How to Set Up a Telegram Mini App

1. **Ask your Enable3 contact to enable the Telegram Mini App feature for your account.**&#x20;

Once they do it, you’ll see the Telegram option appearing in your Basic Setup section under the View Type tab.

<figure><img src="https://2323683558-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SVK0eP2IwFbT1kSzOyQ%2Fuploads%2FD5nylIW5QvWLU7AIysU0%2Funknown.png?alt=media&#x26;token=ae854672-ecf3-4337-9ade-6447bc554dd6" alt=""><figcaption></figcaption></figure>

Click it to continue.

2. **Create a Telegram bot.**

Go to @BotFather in Telegram and create or select your bot.&#x20;

<figure><img src="https://2323683558-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SVK0eP2IwFbT1kSzOyQ%2Fuploads%2FVio9pxNZ8oGx4yVNL1xW%2Funknown.png?alt=media&#x26;token=306e420b-11f9-4bca-8782-579db001a395" alt=""><figcaption></figcaption></figure>

Go through the steps BotFather guides you through. At the end, you’ll receive an API token.

<figure><img src="https://2323683558-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SVK0eP2IwFbT1kSzOyQ%2Fuploads%2F3C5wiHvds2aVjQ1svy2J%2Funknown.png?alt=media&#x26;token=f9e1a746-f2ca-4043-bf1f-592d5b1813f6" alt=""><figcaption></figcaption></figure>

Copy the API Token generated by BotFather.&#x20;

3. **Configure Telegram Settings in the Enable3 Admin Panel.**

Go to the Basic Setup page, View Type section, then to Telegram Settings.

Paste the API token.

<figure><img src="https://2323683558-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SVK0eP2IwFbT1kSzOyQ%2Fuploads%2FFcJMZGOeaPzRelw7d6pP%2Funknown.png?alt=media&#x26;token=6aa26e05-ffb4-43f6-b5b3-64c76ce28ed9" alt=""><figcaption></figcaption></figure>

Click Save.

If the token is valid, the system will confirm a successful connection.&#x20;

4. **Choose a hosting mode.**

Here, you’ll have two options:

***Option A.*** Launch Telegram server (default). If you choose this option, Enable3 will host the Telegram Web App infrastructure. Meaning, you can just start using it right away – no additional setup needed.

Go to the BotFather’s menu and select your loyalty bot. There, you’ll be able to customize your bot – set the picture, name, description, welcome message, and more.

<figure><img src="https://2323683558-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SVK0eP2IwFbT1kSzOyQ%2Fuploads%2FX51OcdImzNFdtY00haBa%2Funknown.png?alt=media&#x26;token=42edc751-5da5-4472-a70c-76ee4fd11796" alt=""><figcaption></figcaption></figure>

After that, all you have to do is share the link to the bot with a user. After visiting the bot and clicking Start, the user will be able to open the Loyalty Widget inside Telegram.&#x20;

{% hint style="info" %}
The bot will default to the user’s name used in Telegram and the user’s set language.
{% endhint %}

<figure><img src="https://2323683558-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SVK0eP2IwFbT1kSzOyQ%2Fuploads%2FcmkJzgcGU3CmuAHaqS8u%2Funknown.png?alt=media&#x26;token=3f38c1f8-129e-4e1d-983e-6b7d6196abd1" alt=""><figcaption></figcaption></figure>

***Option B.*** Use my own server. If you choose this option, an additional field will appear, containing a URL used to retrieve an iframe for embedding the Mini App.&#x20;

<figure><img src="https://2323683558-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SVK0eP2IwFbT1kSzOyQ%2Fuploads%2FFL31VFTrHqLok1e0bpLK%2Funknown.png?alt=media&#x26;token=40425838-39cf-4166-a831-c8aa9e426fb7" alt=""><figcaption></figcaption></figure>

Copy the URL and click Save.

Now, open the BotFather’s menu and select your loyalty bot.

<figure><img src="https://2323683558-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SVK0eP2IwFbT1kSzOyQ%2Fuploads%2Fhmss8bXbhhZoB1TAHIfV%2Funknown.png?alt=media&#x26;token=fac9acc0-8efb-4457-b18a-a7d39b50fdae" alt=""><figcaption></figcaption></figure>

Under your loyalty bot’s Settings, go to the Mini Apps section.

<figure><img src="https://2323683558-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SVK0eP2IwFbT1kSzOyQ%2Fuploads%2FOIttWlHfy2czbKt8Vrsa%2Funknown.png?alt=media&#x26;token=e970f8fb-3431-4168-bcf2-db4933a034f2" alt=""><figcaption></figcaption></figure>

There, you can configure other ways for the user to open the Widget.

<figure><img src="https://2323683558-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SVK0eP2IwFbT1kSzOyQ%2Fuploads%2Fjak3JgLumEgnzHVFHIBu%2Funknown.png?alt=media&#x26;token=e86c18c3-15a8-43a6-8c2d-2c82c37ba95f" alt=""><figcaption></figcaption></figure>

If you enable the Menu Button, users will be able to open the Widget from the bot’s menu, without needing to click Open WIDGET.

<figure><img src="https://2323683558-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SVK0eP2IwFbT1kSzOyQ%2Fuploads%2FFE3D5qGpHUSlvd5vjWQa%2Funknown.png?alt=media&#x26;token=722b8cfd-2be1-4456-81d1-4a4b01999a34" alt=""><figcaption></figcaption></figure>

To enable the Menu Button, paste the copied URL in the provided field and configure the button’s name. Then, click Save.

<figure><img src="https://2323683558-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SVK0eP2IwFbT1kSzOyQ%2Fuploads%2FVdbmDSifPwuvb81IZ11t%2Funknown.png?alt=media&#x26;token=68c454d8-7f7c-444e-8788-f934caa4d949" alt=""><figcaption></figcaption></figure>

If you enable the Main App, they will be able to open the Widget right from the Telegram Chats section.

<figure><img src="https://2323683558-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SVK0eP2IwFbT1kSzOyQ%2Fuploads%2F8auUX79n7VHAylVc1TnW%2Funknown.png?alt=media&#x26;token=fa742703-422e-4153-88f5-cb4cb193340c" alt=""><figcaption></figcaption></figure>

To enable the Main App, paste the copied URL in the provided field and configure the launch mode’s settings. Then, click Save.

<figure><img src="https://2323683558-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SVK0eP2IwFbT1kSzOyQ%2Fuploads%2FVtS6dhM4H9sj5la5aEa3%2Funknown.png?alt=media&#x26;token=63715110-e36c-4ad8-8569-5d1f1784f927" alt=""><figcaption></figcaption></figure>

Congratulations, you’re all set!

<br>