Add your game to Telegram Mini-Apps

2 min read

Table of Contents

Create New Bot
Create New App
Server settings

To publish your game on Telegram Mini-Apps you need to Upload the WebGL build to the server and get the link.

To get started, you need to go to BotFather at the link.

Create New Bot #

And create a new bot, if you already have a bot, you can skip this step and move on to Creating New App.

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

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.

Be sure to add the parameter “?platform=telegram” at the end of the link to make all Telegram functions work in your game

https://mytggame.idos.games/index.html?platform=telegram

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

Now you have your own game in Telegram!

Server settings #

Now we need to get the Bot Token, to do this send:

/mybots

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

The received API Token must be inserted into the Environment Variables in the “_Telegram_BotToken” field

Once you have entered and saved “_Telegram_BotToken” you can register a Webhook for your bot in the Unity Editor.

Go to Unity in the menu Tools – iDos Games SDK – General Settings, in the Telegram Settings section fill in the Telegram Web App Link field