Эндпоинты ботов

Подключение и управление Telegram-ботами, которые встречают подписчиков и отслеживают вступления в ваши чаты.

Список ботов

GET /api/bots/list.json

Возвращает все боты, подключённые к вашему аккаунту, включая мягко удалённые.

{
  "status": "ok",
  "data": [
    {
      "id": 7,
      "tg": 7123456789,
      "username": "mytrackbot",
      "name": "My Tracking Bot",
      "status": 0,
      "created": "2026-05-01 12:00:00"
    }
  ]
}

Подключить бота

POST /api/bots/add.json

Подключает бота по его токену из BotFather. Проверяет токен через Telegram API, затем регистрирует вебхук для получения обновлений.

{
  "status": "ok",
  "data": {
    "id": 7,
    "username": "mytrackbot",
    "name": "My Tracking Bot"
  }
}

Восстановление при повторном добавлении: если вы ранее отключили этого бота и добавляете тот же токен снова, существующая запись реактивируется — дубликат не создаётся, кампании бота сохраняются.

Список чатов с правами администратора

GET /api/bots/chats.json

Возвращает кешированный список чатов, где бот является администратором, исключая чаты, уже отслеживаемые какой-либо кампанией. Используется как список выбора при создании кампании.

{
  "status": "ok",
  "data": [
    { "id": -1001234567890, "title": "My Channel", "type": "channel" }
  ]
}

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

Отключить бота

POST /api/bots/del.json

Мягко удаляет бота, снимает вебхук и очищает кеш. Запись сохраняется для истории; все лиды и статистика, ссылающиеся на этого бота, сохраняются. Бота можно подключить повторно — применяется логика «Восстановление при повторном добавлении».

{ "status": "ok" }