# Slack 連携

GROWI を Slack と連携することによって様々なコマンドを実行できます。 セットアップについては管理者ガイドをご参照ください。

# GROWI bot でできること

# ヘルプコマンド

  1. /growi help を入力すると GROWI bot で使うことができる、コマンド一覧が表示されます。

    HackMD Demo

# ページの作成

  1. /growi note を入力すると GROWI 内に新規ページが作成されます。
HackMD Demo

# ワークスペース内の全文検索

  1. /growi search [キーワード] を入力すると検索結果が表示されます。

    • 例: /growi search example

      slack-bot-full-text-search-display-result-command
    • 検索結果

      slack-bot-full-text-search-display-result
    • Next ボタンをクリックすると、次の検索結果を表示します。

      slack-bot-full-text-search-click-next
    • Share ボタンをクリックすると、チャンネル内に共有されます。

      slack-bot-full-text-search-click-share
  2. Slack ワークスペースを複数の GROWI に登録している場合、複数の GROWI から横断検索できます。(※ Bot type が Official bot と Custom bot with proxy の場合のみ使えます。)

    • 例: /growi search example

      slack-bot-full-text-search-display-result-command
    • 検索結果

      slack-bot-search-multi-growi

# Slack チャンネル内の会話からページを作成する (Alpha)

  1. /growi keep を入力します。
  2. Oldest datetime にページで使用したい最も古いメッセージの時刻を入力します。
  3. Newest datetime にページで使用したい最も新しいメッセージの時刻を入力します。
  4. Page path にページの作成パスを入力し、Create page します。 Oldest datetime から Newest datetime の間の会話が作成されるページに反映されます。
HackMD Demo

# Slack 内で GROWI ページのプレビュー (Unfurl 機能)

Unfurl 機能を利用することで Slack に GROWI のリンクを共有した際にスニペットを表示できます。 デフォルトでは無効のため、管理画面から有効化する必要があります。

slack-bot-unfurl

Public ではないページのスニペットは表示されません。

slack-bot-unfurl-private-page

# 接続中の GROWI を確認する

/growi status と入力することで、Slack ワークスペースと連携している GROWI を確認できます。(※ Bot type が Official bot と Custom bot with proxy の場合のみ使えます。)

slack-bot-growi-status

# Slack ワークスペースと GROWI App との連携を解除する

  1. /growi unregister [連携解除したい GROWI App の URL1] [連携解除したい GROWI App の URL2] ... と入力するとモーダルが表示されます。(※ Bot type が Official bot と Custom bot with proxy の場合のみ使えます。)

    • 入力例: growi unregister http://example.com http://growi.jp

      slack-bot-unregister-input-eg
    • 表示されるモーダル

      slack-bot-unregister-modal
  2. Submit ボタンをクリックします。

  3. 以下のように表示されたら、連携解除が完了しています。

    slack-bot-unregister-completed