#1803: Как настроить отправление уведомлений о событиях Swarmica вTelegram

Отредактирована: 7 дней назад

Инструкция

Для настройки оповещений в Telegram необходимо следующее:

  • ссылка на отправку сообщений через чат-бота вида https://api.telegram.org/bot<ТОКЕН>/sendMessage
  • Идентификатор чата(ChatID)

1. Авторизуйтесь в Swarmica как Администратор.

2. Создайте вебхук в Настройки - Исходящие вебхуки, введите Название, URL, метод - POST и в поле Данные введите данные вида:

{
  "text": "<message_text>",                     # шаблон текста уведомления
  "parse_mode": "markdown",                     # тип форматирования текста уведомления
  "disable_web_page_preview": true|false,       # отключение предпросмотра. Можно отключить(установить значение true), чтобы не загромождать экран чата
  "disable_notification": true|false,           # отключение уведомления на конечном устройстве(например, мобильный телефон). Для отключения необходимо установить значение true 
  "reply_to_message_id": null|"<message_id>",   # сообщение будет отправлено, как ответ на другое сообщение. Явно ставитсяnull, чтобы избежать случайного ответа.
  "chat_id": "<ChatID>"                         # идентификатор чата
}

нажмите Сохранить

Выглядеть должно примерно вот так:

Подробнее о формировании текста уведомления можно узнать здесь.

3. На открывшейся странице в поле Заголовки добавьте данные вида:

{
  "accept": "application/json",
  "User-Agent": "<Sender_identificator>",
  "content-type": "application/json"
}

здесь "User-Agent" - это идентификатор источника сообщение. Например, можно указать "Swarmica telegram bot".

и нажмите Сохранить

В итоге выглядеть должно примерно вот так:

4. Создайте действие по событию в Настройки - Действия по событию - Создать - Исходящий вебхук

5. На открывшейся странице введите Название, в качестве Действия выберите созданный вебхук, выберите Тип события, установите необходимые условия, установите Статус - включен и нажмите Сохранить. Например, для события создание новой заявки настройки будут выглядеть так: