> For the complete documentation index, see [llms.txt](https://docs.idosgames.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.idosgames.com/start/telegram-mini-apps.md).

# 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 %}