Telegram — устранение неполадок
Ошибка: «Telegram-бот не найден. Проверьте токен бота»
Сообщение: Telegram-бот не найден. Проверьте токен бота.
Что означает: Токен Telegram-бота, указанный в настройках Lightlead, недействителен или ведёт к несуществующему боту. Система не может отправить уведомление.
Возможные причины:
- Токен был скопирован не полностью или с лишними символами
- Бот был удалён через BotFather
- Токен был отозван (перевыпущен) через BotFather
- Используется токен другого бота, не связанного с Lightlead
Что сделать:
- Откройте Telegram и перейдите в чат с @BotFather
- Отправьте команду /mybots, выберите нужного бота, затем API Token
- Скопируйте токен целиком
- Вставьте токен в настройки Lightlead (раздел «Интеграции» → «Telegram»)
- Сохраните и нажмите «Проверить подключение»
- Дождитесь тестового сообщения от бота
Повторять запуск: да
Требуется переподключение: нет (только токен)
Когда обращаться в поддержку: Если токен скопирован корректно, но проверка подключения не проходит, или тестовое сообщение не приходит.
Что отправить: Время ошибки, скриншот ошибки, длину токена (не сам токен!), скриншот экрана BotFather со списком ботов.
Ошибка: «Чат не найден. Убедитесь, что пользователь активировал бота»
Сообщение: Чат не найден. Убедитесь, что пользователь активировал бота.
Что означает: Lightlead пытается отправить сообщение конкретному пользователю Telegram, но чат с этим пользователем не существует — бот никогда не получал от него команду /start.
Возможные причины:
- Пользователь не нажал Start в чате с ботом
- Пользователь заблокировал бота
- Telegram ID пользователя указан неверно
- Бот был перезапущен, и предыдущие чаты потеряны
Что сделать:
- Попросите пользователя открыть чат с ботом в Telegram
- Нажать кнопку Start (или отправить команду /start)
- После этого бот сможет отправлять сообщения этому пользователю
- Проверьте корректность Telegram ID в настройках уведомлений Lightlead
- Отправьте тестовое уведомление
Повторять запуск: да
Требуется переподключение: нет
Когда обращаться в поддержку: Если пользователь активировал бота и не блокировал его, но сообщения не доходят. Или если вам нужна помощь в получении Telegram ID пользователя.
Что отправить: Telegram ID пользователя (если известен), время ошибки, скриншот ошибки, скриншот чата пользователя с ботом (подтверждение /start).
Ошибка: «Превышен лимит сообщений Telegram. Попробуйте позже»
Сообщение: Превышен лимит сообщений Telegram. Попробуйте позже.
Что означает: Бот отправил слишком много сообщений за короткий промежуток времени и был временно ограничен Telegram API. Лимиты Telegram: примерно 30 сообщений в секунду на одного бота, но могут быть ниже для новых ботов.
Возможные причины:
- Настроено слишком много уведомлений, отправляемых одновременно
- Несколько отчётов завершились в одно время и все шлют уведомления
- Массовая рассылка уведомлений большому числу пользователей
- Telegram применяет пониженные лимиты к новым ботам
Что сделать:
- Подождите 1–5 минут, пока лимит не сбросится
- Уменьшите количество Telegram-уведомлений в настройках отчётов
- Разнесите время запуска отчётов, чтобы уведомления приходили с интервалом
- Объедините несколько уведомлений в одно сводное сообщение
- Для больших команд — рассмотрите альтернативные каналы (email, Slack)
Повторять запуск: да (очередь неотправленных сообщений будет обработана после снятия лимита)
Требуется переподключение: нет
Когда обращаться в поддержку: Если лимит превышается регулярно даже при небольшом количестве уведомлений (менее 5 в минуту).
Что отправить: Количество активных Telegram-уведомлений, количество пользователей, получающих уведомления, интервал между запусками отчётов, время ошибки, скриншот ошибки.
Ошибка: «Не удалось отправить файл в Telegram. Размер файла превышает допустимый»
Сообщение: Не удалось отправить файл в Telegram. Размер файла превышает допустимый.
Что означает: Файл отчёта (скриншот, PDF, CSV), который Lightlead пытается отправить в Telegram, превышает лимит Telegram Bot API — 50 МБ.
Возможные причины:
- Отчёт с большим количеством данных формирует тяжёлый CSV/XLSX-файл
- В отчёт включены скриншоты в высоком разрешении
- Отчёт за длительный период генерирует большой объём данных
Что сделать:
- Разбейте отчёт на несколько с меньшим диапазоном дат
- Исключите из Telegram-отправки графики и скриншоты — оставьте только текстовое резюме
- Используйте Google Sheets как целевой источник вместо прикрепления файла в Telegram
- Настройте отправку ссылки на файл в облаке вместо самого файла
- Уменьшите количество метрик в отчёте
Повторять запуск: да
Требуется переподключение: нет
Когда обращаться в поддержку: Если файл меньше 50 МБ, но ошибка всё равно возникает, или если вам критично отправлять большие файлы через Telegram.
Что отправить: Размер файла (приблизительно), тип файла (CSV/XLSX/PDF/изображение), количество строк и столбцов в отчёте, время ошибки, скриншот ошибки.