Обзор
API BotBrother создано для связки ботов с вашими системами: CRM, сайтами, кассами, программами лояльности. Мы постоянно совершенствуем API, чтобы любой программист смог создать интеграции или дополнительный функционал для платформы.
Документация · API
API BotBrother для нестандартных решений
Почти весь функционал бота собирается в конструкторе. То, что в него не укладывается — свои интеграции, надстройки и Web App, — реализуется через API.
Что можно сделать через API
Сигналы → ваши системы
Действие «Сигнал» скрытно оповещает вашу систему о событиях в боте: пользователь оставил телефон, заполнил данные, дошёл до нужного шага. Идеально для связки с CRM.
Переменные
Читайте и записывайте переменные пользователя: анкеты, статусы, результаты — и стройте на них логику вне бота.
Балансы и начисления
Начисляйте и списывайте бонусы, рубли или собственную валюту бота из внешних систем — программы лояльности, кэшбэки.
Идентификация клиента
Находите профиль подписчика по логину, телефону или email (GetUserProfile) — и начисляйте баллы или списывайте оплату из вашей кассы.
Пользователи и группы
Управляйте доступами: добавляйте пользователей в группы, открывайте рубрики по событиям из ваших систем.
Web App
Создавайте приложения внутри Telegram, которые общаются с ботом через API.
Быстрый старт
- Зарегистрируйтесь и создайте бота в личном кабинете.
- Получите ключ API в личном кабинете — раздел «API, MCP».
- Актуальная документация по API живёт здесь, в базе знаний — раздел пополняется. Инструкции по конкретным связкам (Google Таблицы, OpenRouter, GigaChat) — в блоге.
Не хватает метода для вашей задачи? Напишите на support@botbrother.ru — мы развиваем API по запросам пользователей.
Ключи: права и ресурсы
У ключа две независимые настройки. Права отвечают на вопрос «что можно делать»: чтение, редактирование или полный доступ. Ресурсы — «над чем»: по умолчанию ключ работает со всем аккаунтом, но его можно выпустить на конкретные боты либо только на отдельные каналы и группы.
Ключ на бота
Всё в пределах этого бота: подписчики, рассылки, структура, балансы, брони, его каналы и группы. Остальные боты аккаунта такому ключу недоступны.
Ключ на канал или группу
Публикации и инвайт-ссылки выбранного канала плюс файловое хранилище его бота — ровно то, что нужно контент-менеджеру или подрядчику. Подписчики, рассылки, структура и деньги бота остаются закрытыми.
Если метод выходит за границы ключа, ответ приходит с полем
errorcode: key_resource_scope
и текстом, который прямо говорит, что ключ ограничен. Это не «объект не найден» — искать ошибку
в своём коде не нужно, список ресурсов расширяется в личном кабинете.
Перевыпуск и правка доступа. Действующему ключу можно сменить секрет, не пересобирая его: кнопка «Перевыпустить» сохраняет название, права, список ресурсов и длительность срока. Перед подтверждением кабинет показывает, когда ключом пользовались, — старый секрет перестаёт работать сразу. Список ботов и каналов правится отдельно, и секрет при этом не меняется: переписывать его в интеграциях не нужно. У истёкшего ключа кончился срок, а не секрет, — такой создаётся заново с нужным сроком.
API или MCP — что выбрать?
API
Для программных интеграций: ваш код общается с ботом по расписанию или по событиям. CRM, кассы, сайты.
MCP
Для работы через нейросети: создание и редактирование ботов, рассылки и статистика — фразами в чате с ИИ. Документация MCP →
Зачислим 200 рублей для тестов при регистрации
Создайте своего бота уже сегодня
Боты в Telegram помогают автоматизировать бизнес, маркетинг и продажи. Существует более 100 сценариев, в которых можно задействовать ботов.