Новый инцидент → MAX
Сообщение в MAX при создании инцидента: номер, название и ссылка на раздел инцидентов в Synchra24.
Для кого
Для руководителей, диспетчеров и ответственных за работу с инцидентами, которым нужны уведомления в командном чате MAX.
Что решает
Сообщает о новом инциденте в подтверждённый чат через общего бота Synchra24. Не нужно создавать собственного бота или передавать токен. Подробности остаются в Synchra24.
Новый инцидент → MAX
Сообщение в MAX при создании инцидента: номер, название и ссылка на раздел инцидентов в Synchra24.
Что делает расширение
При создании инцидента отправляет одно краткое сообщение в подтверждённый чат MAX. В сообщении — номер инцидента, название, время события в UTC и ссылка на раздел Инциденты. Нужную карточку найдите по номеру из сообщения. Длинное название сокращается. В технической строке указан ID события.
Ответы формы, комментарии, вложения, исполнитель и личные данные сотрудников не пересылаются. Само название инцидента может содержать введённые пользователем данные — выбирайте чат с подходящим кругом участников. Изменение статуса, назначение исполнителя и комментарии отдельного сообщения не создают.
Проверочный пример
В проверочном запуске выберите событие incident.created и подготовьте payload.id, payload.number и payload.title. Укажите компанию текущего запуска. Сообщение появится только после реального создания нового инцидента при включённой автоматизации.
Подключение
- Установите расширение в нужную компанию. Новая автоматизация будет выключена.
- Откройте Администратор → Автоматизации → Чаты MAX. Для подключения нужны лицензия API-интеграция и право управления интеграциями.
- По ссылке в окне откройте общего бота Synchra24. Добавьте его в групповой чат или канал MAX с правом отправлять сообщения. Отправьте в этом чате
/chatid— бот сообщит ID. В обычном личном диалоге подключение не работает. - В Synchra24 оставьте имя подключения default, укажите ID чата и нажмите Отправить код в MAX. Введите шесть цифр из чата и нажмите Подключить чат. Токен бота вводить не нужно.
- В установленной автоматизации нажмите Проверить конфигурацию и выполните проверочный запуск с примером нужного события. Такая проверка не отправляет сообщение в MAX. Затем отдельно включите автоматизацию.
- Создайте тестовое событие в компании, проверьте сообщение в MAX и историю автоматизации. Удалите тестовую запись обычным способом, если она больше не нужна.
Общий бот может быть ещё не подключён оператором Synchra24: в таком случае расширение можно сохранить, но включение будет доступно после подключения бота и подтверждения чата. Внешняя доставка пока не подтверждена на реальном боте.
Чаты и безопасность
Оба готовых расширения MAX используют подключение default текущей компании. Если нужны разные чаты, создайте подключения с разными именами и укажите соответствующее имя в назначении автоматизации. Коды и токен не включены в пакет. Знание ID чата само по себе не позволяет включить отправку: требуется код из этого чата. Доступ к ссылкам в Synchra24 проверяется отдельно по правам пользователя.
Код действует 10 минут и допускает пять попыток ввода. Доступно до пяти запросов кода за час на компанию и на чат, включая неудачные отправки. Одна компания может подтвердить до 20 подключений. После удаления бота из MAX связь отзывается; повторное добавление требует нового подтверждения. Удаление подключения в Synchra24 останавливает будущие отправки через это имя; уже отправленное сообщение не отзывается.
Ограничения
- Работает с новыми событиями после включения. Старые записи не выгружаются.
- Это серверная автоматизация, отдельного виджета на дашборде или экрана в мобильном приложении нет. События могут возникать из веб- и мобильной версии, если действие создаёт нужное системное событие.
- Используется облачная веб-версия Synchra24. Ссылки на отдельные коробочные серверы этим пакетом не поддерживаются.
- Нет гарантии мгновенной доставки. При недоступности MAX, ограничении частоты или неопределённом результате отправки смотрите историю. Автоматического повтора MAX-отправки нет, чтобы уменьшить риск дублей; успешный запуск означает подтверждение API MAX, а не прочтение человеком.
- Бот отвечает только на
/chatid; обычные сообщения чата не сохраняются и не анализируются. Для определения ID MAX передаёт платформе входящие обновления, остальное содержимое сразу отбрасывается. - Передавайте уведомления только в разрешённые компанией чаты. Все участники чата увидят отправленные данные. Не размещайте секреты или чувствительные данные в названиях инцидентов.
Отключение
Выключите автоматизацию. Если чат больше не нужен для других автоматизаций, откройте Чаты MAX, нажмите кнопку удаления у подключения и подтвердите отключение. Чтобы прекратить уведомления от обеих автоматизаций, выключите обе или отключите используемое ими подключение.
