Интеграция со Slack

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

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

Создайте вебхук в Slack

Нужны права на добавление приложений в рабочее пространство Slack. Если в вашем пространстве приложения одобряют только администраторы, Slack сначала попросит одобрения у одного из них.

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

Входящие вебхуки описаны в справке Slack на английском: Sending messages using incoming webhooks.

Любой, у кого есть адрес вебхука, может писать в этот канал. Не публикуйте его, например в репозиториях с кодом: Slack отключает адреса вебхуков, которые находит в открытом доступе.

Отправка оповещений в Slack

Откройте Оповещения и нажмите Новое оповещение или значок карандаша (Редактировать) у существующего правила.
Задайте название, область, временное окно и условие правила — они описаны в разделе Оповещения.
В блоке Уведомлять через выберите Slack и вставьте адрес в поле URL вебхука Slack.
Нажмите Создать оповещение или Сохранить изменения для существующего правила.

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

Что приходит в сообщении

Каждый раз, когда правило срабатывает, в канал приходит короткое текстовое сообщение на английском: название правила, домен, сколько ответов за временное окно подошли под условие и почему правило сработало. Самих ответов в нём нет — откройте срабатывание в Оповещениях, чтобы их увидеть.

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

Если сообщения не приходят

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