Надіслати повідомлення в Microsoft Teams при додаванні запису

Мова: Українська

Цю статтю перекладено з англійської за допомогою ШІ, тому вона може містити помилки. Ваші відгуки допоможуть нам її покращити.

У цьому посібнику ми налаштуємо автоматизацію, яка надсилає повідомлення в канал Microsoft Teams щоразу, коли до форми додається новий запис — безпосередньо з ActivityInfo, без будь-яких проміжних сервісів.

Ми виступаємо в ролі координатора, команда якого працює в каналі Teams. Команда відстежує проєкти у формі Проєкти і хоче, щоб кожен новий поданий проєкт оголошувався в каналі одразу після його надходження.

Що вам знадобиться

Форма для відстеження. У нас це форма Проєкти з текстовим полем Назва проєкту з кодом NAME та полем посилання Партнер з кодом PARTNER, але підійде будь-яка форма — просто налаштуйте посилання на ваші поля.
Дозвіл на дизайн бази даних в ActivityInfo.
Канал Microsoft Teams та дозвіл на додавання до нього робочого процесу. Teams отримує вебхуки через додаток Workflows (старі конектори "Incoming Webhook" Office 365 були виведені з експлуатації Microsoft).

| Ми посилаємося на поля за їхнім кодом (NAME, а не [Назва проєкту]). Якщо ваші поля ще не мають кодів, приділіть хвилину, щоб додати їх у конструкторі форм — коди роблять шаблони читабельними та зберігаються при зміні назв. || --- |

Крок 1: Створіть робочий процес вебхука в Teams

У Teams перейдіть до каналу, який має отримувати повідомлення, і натисніть ⋯ (Більше параметрів) поруч із назвою каналу.
Виберіть Workflows.
Виберіть шаблон вебхука — з назвою "Send webhook alerts to a channel" або "Post to a channel when a webhook request is received", залежно від вашої версії Teams.
Назвіть робочий процес, наприклад, "ActivityInfo", підтвердьте команду та канал і додайте робочий процес.
Скопіюйте URL-адресу, яку Teams відображає після створення робочого процесу — вона починається з https://prod-...logic.azure.com/... або подібного.

Крок 2: Додайте автоматизацію

В ActivityInfo відкрийте базу даних, виберіть форму Проєкти та виберіть Автоматизація на панелі деталей форми.
Виберіть Додати автоматизацію і назвіть її "Оголошувати нові проєкти в Teams".
Виберіть Натисніть тут, щоб почати та виберіть тригер При додаванні запису.
Дайте назву тригеру, виберіть Вибрати форму, оберіть форму Проєкти, підтвердьте та виберіть Готово.

Крок 3: Додайте крок вебхука

Виберіть Додати крок, потім Дія, потім Викликати вебхук.
Дайте кроку назву, наприклад, "Опублікувати в каналі Teams".
Вставте URL-адресу робочого процесу Teams у поле URL вебхука.
Встановіть Формат корисного навантаження на Налаштування, щоб ми могли написати саме той текст повідомлення, який очікує робочий процес Teams.

Крок 4: Напишіть повідомлення

Виберіть Редагувати корисне навантаження.
Введіть текст повідомлення — об'єкт JSON з єдиною властивістю text, який робочий процес вебхука Teams публікує в каналі. Посилання ${...} заповнюються з запису, що запустив автоматизацію; список полів праворуч вставляє їх для вас:
```
{"text": "Подано новий проєкт: ${NAME} від ${PARTNER.NAME}, додано користувачем ${_user.name}"}
```
Значення автоматично екрануються для JSON, тому назви проєктів, що містять лапки або розриви рядків, не можуть пошкодити повідомлення.
Натисніть Готово, щоб закрити редактор корисного навантаження, і ще раз Готово, щоб закрити крок.
Виберіть Зберегти. Тепер автоматизація активна.

Крок 5: Тестування

Додайте тестовий запис до форми Проєкти.
За кілька миттєвостей повідомлення з деталями проєкту з'явиться в каналі Teams.

Розширені повідомлення за допомогою адаптивних карток

Робочий процес Teams також приймає Адаптивні картки, які можуть містити заголовки, жирний текст, факти, колонки та кнопки, що посилаються назад на ActivityInfo. Створіть дизайн картки, а потім вставте її в редактор корисного навантаження, обернувши в конверт повідомлення та додавши посилання ${...} там, де мають бути значення запису:

{
  "type": "message",
  "attachments": [
    {
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
        "type": "AdaptiveCard",
        "version": "1.4",
        "body": [
          {
            "type": "TextBlock",
            "size": "Medium",
            "weight": "Bolder",
            "text": "Подано новий проєкт"
          },
          {
            "type": "TextBlock",
            "text": "**${NAME}** від ${PARTNER.NAME}, додано користувачем ${_user.name}",
            "wrap": true
          }
        ]
      }
    }
  ]
}

Текст в адаптивній картці відображає **подвійні зірочки** як жирний шрифт.

Що далі

Оголошувати лише деякі проєкти: додайте крок фільтрації між тригером та вебхуком — наприклад, CONTAINS(SECTORS, "Охорона здоров'я"), щоб оголошувати лише проєкти у секторі охорони здоров'я.
Оголошувати зміни статусу: використовуйте тригер При редагуванні запису з фільтром STATUS != _previous.STATUS та включіть обидва значення в повідомлення: ${_previous.STATUS} → ${STATUS}.

Схожі статті

Крок вебхука — детальний опис усіх форматів корисного навантаження
Надіслати повідомлення в Google Chat при додаванні запису
Опублікувати робочий процес при отриманні запиту вебхука в Teams (зовнішнє посилання)
Конструктор адаптивних карток (зовнішнє посилання)

Наступний елемент

Тригер: При додаванні запису