# TMA (Telegram Mini App)

## What is Telegram Mini Apps (TMA)

[Telegram Mini Apps](https://core.telegram.org/bots/webapps) is an open platform for businesses to build and deploy web-apps right into Telegram. Like bots, **Mini Apps** support seamless authorization.

## Directual TMA plugin

Directual TMA plugin allows you to deploy your Directual-based web-app to Telegram, send notifications via bot, and use seamless authorization for your users.

### Step 1. Install free TMA plugin from the Marketplace in your Directual app

<figure><img src="https://3071851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4Nnmtk9_gFGWOddsf6%2Fuploads%2FBUCqp4y326MPzfB2BZCB%2Fplugin.webp?alt=media&#x26;token=14d2c77c-115e-492b-b99d-9af04fa29ea5" alt=""><figcaption></figcaption></figure>

There are two settings for the TMA plugin:

<figure><img src="https://3071851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4Nnmtk9_gFGWOddsf6%2Fuploads%2F172V1U2tvlx3QaRHJ6Rk%2Fplugin2.webp?alt=media&#x26;token=5c3a593a-a2d0-401b-b045-d6aeba2c6c10" alt=""><figcaption></figcaption></figure>

* **Auto log in.** `True`: authorises users automatically when they open TMA' `False`: user pushes the button "Log in with Telegram" when open TMA. The latter is used when you want to let your users to authorise in TMA with email, Google, etc.
* **Disable registration**. `True`: user can't log in if there is no `WebUser` with such an ID. `False`: the `WebUser` will be created automatically when user logs in.

{% hint style="warning" %}
If user is signed up with TMA and then wants to log in on the web-browser, he'll need a pair `username/password.` You can generate the one-time password and send the login credentials to the user in Telegram bot.
{% endhint %}

### Step 2. Deploy your Directual app to Telegram

Open [BotFather](https://t.me/BotFather) and create new bot (skip this if you already have a Telegram bot) using command `/newbot`

<figure><img src="https://3071851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4Nnmtk9_gFGWOddsf6%2Fuploads%2FNMV4UI5y1LrN3G1wOJbN%2Fbotfather1.webp?alt=media&#x26;token=ff73029c-194e-49d6-8073-1c7f62518c00" alt=""><figcaption></figcaption></figure>

Then, deploy your Directual-based app as a webapp to that bot using command `/newapp`. Follow the BotFather instructions.

<div><figure><img src="https://3071851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4Nnmtk9_gFGWOddsf6%2Fuploads%2FZz2BXAZDInqhZ9ZtUDI0%2Fbf2.webp?alt=media&#x26;token=7c7c9066-2baf-4ae0-871c-55533af4b32a" alt=""><figcaption></figcaption></figure> <figure><img src="https://3071851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4Nnmtk9_gFGWOddsf6%2Fuploads%2F0XyIgrF7QXWoyqDnpoO1%2Fbf4.webp?alt=media&#x26;token=1a5628e8-ab8c-4434-b32d-fc5800e6d9a1" alt=""><figcaption></figcaption></figure></div>

Success! Let's test it out! Pay attention, that authentication happens automatically if the user gets to the login page.

<figure><img src="https://3071851461-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4Nnmtk9_gFGWOddsf6%2Fuploads%2FRvKZuzQoHqqqXGB4mn8s%2Flive_demo.gif?alt=media&#x26;token=18c13d4c-b65b-441d-a9a3-8111e2df374f" alt="" width="288"><figcaption></figcaption></figure>


---

# 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://readme.directual.com/plugins/using-plugins/user-authentication-plugins-not-web3/tma-telegram-mini-app.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.