Slack連携

フィードバックに注意が必要なときに、Slackのチャンネルでメッセージを受け取れます。VoxtricsからSlackへの投稿はアラートを通じて行われます。アラートは、たとえば「1時間以内に評価2以下が3件以上」のように、届いた回答を監視するルールです。Slackとは、Slackが1つのチャンネル用に発行するウェブアドレスである Incoming Webhook で接続するため、Voxtrics側でインストールするものはありません。

SlackでWebhookを作成する

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の下にある新しいURLをコピーします。https://hooks.slack.com/services/T0000/B0000/XXXXXXXX のような形式です。

Incoming Webhookに関するSlack自身のガイド：Sending messages using incoming webhooks。

アラートをSlackに送る

  1. アラートを開き、新しいアラート、または既存のルールの鉛筆アイコン（編集）をクリックします。
  2. アラートの説明に従って、ルールの名前、対象範囲、時間枠、条件を設定します。
  3. 通知方法でSlackを選び、SlackのWebhook URLにURLを貼り付けます。
  4. アラートを作成、既存のルールの場合は変更を保存をクリックします。

Webhookは、作成したチャンネルにだけ投稿します。別のチャンネルでもアラートを受け取るには、そのチャンネル用のWebhookと、専用のルールを作成してください。複数のルールで同じWebhookを使うことはできます。

メッセージの内容

ルールが発生するたびに、チャンネルには短いテキストメッセージが届きます。ルールの名前、ドメイン、時間枠内で条件に一致した回答の数、ルールが発生した理由が含まれます。回答そのものは含まれません。回答を確認するには、アラートで該当する発生を開いてください。

ルールが発生するのは最大で30分に1回で、再発生間隔を設定した場合はそれより少なくなります。1つのスペースのアラートからSlackとTelegramに投稿されるメッセージは、合わせて1日最大200件です。それを超えてもルールは発生し、その発生は「アラート」に表示されますが、何も投稿されません。

メッセージが届かない場合

  • アラートが保存されない場合は、URLが https://hooks.slack.com/ で始まっているか確認してください。Voxtricsが受け付けるのはSlackのWebhookのアドレスだけで、チャンネルやメッセージへのリンクは受け付けません。
  • ルールが有効になっていて、発生しているかを確認してください。すべての発生はアラートに一覧表示されます。
  • ルールが発生しているのにSlackに何も届かない場合は、Webhookが機能しなくなっています。アプリが削除された、チャンネルがアーカイブまたは削除された、SlackがURLを無効にした、のいずれかです。新しいWebhookを作成して、ルールに貼り付けてください。