Системные уведомления и роботы Telegram

В документации мы постарались ответить на частые вопросы по работе TesLab, с которыми сталкиваются пользователи.
Если Вы не нашли ответ на свой вопрос, напишите нам.

Личный кабинет

Системные уведомления и роботы Telegram

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

В этой статье

Подготовить робота и доступ

Откройте «Компания → Конфигурация → Email». Для работы с каталогом роботов нужны права на его просмотр, добавление и изменение. Общие параметры Telegram и прокси доступны администратору. Если нужного блока или действия нет, обратитесь к администратору своей установки: наличие вкладки ещё не означает доступ ко всем её настройкам.

Создайте робота через @BotFather командой /newbot либо получите токен уже созданного робота. Скопируйте API Token целиком, включая числовой префикс и двоеточие. Токен позволяет обращаться к Telegram от имени робота. Он отличается от пароля TesLab и личного Telegram ID сотрудника. Не помещайте его в название, комментарий или переписку с получателями.

Заранее определите назначение робота и ответственного за него. Для клиентских диалогов используйте отдельную настройку источников Chatter. Согласуйте использование одного бота в нескольких интеграциях: другая интеграция может заменить его webhook.

Добавить или изменить робота

  1. В блоке «Роботы Telegram» нажмите кнопку добавления.
  2. Укажите внутреннее название, по которому коллеги смогут выбрать нужного робота.
  3. Вставьте API Token в одноимённое поле. Значение скрыто точками.
  4. При необходимости добавьте комментарий о назначении без секретов.
  5. Нажмите «Добавить», дождитесь ответа и прочитайте предупреждение, если оно появилось.
Добавление робота Telegram: название, скрытый токен и комментарий
1. Внутреннее название. 2. API Token. 3. Комментарий. Кнопка «Добавить» сохраняет запись после проверки введённых параметров.

Для правки откройте робота кнопкой редактирования. Прежний токен не раскрывается: пустое поле API Token сохраняет его. Чтобы заменить токен, вставьте новое значение целиком. Название и комментарий можно изменить без повторного ввода секрета. Для повторной регистрации webhook включите одноимённый флажок и нажмите «Сохранить».

Во время отправки форма блокирует ввод. При отказе данные остаются в открытой форме. Если сервер сообщил о конфликте изменений, перечитайте запись и внесите правку в её актуальную версию. При неизвестном результате сначала проверьте список: повторное создание новой записи может привести к дубликату. Для повтора той же операции используйте прежние значения в оставшейся открытой форме.

Прочитать результат сохранения

При добавлении робота, замене токена или явном повторе регистрации сервер пытается настроить webhook. Это адрес установки TesLab, на который Telegram направляет обновления. Регистрация адреса не подтверждает отправку уведомлений и не означает, что ответы сотрудника будут обработаны как рабочий диалог. Для таких диалогов настройте Chatter отдельно.

  • Запись сохранена без предупреждения. Переходите к назначению и проверке доставки.
  • «Робот сохранён, регистрация webhook не подтверждена». Проверьте сеть, прокси и публичный HTTPS-адрес установки. После исправления откройте робота и явно повторите регистрацию. Возможность исходящей отправки проверяйте отдельным сообщением.
  • «Токен робота больше не действует». Замените сохранённый токен действующим и проверьте результат.
  • Telegram не принял новый токен. Изменение не сохраняется. Проверьте, что скопировали токен нужного робота полностью.

Обычная правка названия не выполняет новую сетевую проверку токена. Сохранённое состояние webhook относится к прежней попытке регистрации и не заменяет текущую проверку канала.

Сохранить и проверить подключение

Блок «Telegram: уведомления и прокси» объединяет выбор робота для новостей и параметры подключения сервера к Telegram. Эти поля сохраняются вместе кнопкой «Сохранить». SMTP для новостей настраивается отдельно в блоке уведомлений по email.

  1. Выберите робота для новостей. Значение «Отключен» выключает этот канал; «Общий робот TesLab» использует общий канал установки.
  2. Если сеть требует прокси, выберите SOCKS5, HTTP или HTTPS и задайте адрес в формате host:port. Тип «Отключен» означает прямое подключение.
  3. При необходимости заполните логин и пароль. Пустой пароль сохраняет прежний. Для удаления используйте флажок «Удалить сохранённый пароль прокси». При смене адреса или типа заново задайте пароль либо явно удалите прежний.
  4. Нажмите «Сохранить» и дождитесь подтверждения. Затем нажмите «Проверить подключение».
Выбор робота для новостей и настройка прокси Telegram
1. Робот для новостей. 2. Тип подключения. 3. Адрес прокси. 4. Сохранение общих параметров. Проверка доступна после подтверждённого сохранения.

Проверка использует сохранённые параметры. Несохранённые изменения нужно сначала записать или отменить кнопкой «Перечитать». При перечитывании введённые изменения заменяются настройками сервера. Конфликт означает, что параметры уже изменил другой администратор. Перечитайте их перед повторной правкой. Если результат записи неизвестен, не считайте изменение сохранённым по одному значению в поле.

Результат проверки сети и ответа робота Telegram
1. Итог проверки сети. 2. Ответ проверенного робота. Эта проверка не отправляет сообщение получателю и не подтверждает webhook.

Читайте журнал целиком: доступность сети, ответ токена и доставка различаются. Сетевая ошибка не доказывает неверный токен. Успешный ответ одного проверенного робота не проверяет каждый токен каталога. После изменения полей прежний результат проверки больше не относится к новой конфигурации.

Выбрать назначение и получателей

  1. Сохраните нужного робота в поле «Робот для новостей».
  2. Попросите получателя проверить личное подключение Telegram и включить соответствующие категории уведомлений.
  3. Если выбран собственный робот, получатель должен открыть именно его в Telegram и нажать «Начать». Диалог с общим ботом не заменяет этот шаг.
  4. Создайте допустимое событие нужного процесса и проверьте сообщение у согласованного получателя.

Выбор робота для новостей относится к рассылке новостей. Другие процессы могут задавать канал в собственных настройках. Назначение не создаёт личную привязку сотрудника и не включает все категории уведомлений. Ручное сообщение сотруднику через Telegram проверяет другой сценарий и может использовать другого робота.

Проверить доставку и устранить ошибки

  • Блок не загружается или запись не подтверждена. Перечитайте настройки. Если приложение просит обновить сервер, передайте сообщение администратору установки.
  • Проверка подключения не проходит. Проверьте адрес, порт, тип и реквизиты прокси, затем сохраните параметры заново. Общая сеть затрагивает всех получателей.
  • Другим приходит, одному нет. Проверьте его Telegram ID, категории, диалог с выбранным ботом и отсутствие блокировки бота.
  • Проверка сети успешна, новостей нет. Проверьте назначение робота, параметры рассылки конкретной новости и готовность фоновой обработки на сервере.
  • Исход отправки неизвестен. Уточните фактическое получение и передайте администратору событие и время. Не создавайте повторную рассылку вслепую: первоначальное сообщение могло дойти.

Замена токена влияет на всех, кто использует эту запись. После изменения повторно проверьте нужный процесс. Подтверждение Telegram означает принятие сообщения платформой, но не его прочтение сотрудником. Email проверяйте отдельно по инструкции SMTP.

Материалы и файлы