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

{
  "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?

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

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