# Интеграция собственного 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?**

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


---

# 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://docs.fstrk.io/knowledge_base/telegram/tg-miniapp/integraciya-sobstvennogo-mini-app-v-telegram-s-chat-botom.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.