サポートサイト
こんにちは👋🏻どんなことでお困りですか?

Slack連携について

Joltでは、Slackと連携することでJoltで発生したイベントをSlackに通知し、そのままSlack上で承認や入力まで完結できます。

Slack連携でできること

💡

Joltでイベントが発生(パートナー申請・リード作成など)  ↓ 設定したSlackチャンネルに通知が届く  ↓ 通知に付いたボタンから、その場で承認・却下・入力ができる  ↓ 操作結果がJoltに反映され、Slackのスレッドにも記録される

 

事前準備

  • 通知を受け取るSlackワークスペースがあること
  • Joltのプログラムに対して管理者以上の権限を持っていること(連携設定・通知チャンネル設定の操作に必要です)
 

Slack連携の設定画面

Joltの管理画面より以下にアクセスします。

💡

プログラム設定 > 連携設定 > アプリ連携 > Slack

Notion image
 

設定手順

  1. Slackカードの 「設定」 をクリックします。
  1. 「Slackに接続」 をクリックします。Slackの認証画面が開きます。
  1. Slackの画面で通知を受け取るワークスペースを選択し、アクセスを許可します。このとき、Joltは次の権限を要求します。
    1. 💡
      • チャンネルへのメッセージ送信(chat:write / chat:write.public
      • チャンネル一覧の取得(channels:read / groups:read
      • ユーザー情報とメールアドレスの参照(users:read / users:read.email

      メールアドレスの参照は、Slackでボタンを押した人がJoltのどのユーザーかを照合するために使用します。

  1. 許可するとJoltの画面に戻り、ワークスペース名と 「接続済み」 が表示されます。
Notion image
Notion image
⚠️

Slackワークスペースの連携は組織(ベンダー)単位です。 1つのワークスペースが組織全体に適用されるため、他のプログラムの連携設定にも反映されます。プログラムごとに別々のワークスペースを連携することはできません。 一方、どのチャンネルにどのイベントを通知するかはプログラムごとに設定します。

 

通知チャンネルの設定

連携が完了すると、同じモーダル内に 「通知チャンネル設定」 が表示されます。「通知するチャンネルを追加」 から、通知先と通知するイベントを設定します。

項目
説明
通知チャンネル
通知を投稿するSlackチャンネル。入力して検索できます。先頭の記号は # が公開チャンネル、🔒 がプライベートチャンネルです
通知するイベント
そのチャンネルに通知するイベント。複数選択できます

設定したチャンネルは一覧に表示され、行ごとに通知のON/OFF・編集・削除ができます。一覧にはチャンネル名と、通知するイベントがタグで表示されます。

Notion image

プライベートチャンネルに通知する場合

プライベートチャンネルは、Joltアプリを招待するまでチャンネルの選択肢に表示されません。次の手順で招待してください。

  1. 通知したい非公開チャンネルを開きます。
  1. そのチャンネルで /invite @Jolt を実行し、Joltを追加します。
  1. Joltの通知チャンネル設定を開き直すと、選択肢に表示されるようになります。
⚠️

アプリを招待したプライベートチャンネルのチャンネル名と通知設定の内容は、そのチャンネルに招待されていないユーザーもJoltの管理画面上で閲覧できますのでご注意ください。

 

通知できるイベント

通知できるイベントはWebhookと共通で、7カテゴリ・14イベントです。イベントごとにSlackに表示される内容と、通知に付くボタンは以下のとおりです。

カテゴリ
イベント
通知に表示される主な項目
ボタン
パートナー
プログラム申請
パートナー / 申請者 / 特記事項
承認・却下
パートナー
パートナーステータス更新
パートナー / 申請者 / ステータス / コメント / 更新者
リード
リード作成
リード / 担当者名 / パートナー / リードソース / 補足情報
適格・不適格・活動ログを追加
リード
リードステータス更新
リード / 紹介元 / ステータス / コメント / 更新者
報酬
報酬作成
顧客 / 紹介元 / 紹介売上 / 報酬
承認・却下
報酬
報酬ステータス更新
顧客 / 紹介元 / 紹介売上 / 報酬 / ステータス / コメント / 更新者
顧客
顧客作成
顧客
取引レコードを追加
活動ログ
活動ログ作成
タイトル / 内容 / 日付
リファラー
リファラー登録
リファラー(氏名・メール) / 登録経路
リファラー
リファラー認証完了
リファラー(氏名・メール) / 認証完了日時
リファラー
リファラーブロック
リファラー(氏名・メール)
リファラー
リファラーブロック解除
リファラー(氏名・メール)
リファラー
リファラー リード作成
リード / 担当者名 / リファラー(氏名・メール) / リードソース
コンバージョンイベント
コンバージョンイベント作成
イベント名 / 金額 / リファラー / 発生日時

選択できるイベントはプログラムの種別・設定によって変わります(リファラー系はリファラー機能が有効なプログラム、コンバージョンイベントはBtoCプログラム、パートナー系はパートナー機能が有効なプログラムでのみ表示されます)。

 

Slackから直接操作する

一部の通知には操作ボタンが付いており、Joltの管理画面を開かずにSlackから処理できます。

通知
ボタン
動作
パートナー申請
承認 / 却下
パートナーのステータスを「アクティブ」または「却下」に更新します
リード作成
適格 / 不適格
リードのステータスを「適格」または「不適格」に更新します(リード一覧では「進行中」と表示されます)
リード作成
活動ログを追加
入力フォームが開き、そのリードに活動ログを登録します
報酬作成
承認 / 却下
報酬のステータスを「承認済」または「却下」に更新します
顧客作成
取引レコードを追加
入力フォームが開き、その顧客に取引レコードを登録します

操作できる人

Slackでボタンを押すと、Slackアカウントのメールアドレスと同じメールアドレスのJoltユーザーとして処理されます。

  • 承認 / 却下 / 適格 / 不適格 は、そのプログラムの管理者以上のみ実行できます。「一般」権限のユーザーが押した場合は「権限がありません(管理者以上が必要です)」と本人にのみ表示され、処理は行われません。
  • SlackのメールアドレスがJoltに登録されていない場合も、その旨が本人にのみ表示され処理は行われません。
⚠️

「活動ログを追加」「取引レコードを追加」には権限による制限がありません。 通知チャンネルに参加している方であれば実行できます。また、Slackのメールアドレスに一致するJoltユーザーが見つからない場合は、プログラムのオーナー名義で登録されます。

 

却下・不適格のときは理由を入力できる

「却下」「不適格」を押すと、理由の入力フォームが開きます。理由は任意で、未入力のまま確定することもできます。入力した理由は、ステータス更新通知やJoltの画面でコメントとして表示されます。

 

操作したあとの見え方

操作が完了すると、元の通知メッセージからボタンが消え、代わりに「(操作した人)が◯◯を承認しました」のような結果が表示されます。同じ内容はスレッドにも記録されるため、誰がいつ処理したかを後から追えます。

💡

Joltの管理画面や外部APIなどSlack以外の経路で処理した場合も、同じようにボタンが消えて結果が記録されます。そのため、Slackの通知が処理済みかどうかで判断できます。

 

処理済みのものは操作できません

対象
操作できる条件
リード
ステータスが「新規」の場合のみ。既に適格・不適格・取引成立・取引不成立に進んだリードは、古い通知のボタンからは変更できません
パートナー申請
現在のステータスから変更可能な場合のみ。承認・却下済みの申請は操作できません
報酬
現在のステータスから変更可能な場合のみ。既に支払準備中などに進んだ報酬は操作できません
 

活動ログ・取引レコードの入力項目

フォーム
入力項目
活動ログを追加
タイトル / 本文 / 活動日(すべて必須)
取引レコードを追加
取引金額(円・必須。1円以上の整数)

送信すると、登録された内容が元の通知のスレッドに投稿されます。

 

連携を解除する

Slack連携設定モーダルの 「連携解除」 から解除できます。

⚠️

連携解除はJoltの他のプログラムにも適用され、連携されているすべての通知設定が削除されます。 解除後に再度利用する場合は、ワークスペースの連携と通知チャンネルの設定をやり直す必要があります。

Slack側でJoltアプリをアンインストールした場合も同様に、Jolt側の連携情報と通知設定は破棄されます。

通知が届かないときは

確認すること
内容
通知がONになっているか
通知チャンネル設定の一覧で、対象チャンネルのスイッチがONになっているかを確認します
イベントが選択されているか
「通知イベントが未設定です」と表示されている場合、そのチャンネルには何も通知されません
非公開チャンネルへの招待
/invite @Jolt でJoltを招待しているかを確認します
💡

一時的なエラーで送信できなかった通知は、1分後・5分後・30分後・2時間後の順に自動で再送されます(最初の送信を含めて最大5回)。再送は5分ごとの処理でまとめて実行されるため、実際の再送時刻は多少前後します。ただし、連携が解除されている・アプリがアンインストールされているなど認証が無効になっている場合は再送されません。

 
🌱 このページは役に立ちましたか?
😞
😐
🤩