Боты

Боты

Боты для Min на Bot API, совместимом с Telegram: создание, токен, апдейты через webhook или long polling, сообщения с inline-клавиатурами.

Боты Min говорят на подмножестве Telegram Bot API: тот же формат URL (/bot<token>/<method>), тот же конверт {"ok":true,"result":…} и те же объекты (Message, User, Chat, Update, CallbackQuery, InlineKeyboardMarkup). Многие Telegram-библиотеки работают после замены базового URL. Всё, чего нет в справочнике методов, не реализовано и возвращает 404.

1. Создайте бота#

Любой пользователь может создать до 20 ботов. Логин бота должен оканчиваться на bot (например, weather_bot). Два способа:

• @BotFather — откройте чат с @botfather в Min и отправьте /newbot Weather Bot | weather_bot. Другие команды: /mybots, /token <username> (новый токен), /revoke <username> (удалить).
• API — POST /api/bots с вашим пользовательским токеном (см. Управление ботами).

curl -X POST https://minchatapp.com/api/bots \
  -H "Authorization: Bearer $USER_TOKEN" -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"name":"Weather Bot","username":"weather_bot"}'
# → {"success":true,"bot":{"id":5,"username":"weather_bot",…},"token":"5:RyNKXZs7Va1LvKqSLj6Snsoy2FplGb1n8FV"}

2. Вызывайте Bot API#

Методы принимают GET или POST с параметрами в query, application/x-www-form-urlencoded, multipart/form-data (файлы) или JSON. Вложенные объекты (reply_markup, commands) можно передавать JSON-строкой.

https://minchatapp.com/bot<token>/<method>
https://minchatapp.com/bot/<token>/<method>        (alternative form)
https://minchatapp.com/file/bot<token>/<file_path> (file download)

{"ok": true, "result": { … }}
{"ok": false, "error_code": 400, "description": "Bad Request: chat not found"}

error_code — HTTP-статус: 400 неверный запрос, 401 неверный токен, 404 неизвестный метод, 409 getUpdates при включённом webhook, 429 лимит, 500 ошибка сервера.

Чаты и id#

message_id — глобальный id сообщения Min. file_id привязаны к боту.

3. Получайте апдейты#

Апдейт создаётся для каждого бота-участника чата, когда кто-то другой отправляет (message) или редактирует (edited_message) сообщение, и когда пользователь нажимает inline-кнопку (callback_query). Режим приватности: в группах бот получает только команды (/start, /weather@weather_bot), если для него не включено can_read_all_group_messages. В личных чатах и каналах — всё.

Long polling#

Вызывайте getUpdates в цикле с timeout (до 50 с) и offset = последний update_id + 1 — это подтверждает и удаляет предыдущие апдейты.

import requests

TOKEN = "5:RyNKXZs7Va1LvKqSLj6Snsoy2FplGb1n8FV"
API = f"https://minchatapp.com/bot{TOKEN}"
offset = 0

while True:
    r = requests.get(f"{API}/getUpdates", params={"offset": offset, "timeout": 30}, timeout=40).json()
    for upd in r["result"]:
        offset = upd["update_id"] + 1
        if "message" in upd:
            msg = upd["message"]
            if msg.get("text", "").startswith("/weather"):
                requests.post(f"{API}/sendMessage", json={
                    "chat_id": msg["chat"]["id"],
                    "text": "Pick a city:",
                    "reply_markup": {"inline_keyboard": [[
                        {"text": "Moscow", "callback_data": "city:moscow"},
                        {"text": "Berlin", "callback_data": "city:berlin"},
                    ]]},
                })
        elif "callback_query" in upd:
            cq = upd["callback_query"]
            requests.post(f"{API}/answerCallbackQuery", json={"callback_query_id": cq["id"], "text": "Loading…"})
            requests.post(f"{API}/editMessageText", json={
                "chat_id": cq["message"]["chat"]["id"],
                "message_id": cq["message"]["message_id"],
                "text": f"Weather for {cq['data'].split(':')[1]}: +5°C",
            })

const TOKEN = process.env.MIN_BOT_TOKEN;
const API = `https://minchatapp.com/bot${TOKEN}`;
const call = (method, body) =>
  fetch(`${API}/${method}`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(body ?? {}),
  }).then((r) => r.json());

let offset = 0;
for (;;) {
  const { result } = await call('getUpdates', { offset, timeout: 30 });
  for (const upd of result) {
    offset = upd.update_id + 1;
    const msg = upd.message;
    if (msg?.text === '/start') {
      await call('sendMessage', { chat_id: msg.chat.id, text: `Hi, ${msg.from.first_name}!` });
    }
  }
}

curl "https://minchatapp.com/bot$BOT_TOKEN/getUpdates?timeout=30&offset=0"

Webhook#

setWebhook с HTTPS-адресом переключает бота на push-доставку: каждый апдейт отправляется POST-запросом с JSON. Отвечайте 2xx быстро; при ошибке — 3 повтора с интервалом 30 с, ошибка видна в getWebhookInfo. Проверяйте заголовок X-Telegram-Bot-Api-Secret-Token, если задан secret_token. Пока webhook включён, getUpdates возвращает 409.

curl -X POST "https://minchatapp.com/bot$BOT_TOKEN/setWebhook" \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com/minchat-webhook","secret_token":"s3cr3t-value"}' 

import express from 'express';
const app = express();
app.use(express.json());

