Боты в Лизе — Liza Bot API
Liza Bot API — HTTP-интерфейс для ботов в мессенджере Liza. Он устроен как Telegram Bot API: те же методы, те же объекты, те же библиотеки (python-telegram-bot, aiogram и другие). Меняется только адрес сервера:
https://bot.tech.liza.ru
Открыть API-справочник · Скачать OpenAPI JSON
С чего начать
| Задача | Страница |
|---|---|
| Создать бота и получить токен (2 минуты, в приложении) | Быстрый старт |
| Подключить код: python-telegram-bot, aiogram, curl, вебхук | Подключение кода |
| Понять, что видит человек и какие апдейты приходят боту | Что видит человек и что получает бот |
| Написать человеку первым | Написать первым — startChat |
| Узнать, что поддерживается, а что нет | Возможности и ограничения |
| Проверить запуск и разобрать ошибку | Чек-лист и решение проблем |
| Посмотреть параметры конкретного метода | Справочник API |
| Узнать, что поменялось в новой версии API | Журнал изменений |
Подключение
Токен передаётся только как часть пути:
https://bot.tech.liza.ru/bot<токен>/<метод>
Например, POST /bot123456:TEST_TOKEN/sendMessage. Не передавайте токен в
заголовке Authorization и не публикуйте его в логах или исходном коде.
Успешный ответ имеет форму { "ok": true, "result": … }; ошибки —
{ "ok": false, "error_code": …, "description": "…" }.
Запросы принимаются в тех форматах, которые указаны у метода в справочнике:
JSON, application/x-www-form-urlencoded или multipart/form-data. Последний
нужен для загрузки медиа.
Каталог методов
| Раздел | Методы |
|---|---|
| Бот и обновления | getMe, getUpdates, setMyCommands, getMyCommands, deleteMyCommands |
| Сообщения и callbacks | sendMessage, editMessageText, editMessageCaption, editMessageReplyMarkup, deleteMessage, sendChatAction, answerCallbackQuery |
| Чаты | getChat, getChatMember, getChatMemberCount, getChatAdministrators, startChat (расширение Liza) |
| Медиа и профиль | sendPhoto, sendDocument, sendVideo, sendAudio, sendVoice, getUserProfilePhotos |
| Webhook | setWebhook, deleteWebhook, getWebhookInfo |
| Файлы | getFile, GET /file/bot{token}/{file_id}, GET /bot{token}/file/{file_path} |
| Платежи | sendInvoice |
Полные параметры, ответы, примеры и статус совместимости каждого маршрута
приведены в интерактивном справочнике. Метод,
которого нет в справочнике, отвечает 400 Method '…' not supported in MVP.
Совместимость
В спецификации у каждого метода есть один из статусов: реализовано, частично реализовано или заглушка. Поля, которые сервер принимает, но не использует, отмечены как «игнорируется». Это важно для переносимых ботов: не полагайтесь на поведение, которого нет в справочнике.
Изменения для интеграторов
Текущая версия API — 1.3.0 (5 октября 2026). Что поменялось в версиях 1.1, 1.2 и 1.3 и что это значит для уже работающих ботов — в журнале изменений.