ユーザーからリアクションをいただいたタイミングで即座に通知することが可能です。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連携します。
通知内容
- ページタイトルで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 > 送信日時 > 存在する
- 例:特定行動(読了)を通知したい場合
- moment_reaction > push_condition.event_name > 次に等しい
finish_reading
- moment_reaction > push_condition.event_name > 次に等しい
- オプション
- 同時配信 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}"
}