app.post('/minchat-webhook', async (req, res) => {
  if (req.get('X-Telegram-Bot-Api-Secret-Token') !== process.env.WEBHOOK_SECRET) return res.sendStatus(403);
  res.sendStatus(200); // acknowledge first
  const msg = req.body.message;
  if (msg?.text) {
    await fetch(`https://minchatapp.com/bot${process.env.MIN_BOT_TOKEN}/sendMessage`, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({ chat_id: msg.chat.id, text: `You said: ${msg.text}` }),
    });
  }
});
app.listen(3000);

from flask import Flask, request, abort
import os, requests

app = Flask(__name__)
API = f"https://minchatapp.com/bot{os.environ['MIN_BOT_TOKEN']}"

@app.post("/minchat-webhook")
def hook():
    if request.headers.get("X-Telegram-Bot-Api-Secret-Token") != os.environ["WEBHOOK_SECRET"]:
        abort(403)
    upd = request.get_json()
    msg = upd.get("message")
    if msg and msg.get("text"):
        requests.post(f"{API}/sendMessage", json={"chat_id": msg["chat"]["id"], "text": "Got it!"})
    return "ok"

Пример тела webhook (апдейт message):

{
  "update_id": 1,
  "message": {
    "message_id": 51,
    "date": 1792660008,
    "chat": {
      "id": 1,
      "type": "private",
      "first_name": "Anna",
      "username": "anna_s"
    },
    "from": {
      "id": 1,
      "is_bot": false,
      "first_name": "Anna",
      "last_name": "Smith",
      "username": "anna_s"
    },
    "text": "/weather Moscow"
  }
}

4. Inline-клавиатуры и callback#

Передайте reply_markup с inline_keyboard — рядами кнопок. У кнопки text (≤ 64 символов) и либо callback_data (≤ 64 байт), либо url. Клиенты показывают клавиатуру под сообщением; URL-кнопки открываются во внешнем браузере. Нажатие создаёт апдейт callback_query; ответьте answerCallbackQuery и обычно обновите сообщение через editMessageText / editMessageReplyMarkup (пустой inline_keyboard убирает клавиатуру). Изменения приходят клиентам сразу (MessageUpdated).

{
  "chat_id": 1,
  "text": "Pick a city:",
  "reply_markup": {
    "inline_keyboard": [
      [ {"text": "Moscow", "callback_data": "city:moscow"}, {"text": "Berlin", "callback_data": "city:berlin"} ],
      [ {"text": "Open website", "url": "https://minchatapp.com"} ]
    ]
  }
}

Апдейт callback_query:

{
  "update_id": 3,
  "callback_query": {
    "id": "1",
    "from": {
      "id": 1,
      "is_bot": false,
      "first_name": "Anna",
      "last_name": "Smith",
      "username": "anna_s"
    },
    "chat_instance": "8",
    "data": "city:moscow",
    "message": {
      "message_id": 50,
      "date": 1792660008,
      "chat": {
        "id": 1,
        "type": "private",
        "first_name": "Anna",
        "username": "anna_s"
      },
      "from": {
        "id": 5,
        "is_bot": true,
        "first_name": "Weather",
        "last_name": "Bot",
        "username": "weather_bot",
        "can_join_groups": true,
        "can_read_all_group_messages": false,
        "supports_inline_queries": false
      },
      "text": "Pick a city:",
      "reply_markup": {
        "inline_keyboard": [
          [
            {
              "text": "Moscow",
              "callback_data": "city:moscow"
            },
            {
              "text": "Berlin",
              "callback_data": "city:berlin"
            }
          ],
          [
            {
              "text": "Open website",
              "url": "https://minchatapp.com"
            }
          ]
        ]
      }
    }
  }
}

5. Команды#

Зарегистрируйте команды через setMyCommands; сообщения, начинающиеся с /, доходят до ботов в группах даже в режиме приватности. /cmd@your_bot адресует конкретного бота.

curl -X POST "https://minchatapp.com/bot$BOT_TOKEN/setMyCommands" \
  -H 'Content-Type: application/json' \
  -d '{"commands":[{"command":"start","description":"Start the bot"},{"command":"weather","description":"Current weather"}]}' 

6. Файлы#

Медиа отправляются загрузкой (multipart), по URL (сервер скачает до 50 МБ) или по ранее полученному file_id. Чтобы скачать файл, вызовите getFile и запросите /file/bot<token>/<file_path>.

curl -F chat_id=1 -F caption='Forecast map' -F photo=@map.png \
  "https://minchatapp.com/bot$BOT_TOKEN/sendPhoto"

Ограничения#

Управление ботами (пользовательский API)#

Эти методы используют Sanctum-токен владельца, а не токен бота.

curl 'https://minchatapp.com/api/bots' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

{
  "success": true,
  "bots": [
    {
      "id": 5,
      "name": "Weather Bot",
      "username": "weather_bot",
      "avatar": null,
      "created_at": "2026-10-22T09:06:14+00:00"
    }
  ]
}

curl -X POST 'https://minchatapp.com/api/bots' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{"name": "Weather Bot", "username": "weather_bot"}'

{
  "success": true,
  "bot": {
    "id": 5,
    "name": "Weather Bot",
    "username": "weather_bot",
    "avatar": null
  },
  "token": "5:AAEhBP0av28Jc9RIwmZ8P-exampleToken"
}

curl -X POST 'https://minchatapp.com/api/bots/5/token' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

{
  "success": true,
  "token": "5:AAEhBP0av28Jc9RIwmZ8P-exampleToken"
}

curl -X DELETE 'https://minchatapp.com/api/bots/5' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Accept: application/json'

Связанные: GET /api/username-available?kind=bot — проверка логина бота; POST /api/messages/{id}/callback — вызывается клиентом при нажатии кнопки.