Настройка Telegram-бота BankSklad

BankSklad может отправлять уведомления о входящих и исходящих платежах в Telegram. Для этого нужно создать своего бота, добавить его в нужный чат или канал, получить идентификатор чата и указать эти данные в решении.

1. Создайте бота в BotFather

Откройте в Telegram бота @BotFather и создайте нового бота командой /newbot.

BotFather попросит указать:

• название бота;
• username бота, который должен заканчиваться на bot;
• описание и аватар, если они нужны.

После создания BotFather выдаст токен доступа. Он выглядит как строка вида 1234567890:AA.... Сохраните токен: он понадобится при добавлении бота в BankSklad.

Не публикуйте токен в открытых чатах и не отправляйте его посторонним. По токену можно отправлять сообщения от имени вашего бота.

2. Добавьте бота в чат или канал

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

Добавьте в этот чат созданного бота. Частая ошибка — думать, что бот будет отправлять уведомления сам себе. Telegram-боту нужен получатель: группа, канал, тема в группе или личный чат пользователя, в который бот имеет доступ.

Если уведомления должны приходить в канал, добавьте бота в канал и выдайте ему права на отправку сообщений.

3. Получите chat ID

Для отправки сообщений BankSklad нужен chat_id — идентификатор чата в Telegram Bot API.

Для групп, супергрупп и тем проще всего получить ID через Telegram Web или ссылку на сообщение.

Откройте нужную группу или тему в Telegram Web или Telegram Desktop и скопируйте ссылку на сообщение. У приватных групп и супергрупп ссылка обычно выглядит так:

https://t.me/c/1234567890/42

Для Bot API из первой числовой части нужно собрать chat_id в формате -100...:

-1001234567890

Если ссылка ведет на сообщение внутри темы, она может содержать еще один числовой сегмент:

https://t.me/c/1234567890/42/99

В таком случае:

• 1234567890 — внутренняя часть ID группы;
• 42 — ID темы;
• 99 — ID конкретного сообщения.

Для отправки уведомлений в тему укажите в BankSklad:

-1001234567890:42

Если в адресной строке Telegram Web уже виден ID чата с -100, его можно использовать как chat_id без преобразования.

Обычная группа в Bot API обычно имеет отрицательный chat_id, например -123456789. Супергруппы и каналы используют формат с -100, например -1001234567890.

Если обычная группа была преобразована в супергруппу, Telegram меняет ее идентификатор. Если бот перестал отправлять сообщения после изменения настроек группы, добавления истории для новых участников, включения тем или других действий с группой, скопируйте ссылку на сообщение еще раз и проверьте актуальный chat_id.

4. Уведомления в тему Telegram

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

Для этого укажите в BankSklad значение в формате:

chat_id:thread_id

Например:

-1001234567890:42

Первая часть — chat_id группы, вторая часть — message_thread_id темы. Его можно взять из ссылки на сообщение в нужной теме. В ссылке вида https://t.me/c/1234567890/42/99 значение 42 обычно соответствует теме, а 99 — конкретному сообщению.

5. Добавьте бота в BankSklad

Откройте решение BankSklad в МоемСкладе и перейдите на вкладку Чат-боты.

В строке нужной организации и банка нажмите Добавить бота.

В форме укажите:

• тип платежей: Входящие или Исходящие;
• токен бота из BotFather;
• chat_id или значение chat_id:thread_id, если уведомления должны приходить в конкретную тему.

Уведомления можно настраивать отдельно для входящих и исходящих платежей. Например, входящие платежи отправлять в чат продаж, а исходящие — в отдельный чат руководителя или финансовой команды.

После заполнения нажмите Сохранить.

6. Проверьте отправку

После создания бота нажмите кнопку Тест в строке настройки.

Если все настроено корректно, BankSklad отправит тестовое сообщение в выбранный чат, канал или тему.

Если сообщение не пришло, проверьте:

• бот добавлен именно в тот чат или канал, чей chat_id указан в BankSklad;
• у бота есть право отправлять сообщения;
• токен скопирован полностью;
• chat_id актуальный и не изменился после преобразования группы в супергруппу;
• для темы указан формат chat_id:thread_id;
• если используется канал, бот добавлен в него с правами на публикацию.