> For the complete documentation index, see [llms.txt](https://docs.fstrk.io/knowledge_base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fstrk.io/knowledge_base/telegram/tg-miniapp/integraciya-sobstvennogo-mini-app-v-telegram-s-chat-botom.md).

# Интеграция собственного Mini App в Telegram с чат-ботом

Для настройки взаимодействия чат-бота в Telegram с вашим приложением достаточно выполнить несколько простых шагов. Давайте рассмотрим процесс поэтапно:

#### 1. **Добавление кнопки с ссылкой на приложение в чат-бот**

Чтобы пользователи могли открыть ваше приложение из чат-бота Telegram, вам нужно добавить соответствующее сообщение с кнопкой в сценарий чат-бота на платформе Fasttrack. Кнопка в сценарии будет содержать URL адрес вашего приложения.

**Важно!** Не используйте ссылку вида `t.me`, так как она не будет работать. Вместо этого укажите прямой адрес URL страницы приложения.

#### 2. **Передача данных о пользователе из приложения в чат-бот**

Для того, чтобы передавать данные из вашего приложения в чат-бот, используйте API-метод. 

**URL API**:

```
POST https://dashboard.fstrk.io/api/partners/push-messages/
```

**Заголовки запроса**:

```
Content-Type: application/json
bot-key: значение_ключа
```

**Тело запроса (JSON)**:

```json
{
  "chat": {
    "telegram_id": 0
  },
  "content": {
    "type": "NODE",
    "node": {
      "name": "Имя узла"
    },
    "get_params": {
      "foo": "bar"
    }
  }
}
```

**Описание параметров:**

* **chat.telegram\_id** — это ID пользователя в Telegram
* **content.type** — тип контента. В данном случае это `NODE`, что указывает на сценарий, который будет передан в чат-бот.
* **content.node.name** — название сценария на платформе Fasttrack, который будет отправлен пользователю.
* **content.get\_params** — параметры, которые могут быть переданы в сценарий. Например, они могут содержать динамическую информацию или настройки, необходимые для выполнения определенного действия.

#### 3. **Что можно делать с помощью API?**

* **Обновление информации о пользователе**: Используя данный метод, можно обновить информацию о пользователе в чат-боте без необходимости отправки ему сообщения.
* **Отправка триггерных сценариев**: Также можно инициировать выполнение сценариев в чат-боте, которые могут включать различные шаги, опросы, уведомления и другие действия.