Telegram Gateway

Вход в админ-панель

Управление проектами и ботами gateway. Вход по административному ключу.

Сессия — HttpOnly-cookie на 8 часов; ключ стирается из поля сразу после ответа сервера.

Проекты

Все проекты gateway. Ключ проекта показывается один раз — при создании.

Список проектов
ID	Название	Статус	Ботов	Callback	Создан	Действия

Проект

—

Основное

Ключ проекта

Ключ показывается один раз при создании проекта и хранится только как SHA-256. Здесь его нет, и повторно получить его нельзя.

Перевыпуск пока не поддерживается API: ключ выдаётся только при создании проекта.

Callback проекта

—

URL callback

Абсолютный https до 500 символов. http — только localhost/127.0.0.1 в Development. Секрет хранится зашифрованным и здесь не показывается.

Боты проекта

Боты проекта
Ключ	Название	Режим	Webhook	Статус	Действия

Опасная зона

Удаление проекта необратимо: каскадом удаляются боты, апдейты, журнал отправок и callback-доставки. Для паузы выключите проект, а не удаляйте его.

Боты

Все боты всех проектов. Токены API не возвращает — только ключ и состояние webhook.

Список ботов
Ключ	Название	Проект	Режим	Webhook	Webhook установлен	Статус	Создан	Действия

Список без пагинации: фильтры применяются в браузере.

Бот

— —

Основное

Токен

API не возвращает токен ни в одном ответе. Обновление токена не меняет режим и не снимает webhook.

Webhook

Режим: —
Webhook URL: —
Установлен: —

Состояние со стороны Telegram не запрашивается: getWebhookInfo в API нет. Показано только сохранённое состояние gateway.

При переключении на polling gateway вызывает deleteWebhook и очищает webhookUrl/webhookSetAt. Для режима webhook нужен Gateway__PublicBaseUrl.

Переключение режима меняет состояние webhook в Telegram.

Опасная зона

Удаление бота необратимо: каскадом уходят апдейты, журнал отправок и callback-доставки. Сначала снимите webhook в Telegram, иначе он начнёт получать 404.

Диагностика

Состояние сервиса и последние ошибки. Только чтение.

загрузка…

Liveness

—

GET /health

Статус: —
Версия: —
Время сервера: —

Публичный путь: процесс отвечает, база не проверяется.

Readiness

—

GET /health/ready

Статус: —
База: —
Неприменённых миграций: —
Проверка: —

При сбое — 503: «не готово», причина database: unavailable или outdated.

Режимы ботов

Переключение меняет состояние webhook в Telegram.

Режимы приёма апдейтов по ботам
Ключ	Название	Режим	Статус	Действия

Переключение идёт через PUT /api/v1/admin/bots/{botKey}/mode. При ошибке Telegram режим на сервере не меняется, список перезапрашивается.

Статус

Лимит

Журнал отправок
ID	Бот	Chat hash	Message ID	Статус	Ошибка	Создано	Обновлено

Текстов сообщений и chatId в журнале нет — только короткий хеш. Ошибка обрезана сервером до 200 символов. GET /api/v1/admin/send-logs

Статус

Проект

Лимит

Доставки callback
ID	Проект	Бот	update_id	Статус	Попытки	Следующая попытка	Ошибка	Создано	Доставлено

Повторить доставку из UI нельзя — ретраи делает воркер (до 8 попыток, паузы 5 с … 3 ч). GET /api/v1/admin/deliveries