# Telegram Mini Apps

{% embed url="<https://www.youtube.com/watch?v=3HA_-nj1jcc>" %}

Before we add our Web3 game to **Telegram Mini Apps** you can [create a Web3 game in 1 minute](/start/quick-start-unity-sdk.md).

1. You need to go to [BotFather](https://t.me/botfather) to create a bot and app in Telegram.

<figure><img src="/files/IsziY9pyQYFdTM1qxB8j" alt=""><figcaption></figcaption></figure>

2. **Create New Bot**

To start you need to press the Start button or send:

```
/start
```

To create a new bot you need to send:

```
/newbot
```

Give your bot a name and send it to chat:

```
MyTgGame
```

Now we need to give username to the bot so it ends in “bot” and send:

```
MyTgGame_bot
```

Your bot has been created. Now you can move on to creating the app.

3. **Create New App**

To create a new web app you need to send:

```
/newapp
```

The app binds to a specific bot, you need to send its name with an **@** sign:

```
@MyTgGame_bot
```

Next, enter the name of the web application:

```
My Tg Game
```

After that, you need to enter a short description:

```
My Tg Game description
```

Next, you need to **send a picture** of your app with a strict resolution of **640×360 pixels.**

After that you need to upload the **GIF** or send it:

```
/empty
```

Now we need to paste the link to the game we got here, you need to copy the link belonging to the yellow **“Play Now Web Application”** button, which is in **Dashboard**

<figure><img src="/files/qfvAcNb5uvvgKOHgozr6" alt=""><figcaption></figcaption></figure>

Now please choose a short name for your web app: 3-30 characters, a-zA-Z0-9\_. This short name will be used in URLs like **t.me/MyTgGame\_bot/myapp** and serve as a unique identifier for your web app.

```
myapp
```

{% hint style="success" %}
Now you have your own game in Telegram!
{% endhint %}

3. **Server settings**

Now we need to get a Bot Token:

```
/mybots
```

Select your bot by clicking on the bot name and click **API Token.**

The obtained **API token** should be inserted into your [**Title Settings**](https://platform.idosgames.com/settings/integrations). To do this, go to **Settings** -> **Integrations** in the **menu**.

<figure><img src="/files/lHYH6bIbMUCJAeGEPWnN" alt=""><figcaption></figcaption></figure>

In the **Telegram** section there is a field **“Telegram Bot Token”**, there you need to insert your **API token** obtained from **@BotFather** and click **“Save Settings”** button.

After successfully saving the settings, click on the **“Register Telegram Webhook”** button.

And in **“Platform Settings”** under **“Telegram Mini Apps”**, change the **“Referral App Link”** field to the link of your Telegram game. This is necessary for the **referral link** to work correctly in your Telegram Mini App.

<figure><img src="/files/hFfYXznkxQKSy5soyy4P" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Congratulations! You now have a game in Telegram Mini Apps! Now you can set up advertising and start earning from your game!
{% endhint %}


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.idosgames.com/start/telegram-mini-apps.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.