Slack連携とは？
Slack連携では、ARROZで保存したコンテンツを、指定したSlackチャンネルへ共有できます。
共有時には、コンテンツのタイトル、コンテンツ種別、識別コード、本文プレビュー、ARROZ上のコンテンツURLがSlackへ投稿されます。
※Slack連携は、BusinessまたはAPI連携が有効なCustomプランで利用できます。
Slack側の事前確認
Slack連携を利用するには、対象ワークスペースへARROZアプリを追加できるユーザーで操作してください。
ワークスペースでアプリの利用承認が必要な場合は、Slackのオーナーまたはアプリ管理者による承認が必要です。
また、接続テストおよび実際の共有先として使用するチャンネルをあらかじめ用意してください。
ARROZとSlackを接続する
- ARROZの「設定・契約」→「API連携設定」を開きます。
- 「Slack」を選択します。
- 「Slackに接続」をクリックします。
- Slackの認証画面で、接続するワークスペースを確認します。
- 表示された権限を確認して許可します。
- 「Slackとの接続が完了しました」と表示されたら、その画面を閉じてARROZへ戻ります。
- Slackの接続一覧を開き直し、追加されたワークスペースを選択します。
- 「テスト投稿先」からチャンネルを選択します。
- 「接続テスト」を実行します。
- ARROZ上で接続成功のメッセージが表示され、Slackの対象チャンネルにテストメッセージが投稿されることを確認します。
接続テストではSlack APIを使用するため、月間API利用回数にカウントされます。
ARROZアプリをチャンネルへ追加する
選択したチャンネルにARROZアプリが参加していない場合は、そのチャンネルで次のコマンドを実行します。
/invite @ARROZ
その後、ARROZのAPI連携設定画面へ戻り、もう一度接続テストを実行してください。
非公開チャンネルを使用する場合も、ARROZアプリを対象チャンネルへ明示的に追加する必要があります。
Slackへコンテンツを共有する
- ARROZで対象コンテンツを保存します。
- 生成結果または保存済みコンテンツからSlackへの共有を選択します。
- 表示された接続先とチャンネルを確認します。
- 「共有する」をクリックします。
- Slackの対象チャンネルで投稿内容を確認します。
Slackには主に次の情報が共有されます。
- コンテンツタイトル
- コンテンツ種別
- コンテンツ識別コード
- 本文プレビュー
- ARROZ上の保存済みコンテンツへのURL
Slackへの共有は、コンテンツそのものをSlackへ移行する機能ではありません。
ARROZ上のコンテンツをチーム内で確認・共有するために利用します。
共有先チャンネルを変更する
Slackへの共有先は、接続テストで選択したチャンネルになります。
共有先を変更する場合は、
- 「設定・契約」→「API連携設定」→「Slack」を開きます。
- 対象のSlack接続を選択します。
- 「テスト投稿先」を変更します。
- 新しいチャンネルで接続テストを実行します。
接続テストが成功すると、そのチャンネルが以降の共有先になります。
Slackへ投稿できない場合
Slackへの投稿に失敗する場合は、次の内容を確認してください。
- ARROZアプリが対象チャンネルへ参加しているか
- 正しいワークスペースへ接続しているか
- 対象チャンネルが削除・アーカイブされていないか
- 非公開チャンネルの場合、ARROZアプリが明示的に追加されているか
- ワークスペース側でアプリ利用が制限されていないか
ARROZアプリが参加していない場合は、対象チャンネルで /invite @ARROZ を実行し、再度接続テストを行ってください。
接続を変更・削除する場合
Slackの接続アカウントやワークスペースを変更する場合は、OAuth接続をやり直し、接続テストを再実行してください。
不要になった接続はARROZから削除できます。
接続を削除しても、すでにSlackへ投稿されたメッセージはSlack側に残ります。不要な投稿はSlack上で削除してください。