# Workbot for Slack の設定
代わりに2分間の動画ガイドもご覧いただけます
このページでは、Workbot レシピやユーザー操作を作成できるように、Slack オーガナイゼーション内で Workbot を設定する手順について説明します。
ステップ1 : Workbot の対話型インターフェイスに対して NLU プロバイダを使用する場合は、NLU プロバイダに接続します。使用しない場合は、このステップは飛ばします。
ステップ2 : Enterprise Workbot を作成する場合は、カスタム OAuth プロファイルを設定します。作成しない場合は、このステップは飛ばします。
ステップ3 : Workbot for Slack コネクションを作成します。
ステップ4 : Workbot をチャンネルに招待します。
# 準備として行うこと
- 接続する権限があることを確認します。これは、オーガナイゼーションの Slack ワークスペースの設定により決まります。Slack ワークスペースのすべてのメンバーにサードパーティアプリのインストールを許可するオーガナイゼーションもあれば、この権限を管理者にのみ制限しているオーガナイゼーションもあります。
- コネクションの設定には、人が使用しているアカウントではなく、統合ユーザーアカウントを使用することをお勧めします。
# 権限
トークンのタイプ | スコープ | 説明 |
---|---|---|
User | users:read | ユーザーのアイデンティティについての情報を表示します。 |
users:read.email | ユーザーの情報をメールで取得します。 | |
Bot | app_mentions:read | ボットが参加している会話で、ボットのメンションをリッスンします。 |
channels:read | 公開されている会話のリストを取得します。 | |
chat:write | 公開されている会話を作成または更新します。 | |
files:read | プライベートの会話のリストを取得します。 | |
files:write | プライベートの会話を作成または更新します。 | |
groups:read | ダイレクトメッセージの会話のリストを取得します。 | |
im:history | ダイレクトメッセージの会話を作成または更新します。 | |
im:write | 多人数グループの会話を作成または更新します。 | |
mpim:read | 多人数グループの会話のリストを取得します。 | |
users:read | ユーザーの情報を取得します。 | |
users:read.email | ユーザーの情報をメールで取得します。 |
# 1. NLU プロバイダに接続する
Workbot for Slack では、Google DialogFlow と Amazon Lex がサポートされています。いずれかの NLU プロバイダを使用する場合は、Workbot for Slack に接続する前に、NLU プロバイダを Workato に接続する必要があります。
NLU プロバイダに接続するには、[App Connections] に移動し、[Create a new connection] を選択します。NLU プロバイダを選択します。
# 2. カスタム OAuth プロファイルを設定する
カスタム OAuth プロファイルを使用すると、Workbot for Slack の名称やアイコン (ボット名、ボットのロゴ、背景色)、権限などをカスタマイズできます。新しいカスタム OAuth プロファイルを設定するには、[Tools] > [Custom OAuth profiles] に移動し、[Create custom profile] をクリックします。
[Application] フィールドで [Workbot for Slack] を選択します。[Create new app] をクリックします。
これにより、新しいタブで Slack アプリ (opens new window)が開きます。
Slack ウィンドウで [Create new app] を選択します。
[From scratch] を選択します。これにより、ユースケースに応じてスコープと権限を定義できるようになります。
アプリのわかりやすい名前を入力し、このアプリのデプロイメント先の Slack ワークスペースを選択します。 [Create App] をクリックします。
新たに作成された Slack アプリの [Basic Information] ページにリダイレクトされます。
[App credentials] セクションまでスクロールし、以下の情報を保存します。
- クライアント ID
- クライアントシークレット
- 検証トークン
Workato の設定に戻ります。Slack アプリからのアプリの資格情報を入力します。完了したら、[Save] をクリックします。
[Application token] フィールド
このフィールドは空のままにします。[Application token] はオーガナイゼーションレベルのアプリ用の設定です。
Slack の設定に戻ります。左側のナビゲーションで [OAuth & Permission] を選択します。
Add a new Redirect URL
を選択します。コールバック URL をコピーして、Slack の設定に貼り付けます。[Save URLS] をクリックします。
https://workato.com/oauth/callback
This doesn’t seem like a proper link
「This doesn’t seem like a proper link」というエラーが表示された場合は、リンクの先頭または最後に余分なスペースが入っていないことを確認してください。
[OAuth & Permissions] の設定を続けます。[Scopes] に移動し、[Bot Token Scopes] で以下のスコープを選択します。
- app_mentions:read
- chat:write
- channels:read
- commands
- files:read
- files:write
- groups:read
- im:history
- im:write
- mpim:read
- users:read
- users:read.email
[OAuth & Permissions] の設定を続けます。[Scopes] の下の [User Token Scopes] で以下のスコープを選択します。
- users:read
- users:read.email
左側のナビゲーションで [App home] を選択します。
- 表示名とデフォルトのユーザー名を指定します。
- [Always Show My Bot as Online] を
ON
にします。
[App home] の設定を続けます。[Show tabs] > [Messages Tab] に移動します。
allow users to send message
オプションが選択されていることを確認します。これにより、ユーザーが Slackbot にメッセージを送信することが可能になります。
左側のナビゲーションで [Event Subscriptions] を選択します。
ON
を選択します。- Workato 設定で指定されているリクエスト URL を [Request URL] に入力します。以下は URL の例です。
https://app.workato.com/slack_webhooks/event?coak_id=9690
[Event Subscriptions] の設定を続けます。[Subscribe to Bot Events] サブセクションに移動します。以下の ボットユーザーイベント を追加します。
- app_mention
- file_shared
- message.im
- app_home_opened
ページの一番下で [Save Changes] を選択します。
左側のナビゲーションで [Interactivity & Shortcuts] を選択します。
ON
を選択します。- Workato 設定で指定されている URL を [Request URL] と [Options Load URL] に入力します。以下は URL の例です。
https://app.workato.com/slack_webhooks/event?coak_id=9690
ページの一番下で [Save Changes] を選択します。
最後に、Slack アプリをワークスペースにインストールします。
左側のナビゲーションで [Install App] を選択します。
- [Install to Workspace] を選択します。
- メッセージが表示されたら、[Allow] をクリックします。
# 3. Workbot for Slack コネクションを作成する
Workbot for Slack コネクションを接続すると、Slack チームに Workbot が追加されます。新しい Workbot for Slack コネクションを作成するには、[App Connections] に移動し、[Create a new connection] をクリックします。まず、[Workbot for Slack] を選択します。
Workbot for Slack コネクションの項目 | ||
---|---|---|
Application | Workbot for Slack | |
Connection name | このコネクションに対する適切な名前を選択します。 | |
NLU provider | 必要に応じて、DialogFlow または Amazon Lex NLU を選択できます。NLU プロバイダに接続していないと、プロバイダはドロップダウンリストには表示されません。 | |
Advanced | Slash commands verification tokens | 従来のカスタムインテグレーションのスラッシュコマンドの呼び出しに使用します。各スラッシュコマンドにはトークンがあります。複数のスラッシュコマンドをサポートするには、各トークンをカンマで区切ります。詳細についてはこちらを参照してください。 |
Custom help | 簡単なテキストヘルプまたは Slack メッセージに対応する JSON ドキュメントを使用した書式付きのヘルプを指定します。書式付きのヘルプメッセージは、Slack message builder を使用して作成できます。 | |
Is this a Classic Slack app? | アプリをまだ移行していない場合は、[Yes] を選択します。 | |
Custom OAuth profile | カスタム OAuth プロファイルを使用すると、Slack 側で作成した独自のカスタムアプリを Workato の Slack コネクターから利用できるようになります。選択すると、このアプリに対するすべてのリクエストで、指定したプロファイルが使用されます。詳細については、こちらを参照してください。 |
Workbot を Slack チームにインストールすると、Workbot により Workato アカウントで最後に使用したアプリコネクションが検出され、自動的に接続されます。
Workbot を Slack オーガナイゼーションに追加すると、ダイレクトメッセージを使用して Workbot とやり取りできるようになります。Workbot とのダイレクトメッセージは、Workbot を追加したユーザーにしか見えません。
他のユーザーも Workbot とやり取りできるようにするか、Workbot が通知を投稿できるようにするには、Workbot を特定のチャンネルに招待する必要があります。次のセクションに進んでください。
# 4. Workbot をチャンネルに招待する
チャンネル内での Workbot との会話は、そのチャンネルのすべてのチームメンバーから見えます。
Workbot をチャンネルに招待するには、以下のいずれかの操作を実行します。
@workbot
を使って、Workbot をメンションする。- チャンネルの詳細の [Invite new members to join] メニューオプションを使用する。
Workbot をチャンネルに招待したら、@workbot
を使ってやり取りを開始します。
ダイレクトメッセージを使用して Workbot とやり取りする場合は、@workbot を使う必要はありません。
# 次のステップ
Slack での Workbot の設定が完了したため、次は初めての Workbot を構築します。
Last updated: 2023/8/31 1:07:14