Нарушение в чек-листе → Telegram
Уведомление в ваш Telegram-чат после отправки чек-листа с нарушениями: номер результата, количество нарушений и время события.
Для кого
Для управляющих, руководителей смен и специалистов по качеству, которым нужно своевременно замечать нарушения в чек-листах.
Что решает
Передаёт короткий сигнал в выбранный чат без постоянного просмотра чек-листов. Подробности проверки остаются в Synchra24.
Нарушение в чек-листе → Telegram
Готовая событийная автоматизация: после отправки чек-листа хотя бы с одним нарушением бот присылает короткое уведомление в выбранный чат Telegram. В сообщении — номер результата, количество нарушений, время события в UTC и его идентификатор. Подробности пунктов и персональные данные сотрудников не пересылаются.
Что потребуется
- Возможности API-интеграция и Чек-листы в подписке Synchra24.
- Доступ администратора с правом редактирования автоматизаций.
- Ваш Telegram-бот и доступный ему чат. Бота создают через официальный @BotFather в Telegram. Для личного чата сначала начните диалог с ботом; для группы добавьте его в нужную группу и разрешите отправку сообщений.
- Токен бота и ID чата. Для публичного канала допустим адрес вида
@channelusername, для группы обычно используется отрицательный числовой ID. У бота должны быть необходимые права в этом канале или группе. Не используйте имя пользователя личного аккаунта вместо ID чата.
Установка и настройка
- Установите автоматизацию из магазина. Она появится выключенной в Администратор → Автоматизации.
- Откройте Секретные переменные и создайте CHECKLIST_TELEGRAM_TOKEN со значением токена вашего бота.
- Создайте CHECKLIST_TELEGRAM_CHAT_ID со значением ID выбранного чата или адресом публичного канала. Эти значения не входят в опубликованный продукт; каждый клиент задаёт собственные.
- Откройте установленную автоматизацию. Проверьте, что выбран запуск checklist.failed. Не меняйте его на
checklist.submitted: второй включает и результаты без нарушений. - Нажмите Проверить конфигурацию. Для проверочного запуска используйте пример события с положительным количеством нарушений. Проверочный запуск формирует сообщение, но не отправляет его в Telegram.
- Когда бот и чат подготовлены, включите автоматизацию. Отправьте тестовый чек-лист с одним нарушением в своей компании и проверьте сообщение и историю выполнения. Если уведомления не нужны, выключите автоматизацию.
Пример сообщения
Synchra24 · Нарушение в чек-листе
Результат чек-листа №1042
Нарушений: 2
Время события: 2026-10-26 09:15:00 UTC
Откройте этот результат в разделе «Чек-листы» Synchra24, чтобы увидеть пункты и подробности.
Событие: example-event-id
Это пример с вымышленными данными. В рабочем уведомлении используются сведения фактического события.
Ограничения и диагностика
- Работает только для новых событий после включения; ранее отправленные чек-листы не обходятся. Пока чек-лист не отправлен, уведомления нет. Чек-лист без нарушений сообщение не создаёт.
- К одному событию относится одно сводное уведомление, а не отдельное сообщение на каждый пункт. Название чек-листа, фотографии, комментарии и имена сотрудников не запрашиваются.
- Для отправки нужна связь серверов Synchra24 с Telegram. Проверочный запуск не проверяет фактическую доставку. Отказ Telegram виден в истории; проверьте токен, ID и права бота.
- Дополнительные HTTP-повторы отключены, чтобы уменьшить риск дублей при неопределённом ответе. Событийная доставка асинхронная; при сбоях повторное уведомление полностью не исключается. Идентификатор события помогает сопоставить дубли.
- Токен хранится только в секретных переменных компании. Не вставляйте его в код, описание или скриншоты. Не пересылайте токены продавцу.
- Сообщения используют простой текст, без HTML/Markdown-разметки. Отдельный сервер интеграции не нужен.
Документация: запуск по событиям, секретные переменные, проверка и история. Формат отправки соответствует официальному Telegram Bot API.
