Бот не видит сообщения в чате: права администратора и Group Privacy

Мастер пройден, бот в чате есть, команда #задача написана — тишина. В девяти случаях из десяти дело в правах бота внутри мессенджера. Ниже — короткий чеклист, который стоит пройти до обращения в поддержку.

MAX: без прав администратора бот слеп

В MAX боту нужно выдать права администратора чата. Иначе он не видит сообщения участников и не сможет создать задачу из переписки. Добавить бота «просто участником» недостаточно.

Проверьте:

• бот действительно в нужном чате;
• в настройках чата у него роль администратора;
• после смены прав отправлено тестовое #задача.

Telegram: Group Privacy у @BotFather

У новых ботов режим конфиденциальности группы включён по умолчанию. С ним обычный участник получает из группы только команды вида /команда@имя_бота, ответы на собственные сообщения бота и служебные события. Обычный текст до бота не доходит вообще — это фильтрация на стороне Telegram, и в логах вашего обработчика она выглядит как полная тишина.

Отключается у @BotFather: /mybots → выбрать бота → Bot Settings → Group Privacy → Disable.

И вот шаг, на котором спотыкается большинство. К группе, где бот уже состоит, новая настройка сама по себе не применится. Бота нужно удалить из группы и добавить заново. Пока этого не сделано, отключённый Group Privacy выглядит нерабочим, и люди по второму кругу перепроверяют токен и код.

Проверить точно: два запроса к Bot API

Чеклист по интерфейсу оставляет место догадкам. Два запроса отвечают однозначно.

Первый — какая настройка у бота глобально:

curl "https://api.telegram.org/bot<ТОКЕН>/getMe"

В ответе смотрите поле can_read_all_group_messages. Значение true означает, что Group Privacy отключён и бот получает все сообщения группы. Значение false — режим включён. Это поле возвращает только getMe, в других методах его нет.

Второй — кем бот числится в конкретной группе:

curl -X POST "https://api.telegram.org/bot<ТОКЕН>/getChatMember" \
  -d "chat_id=-1001234567890" \
  -d "user_id=<id_бота>"

Поле result.status со значением administrator означает, что в этой группе бот читает сообщения независимо от Group Privacy. Значение member — работает глобальная настройка из первого запроса.

Отсюда частая ловушка при проверке: администратор видит все сообщения, поэтому у тестировщика с админскими правами всё работает, а у бота в роли обычного участника — нет. Тестировать стоит именно как member.

Права администратора ради чтения сообщений выдавать необязательно: отключённый Group Privacy даёт тот же доступ, не раздавая лишних административных разрешений.

Вебхук Bitrix24

Если сообщения доходят до бота, но задача в портале не создаётся, смотрите входящий вебхук. Нужны шесть прав: задачи, пользователи, структура компании, рабочие группы, диск, чат. Мастер на сайте сам проверяет набор прав — удобно перезапустить проверку, если что-то меняли вручную.

Полный порядок подключения — в руководстве. Обзор продукта — на странице бота.

Другие частые причины

• Пишут в канал вместо группы (у каналов другая модель прав).
• Используют не того бота (токен от другого бота в мастере).
• Команда с опечаткой или без #задача / /задача.
• В личке всё работает, в группе — нет: почти всегда privacy или админ-права.
• Group Privacy отключён, а сообщений всё равно нет — тогда причина в доставке обновлений, а не в правах. Проверяется через getWebhookInfo, разбор — в статье про кнопки, которые не срабатывают.

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

Минимальный тест после исправления

1. Напишите в чат #задача тест прав.
2. Убедитесь, что пришла карточка.
3. Откройте Bitrix24 и найдите задачу в нужной группе.
4. Нажмите «Взять» на карточке — статус должен измениться.

Если карточка есть, а в портале пусто — проблема на стороне вебхука или отделов. Если карточки нет — проблема в мессенджере. Способы постановки, когда всё уже видно боту — в статье как ставить задачи. Оба мессенджера — Telegram и MAX.

Порядок диагностики за 3 минуты

1. Работает ли #задача в личке с ботом? Если да — портал и вебхук живы, ломается группа.
2. В группе бот админ? В MAX без этого дальше можно не смотреть.
3. getMe возвращает can_read_all_group_messages: true?
4. Если настройку меняли — бота удаляли из группы и добавляли заново?
5. Токен в мастере совпадает с ботом в чате?
6. Вебхук содержит все шесть прав, мастер их подтверждает? Порядок выдачи — в статье про подключение вебхука.

Ответы «да/нет» по пунктам сразу сужают зону. Скрин настроек чата и ответ мастера по правам ускоряют помощь в поддержке.

Честно про границы

Даже при идеальных правах бот ведёт задачи, созданные через него, и не обещает полную синхронизацию портала. Он не импортирует старую историю чата. Но пока бот «не видит» сообщения, до этих тонкостей дело не доходит — сначала права.

Нужна помощь

Пройдите чеклист выше, затем напишите в Telegram: какой мессенджер, групповой чат или личка, что именно происходит на #задача. Подключить с нуля можно на bot-bitrix (неделя бесплатно). Если параллельно настраиваете сам портал — интеграции. Переход сотрудников в MAX — max-migration. Ещё тексты — блог. Про привычку работать из чата — сотрудники не заходят в Bitrix24.