Інтеграція зі Slack

Отримуйте повідомлення в канал Slack, коли відгуки потребують уваги. Voxtrics пише в Slack зі сповіщення — правила, яке стежить за новими відповідями, наприклад «щонайменше 3 оцінки 2 і нижче за годину». Slack підключається через вхідний вебхук (incoming webhook) — адресу, яку Slack видає для одного каналу, тож на боці Voxtrics нічого встановлювати не потрібно.

Назви пунктів меню Slack нижче наведено так, як вони виглядають в англійському інтерфейсі Slack.

Створіть вебхук у Slack

Потрібні права на додавання застосунків у робочий простір Slack. Якщо у вашому просторі застосунки схвалюють лише адміністратори, Slack спершу попросить схвалення в одного з них.

  1. Відкрийте свої застосунки Slack, натисніть Create New App і виберіть From scratch.
  2. Назвіть застосунок, наприклад Voxtrics, виберіть робочий простір і натисніть Create App.
  3. У налаштуваннях застосунку відкрийте Incoming Webhooks і ввімкніть Activate Incoming Webhooks.
  4. Натисніть Add New Webhook to Workspace, виберіть канал для сповіщень і дозвольте доступ. Щоб вибрати приватний канал, спершу приєднайтеся до нього.
  5. Скопіюйте нову адресу в розділі Webhook URLs for Your Workspace. Вона виглядає так: https://hooks.slack.com/services/T0000/B0000/XXXXXXXX.

Вхідні вебхуки описано в довідці Slack англійською: Sending messages using incoming webhooks.

Надсилання сповіщень у Slack

  1. Відкрийте Сповіщення і натисніть Нове сповіщення або значок олівця (Редагувати) в наявного правила.
  2. Задайте назву, область, часове вікно й умову правила — їх описано в розділі Сповіщення.
  3. У блоці Сповіщати через виберіть Slack і вставте адресу в поле URL вебхука Slack.
  4. Натисніть Створити сповіщення або Зберегти зміни для наявного правила.

Вебхук пише лише в той канал, для якого створений. Щоб сповіщення надходили й в інший канал, створіть для нього окремий вебхук і окреме правило. Один вебхук можна використовувати в кількох правилах.

Що надходить у повідомленні

Щоразу, коли правило спрацьовує, у канал надходить коротке текстове повідомлення англійською: назва правила, домен, скільки відповідей за часове вікно відповідають умові й чому правило спрацювало. Самих відповідей у ньому немає — відкрийте спрацювання в Сповіщеннях, щоб їх побачити.

Правило спрацьовує не частіше ніж раз на 30 хвилин, а з паузою між спрацюваннями — рідше. Сповіщення одного простору надсилають у Slack і Telegram разом не більше 200 повідомлень на день. Понад це правило все одно спрацьовує і спрацювання видно в Сповіщеннях, але повідомлення не надсилається.

Якщо повідомлення не надходять

  • Якщо сповіщення не зберігається, перевірте, що адреса починається з https://hooks.slack.com/. Voxtrics приймає лише адреси вебхуків Slack, а не посилання на канал чи повідомлення.
  • Перевірте, що правило ввімкнене і спрацьовувало: усі спрацювання видно в Сповіщеннях.
  • Якщо правило спрацювало, а в Slack нічого не надійшло, вебхук більше не працює: застосунок видалили, канал заархівували чи видалили, або Slack вимкнув адресу. Створіть новий вебхук і вставте його в правило.