Перейти до вмісту
Intum — Довідковий центр

Інтеграція з Google Chat

Оновлення: 3 хв читання

Сповіщення з Intum потрапляють прямо до кімнати в Google Chat. Ви можете підключити одну або багато кімнат (напр. окрему для продажів, окрему для dev-алертів) і надсилати до них повідомлення автоматично з інших місць системи.

Що ви отримуєте

  • Надсилання повідомлень до будь-якої кількості кімнат Google Chat
  • Кожна кімната - це окремий канал, якому ви можете надати власну назву (напр. «Алерти продакшн», «Продажі»)
  • Кнопка Тестування біля кожного каналу - ви вписуєте зміст і перевіряєте, чи повідомлення дійшло
  • Налаштування зводиться до вставлення одного URL-а з Google Chat

Встановлення

  1. Перейдіть у Налаштування облікового записуЗастосунки та додатки
  2. Знайдіть Інтеграція з Google Chat і натисніть Встановити
  3. Після встановлення застосунок доступний у меню ОрганізаціяНалаштування

Звідки взяти URL webhook

У самому Google Chat:

  1. Відкрийте кімнату, в яку мають потрапляти сповіщення
  2. З меню кімнати виберіть Застосунки та інтеграції
  3. Натисніть Додати webhook
  4. Надайте webhook назву (напр. «Intum») і підтвердіть
  5. Скопіюйте згенерований URL - це довге посилання, що починається з https://chat.googleapis.com/v1/spaces/...

Додавання каналу в Intum

  1. Відкрийте застосунок Інтеграція з Google Chat
  2. У полі Назва каналу впишіть власну назву (опціонально - якщо залишите порожнім, підставиться автоматично)
  3. Вставте скопійований URL webhook
  4. Натисніть Додати канал

Застосунок сам витягає з URL-а все необхідне (ідентифікатор кімнати, ключ і токен) і створює конектор. Після додавання автоматично відкривається тестова панель.

Тест надсилання

Біля кожного каналу у списку є кнопка Тестування. Після натискання розгортається поле для змісту повідомлення і кнопка Надіслати до Google Chat. Повідомлення потрапляє до обраної кімнати - якщо воно з’явиться, інтеграція працює.

Багато кімнат

Ви можете додати стільки каналів, скільки потрібно - просто вставте наступний URL webhook і додайте. Кожен канал має свій код (google_chat1, google_chat2…), видимий у списку. За цими кодами інші модулі системи можуть адресувати, до якої кімнати має потрапити сповіщення.

Видалення каналу

Натисніть назву каналу у списку, щоб побачити деталі. Внизу є дані конфігурації і кнопка Видалити конектор. Після видалення сповіщення до цієї кімнати перестають працювати - сама кімната в Google Chat залишається недоторканою.

Часті питання

Чи можу я змінити кімнату наявного каналу?
Найпростіше видалити старий канал і додати новий з URL-ом до іншої кімнати. Редагування доступне у вигляді деталей, але під час зміни кімнати вам однаково потрібно вставити новий webhook.

Чи можу я надсилати до потоку в кімнаті, а не до головного каналу?
Так - якщо URL webhook з Google Chat містить параметр threadKey, інтеграція його запам’ятовує і повідомлення потрапляють до цього потоку.

Що станеться, коли токен спливе?
Google Chat під час зміни webhook генерує новий URL. Тоді в Intum потрібно видалити старий канал і додати новий.

Чи була ця інформація корисною?

Поділитися

Коментарі