# Launching a new Telegram Mini App for Domino Quests

## 🚀 Getting Started with Domino Mini Apps

Domino makes it easy to launch Telegram Mini Apps for your community.\
This guide walks you through setting up your bot with **@BotFather** and connecting it to Domino.

***

### 📌 Chapter 1 – Create Your Telegram Mini App Bot

1. Open [@BotFather](https://t.me/BotFather) in Telegram.
2. Send the command:

   ```
   /newbot
   ```
3. Give your bot a **name** (e.g. *Concordium Quests*).
4. Choose a unique **username** ending with `bot` (e.g. *ConcordiumQuestsBot*).
5. Send:

   ```
   /newapp
   ```
6. Enter the **bot username** you just created.
7. Add a **title** (e.g. *Concordium Quests*).
8. Add a **description** (e.g. *Earn rewards by doing tasks!*).
9. Upload a **bot logo**.
10. For *App Short Name*, type:

    ```
    /empty
    ```
11. Enter your Domino Quests URL:

    ```
    https://[yoursubdomain].domino.page/quests
    ```
12. Add an **App Name** (e.g. *ConcordiumQuests*).

👉 Once done, copy your **Bot ID** and paste it into Domino:\
[Domino Portal → Settings](https://domino.run/portal/settings)

Screenshot guide of steps 1-12:

<div><figure><img src="https://1542229437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu8TrWRyvdpP97AjvHh9W%2Fuploads%2Fgit-blob-5f286e41d8b26d3b5c7a192e6d69284fe7cbe132%2FIMAGE%202025-09-01%20201502.jpg?alt=media" alt=""><figcaption></figcaption></figure> <figure><img src="https://1542229437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu8TrWRyvdpP97AjvHh9W%2Fuploads%2Fgit-blob-59cdbfb3272bcbfe31f6ef3332599c7694c134ec%2FIMAGE%202025-09-01%20201524.jpg?alt=media" alt=""><figcaption></figcaption></figure></div>

**Next, find your Telegram Bot ID: Using @raw\_data\_bot (Private Chat or Group)**

1. Open Telegram and in the global search bar, type @raw\_data\_bot and select the bot from the search results.
2. Send a message to the bot.
3. Add your bot to the chat
4. @raw\_data\_bot will return your Bot ID (Also called userid or bot chat ID)
5. 👉 Once done, copy your **Bot ID** and paste it into Domino:\
   [Domino Portal → Settings](https://domino.run/portal/settings)

<figure><img src="https://1542229437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu8TrWRyvdpP97AjvHh9W%2Fuploads%2Fgit-blob-462b8953425c4f2b52cbfc9af3d4fd7250d516b0%2F%3D.jpg?alt=media" alt=""><figcaption></figcaption></figure>

***

### 📌 Chapter 2 – Add the "Launch App" Button

1. In [@BotFather](https://t.me/BotFather), run:

   ```
   /mybots
   ```
2. Select your bot.
3. Go to **Bot Settings → Menu Button**.
4. Add your Domino Mini App URL:

   ```
   https://[yoursubdomain].domino.page/quests
   ```
5. Do the same under **Configure Mini App**.

After a few minutes, Telegram will display the **Launch App** button in your bot menu.

<div><figure><img src="https://1542229437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu8TrWRyvdpP97AjvHh9W%2Fuploads%2Fgit-blob-9cc0fe4052d0a2838e6888391f2ff49761e5e8ca%2FWhat%20do%20you%20want%20to%20do%20with%20the%20bot%20(1).jpg?alt=media" alt=""><figcaption></figcaption></figure> <figure><img src="https://1542229437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu8TrWRyvdpP97AjvHh9W%2Fuploads%2Fgit-blob-81006d403f2cc8b7bd1acfb7d0e41c036fe22925%2FIMAGE%202025-09-01%20201205%20(1).jpg?alt=media" alt=""><figcaption></figcaption></figure> <figure><img src="https://1542229437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu8TrWRyvdpP97AjvHh9W%2Fuploads%2Fgit-blob-155d3a2e2db8526db700826a61267cd341e994d7%2FSettings%20for%20%40Domino_Quests_demo_bot.%201618.jpg?alt=media" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
tip: You can find your subdomain here → [Domino Portal → Customize](https://domino.run/portal/customize)
{% endhint %}

<figure><img src="https://1542229437-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fu8TrWRyvdpP97AjvHh9W%2Fuploads%2Fgit-blob-bac07534695b0ec658980442cce6f7957b8b7c8c%2FCleanShot%202025-09-01%20at%2020.13.32%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

***

### 📌 Chapter 3 – Make `/start` Launch Your Mini App (Optional)

#### ✅ Step 1. Register the Mini App URL

1. In [@BotFather](https://t.me/BotFather):
   * `/mybots` → select your bot
   * Go to **Bot Settings → Edit Bot → Edit Commands**
   * Add:

     ```
     start - Launch the app
     ```
   * Ensure `/start` is visible in the **Bot Menu**

***

#### ✅ Step 2. Set the Mini App URL

1. In [@BotFather](https://t.me/BotFather):
   * Go to **Bot Settings → Edit Bot → Edit Menu Button**
   * Choose **Launch Web App**
   * Paste your Domino Mini App URL (must be HTTPS and whitelisted).

***

#### ✅ Step 3. Handle `/start` in Your Bot Code

If your bot has a backend, respond to `/start` with a **Launch Mini App** button:

```json
{
  "text": "Open Mini App",
  "reply_markup": {
    "inline_keyboard": [[
      {
        "text": "Launch",
        "web_app": { "url": "https://[yoursubdomain].domino.page/quests" }
      }
    ]]
  }
}
```

### 🎉 You’re Done!

You now have a fully connected Telegram Mini App powered by Domino.\
Users can launch your quests instantly from the bot menu or `/start`.