Как подключить Telegram-бот

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

Подключение состоит из двух независимых шагов: руководитель подключает бот компании (шаги 1–2), а затем каждый сотрудник отдельно привязывает свой личный Telegram (шаг 3). Если пропустить второе, бот подключён, но уведомления не приходят никому — системе просто некуда их слать.

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

1. Найдите в Telegram бота @BotFather и отправьте ему команду /newbot.
2. Придумайте отображаемое имя (например, «WideBear Студия Икс») и имя пользователя — оно должно заканчиваться на bot, например studio_x_bot.
3. BotFather пришлёт токен вида 123456:ABC-DEF… — скопируйте его целиком.

2. Добавьте интеграцию в WideBear

1. Меню слева → «Компания» → «Интеграции» (раздел виден проджект-менеджерам, бухгалтерам и главным администраторам; если пункта нет в меню — доступа у вас нет). Туда же ведёт кнопка «Подключить» в шаге «Подключите Telegram-бот компании» на главной.
2. Нажмите «Добавить интеграцию» (в пустом разделе кнопка называется «Добавить первую интеграцию»).
3. Выберите «Telegram бот». Рядом в списке есть «Max мессенджер» — если компания работает в нём.
4. Вставьте токен в поле «Telegram токен» (подсказка под ним: «Токен можно получить у @BotFather в Telegram») и нажмите «Добавить».

После сохранения под карточкой появится строка «проверка имени бота…», а затем имя и ник бота — это и есть подтверждение, что токен рабочий. Красная надпись «токен бота недействителен» означает, что токен скопирован не полностью или бот удалён в BotFather.

У готовой интеграции есть бейдж «Активна» / «Неактивна», строка «Токен:» с кнопкой-глазом «Показать/скрыть токен», а также «Редактировать» и «Удалить». Подробнее — «Интеграции компании: Telegram-бот и Max».

3. Сотрудники подключают свой Telegram

Способов три. Первые два сразу открывают переписку с ботом компании — именно она нужна для уведомлений; третий привязывает учётную запись, но переписку с ботом компании не заменяет.

• Открыть бота компании и нажать «Старт». Так происходит само, если человек регистрировался по ссылке-приглашению из раздела «Сотрудники».
• Поделиться номером телефона. Если сотрудник зарегистрирован на сайте, но Telegram не привязал, бот на любое его сообщение отвечает подсказкой с кнопкой «Поделиться номером телефона»: система находит учётную запись по номеру и отвечает «Мы нашли вашу учётную запись: имя. Telegram привязан». Контакт из адресной книги или введённый руками бот не примет — это защита от привязки к чужой учётной записи.
• Через сайт. На главной в карточке «Что осталось настроить» есть шаг «Привяжите свой Telegram» с кнопкой «Подключить». Она открывает не бота компании, а общий бот входа WideBear: такая привязка включает вход по QR-коду и восстановление пароля, но уведомления компании начнут приходить только после того, как сотрудник откроет бота компании и нажмёт «Старт». Ссылка действует 15 минут; после подтверждения в мессенджере страница сама вернёт вас на главную. Подробно — в статье «Привязка личного Telegram к аккаунту».

Что появится у сотрудника в боте

Кнопка «Открыть» слева от поля ввода запускает мини-приложение WideBear; если она пропала, команда /menu вернёт её на место. Под полем ввода появляется клавиатура: «📞 Контакты», «🌐 WEB версия», «⏱ Заполнить трудозатраты», «👥 Кто работает», а у проджект-менеджеров, бухгалтеров и главных администраторов — ещё «⚙️ Управление». Что делает каждая — в статье «Что умеет Telegram-бот компании: кнопки и команды».

Что начнёт работать после подключения

• Назначение на смену — сообщение с местом, временем и работами, под ним «✅ Принять» и «❌ Отклонить»; при двух и более сменах добавляется «📅 Могу не все дни». В массовом приглашении кнопки называются «✅ Хочу» и «❌ Отклонить».
• Напоминание за 2 часа до явки — с кнопкой «😴 Я не сплю, буду вовремя».
• Групповой чат мероприятия — если добавить бота компании в чат под проект и назначить администратором, он сам позовёт туда всех назначенных сотрудников. Отдельной кнопки отправки вызывного в карточке мероприятия сейчас нет: подтверждения собираются персональными приглашениями на смену. См. «Группа мероприятия в Telegram и отправка вызывного».
• Напоминания о задачах — включаются в «Компания» → «Настройки» → вкладка «Задачи»: переключатель «Напоминать о приближающихся дедлайнах», поле «За сколько часов до дедлайна напоминать» (от 1 до 168 часов) и «Напоминать о просроченных задачах».
• Мини-приложение WideBear — открывается из чата; внизу четыре раздела: «Ивенты», «Часы», «Задачи» и «Профиль». Обзор — «Мини-приложение WideBear в Telegram».

Если уведомления не доходят

1. В «Интеграциях» под карточкой должно выводиться имя бота, а не «токен бота недействителен».
2. Сотрудник должен хотя бы раз открыть бота вашей компании и нажать «Старт» — без этого боту некуда писать.
3. Нужный тип уведомления мог быть выключен вручную на вкладке «Уведомления» в профиле — см. «Уведомления: какие приходят и как их отключить» и «Сотруднику не приходят уведомления: что проверить».