ユーザーからリアクションをいただいたタイミングで即座に通知することが可能です。Slack通知を行うことでslack上でメンバー同士でそのまま議論・解釈を進めることができます。

2023年11月以前提供開始の連携については、「Webhook」タイプの接客アクションを利用した方式を採用していました。2023年11月以降、「Webhook」タイプの接客アクションは新規提供を停止しています。

「Webhook」タイプの接客アクションを利用した古いSlack連携のドキュメントについては、下記URLをご覧ください。
https://support.karte.io/post/3wOYyztVP3wqEDDzM0SkPo

注意点

  • KARTE Craftを使った外部サービスへのWebhook連携を利用する必要があります
    • 対象プロジェクトで当該機能を利用していない場合は、事前にセットアップを完了してください
  • 設定にはエンジニアスキルが必要となり、個別のカスタマイズ方法についてはサポート対象外となります

Moment Reaction Slack通知

Moment Reactionから取得したデータをwebhookでSlack連携します。

null

通知内容

null

  • ページタイトルでReactionがありました。:リアクションが発生した閲覧ページ
  • 問いかけ:リアクションが発生した際の表示コメント
  • Reaction:選択された絵文字
  • KARTEでユーザーストーリーをみる:該当のユーザーのユーザーストーリー

設定方法

Slack側の事前準備

Sending messages using Incoming Webhooks | Slack を参考に、Slack側でWebhookリクエストを受け取れるようにします。

KARTE側の事前準備

KARTE Craftを使った外部サービスへのWebhook連携の手順に従ってSlackにWebhookリクエストを送信できる環境を整えます。

接客サービスの作成

下記テンプレートを利用して、KARTEからSlackにWebhookリクエストを送信するための接客サービスを作成します。

  • Craft Functions連携(Webhook用)

配信設定

  • 対象ユーザー
    • 全員
  • 対象イベント
    • 通知させたいイベントを選択します
    • 例:全てのリアクションを通知したい場合
      • moment_reaction > 送信日時 > 存在する

null

  • 例:特定行動(読了)を通知したい場合
    • moment_reaction > push_condition.event_name > 次に等しい finish_reading

null

  • オプション
    • 同時配信 ON

アクションの設定

ユーザー情報変数の作成

次のユーザー情報変数を作成します。

変数名 設定
reaction_type 最新のセッション Moment Reaction reaction_type の 最新の値
shown_message 最新のセッション Moment Reaction shown_message の 最新の値
url 最新のセッション Moment Reaction url の 最新の値
title 最新のセッション Moment Reaction title の 最新の値
reaction_comment 最新のセッション Moment Reaction reaction_comment の 最新の値

dataの設定方法

dataを次のように設定します

項目 説明
url SlackのIncoming WebhookのURLを指定します。例: https://hooks.slack.com/services/xxxxxxxxx/xxxxxxxxx/xxxxxxxxx
hookData Slackへの通知内容に応じて次のように設定します。随時カスタマイズしてください。
method "POST"を指定します
headers {"Content-Type": "application/json"}を指定します
campaignId "#{campaign_id}"を指定します

dataの設定例

  • hookData.attachments[].text内のxxxxxxxxxxは、KARTEプロジェクトのproject_idを入力してください
{
  "url": "https://hooks.slack.com/services/xxxxxxxxx/xxxxxxxxx/xxxxxxxxx",
  "hookData": {
    "username": "moment reaction bot",
    "icon_emoji": ":karte_v2:",
    "attachments": [
      {
        "color": "#2aab9f",
        "text": "<#{url}|#{title}>でReactionがありました\nComment:#{reaction_comment}\nReaction::#{reaction_type.replace('heart', 'smiling_face_with_3_hearts').replace('smile','simple_smile')}:\n<https://admin.karte.io/p/xxxxxxxxxx/user/#{user_id}|KARTEでユーザーストーリーをみる>"
      }
    ]
  },
  "method": "POST",
  "headers": {
    "Content-Type": "application/json"
  },
  "campaignId": "#{campaign_id}"
}

関連ドキュメント