メインコンテンツへスキップ

EKB チャットボットを Slack に統合する

EKB と Slack を統合すると、インテリジェントでコンテキストを認識したチャットがワークスペースに直接導入され、チームは Slack を離れることなく AI エージェントと対話できるようになります。このガイドでは、Slack への EKB アプリのインストール、権限の構成、AI エージェントとのシームレスな通信のためのチャネルの設定について説明します。

警告

Each EKB project can only be linked to a single Slack app. You will need to create a new Slack app for each additional EKB project you want to connect.

前提条件​

  • あなたは次のものを持っています:
    • あなたのプロジェクトの project id が手元にあります
    • Slack で EKB アプリをセットアップするための API キー + シークレット のセット

Slack で EKB アプリをインストールしてセットアップする​

  1. Slack API Apps に移動します。 Slack ワークスペースへのログインが必要な場合があります。

  2. [アプリの作成] をクリックします。

  3. 最初からを選択します。

  4. アプリ名 (例: 「EKB Chatbot」) を入力します。

  5. アプリをインストールする 開発 Slack ワークスペース を選択します。

  6. [アプリの作成] をクリックします。

  7. 基本情報 セクションで、App ID、Client ID、Client Secret、Signing Secret、および Verfication Token の値をメモします。これらは、以下のステップ 11 でアプリを構成するために必要になります。

  8. 左側のサイドバーで、OAuth と権限:\ をクリックします。 ａ． [リダイレクト URL の追加] をクリックし、次の URL を入力します。

    https://ai-api.automationanywhere.com/slack/oauth

b. [追加] をクリックし、次に [URL を保存] をクリックします。 c. スコープの下に、次のボット トークン スコープを追加します。

  • app_mentions:read – アプリが参加している会話でボットが言及されているメッセージをボットが読めるようにします。
  • channels:history – ボットが、アプリがメンバーとなっているパブリック チャネル内のメッセージやその他のコンテンツを表示できるようにします。
  • channels:manage – ボットがチャンネルの作成、アーカイブ、名前変更などのチャンネルを管理できるようにします。
  • channels:read – ボットがワークスペース内のパブリック チャネルに関する基本情報を表示できるようにします。
  • chat:write – ボットがアプリとしてメッセージを送信できるようにします。
  • commands – ユーザーが呼び出せるスラッシュ コマンドをボットに追加できるようにします。
  • groups:read – ボットが、アプリがメンバーとなっているプラ​​イベート チャネルに関する基本情報を表示できるようにします。
  • im:history – アプリがメンバーになっているダイレクト メッセージ内のメッセージやその他のコンテンツをボットが表示できるようにします。
  • im:write – ボットがアプリとしてダイレクト メッセージを送信できるようにします。
  • users.profile:read – ボットがユーザー プロファイルを表示できるようにします。
  • users:read – ボットがワークスペース内のユーザーを表示できるようにします。
  • users:read.email – ボットがユーザーの電子メールを表示できるようにします。

  1. 左側のサイドバーで [アプリ ホーム] をクリックします。 [タブの表示] で、[メッセージ タブ] が有効になっていることと、その下のチェックボックスがオンになっていることを確認します。

  2. 左側のサイドバーで、スラッシュコマンド:\をクリックします。 ａ． [新しいコマンドの作成] をクリックします。 b. [コマンド] フィールドに、「/setup」と入力します。
    c. リクエスト URL フィールドに、次のように入力します。

    https://ai-api.automationanywhere.com/slack/events

d. 簡単な説明 フィールドに、「チャンネル設定」のような内容を入力します。
e.必要に応じて、[使用上のヒント] フィールドに長い説明を追加できます。
f. [保存] をクリックします。 11. 手順 7 で収集した値を使用して、次の API エンドポイント URL を入力します。

https://ai-api.automationanywhere.com/slack/custom_install/{client_id}/{client_secret}/{signing_secret}/{verification_token}

{client_id}、{client_secret}、{signing_secret}、および {verification_token} を、基本情報 セクションにある Slack アプリの値に置き換えます。 12. 新しいブラウザで完成した URL を開きます。これにより、[Slack に追加] ボタンのあるページにリダイレクトされます。このボタンをクリックして、ワークスペースにアプリをインストールします。 13. ワークスペースへのアクセス許可を要求するページにリダイレクトされます。 [許可] をクリックして、必要な権限を付与します。 14. インストールが成功したことを示す確認メッセージが表示され、Slack ワークスペースにリダイレクトされます。 15. サイドバーから イベント権限 に移動し、次の操作を実行します。
ａ． イベントの有効化を切り替えます。
b. リクエスト URL フィールドに、次のように入力します。``` https://ai-api.automationanywhere.com/slack/events

e. [**ボット ユーザー イベントの追加**] をクリックし、次の 2 つのイベント: `app_mention` と `message.im` を追加します。\
f. [**変更を保存**] をクリックします。
16. サイドバーから **対話性とショートカット** に移動し、次の操作を実行します。\
ａ． **インタラクティブ性**を切り替えます。\
b. **リクエスト URL** フィールドに、次のように入力します。```
https://ai-api.automationanywhere.com/slack/events
```c. [**変更を保存**] をクリックします。
17. Slack ワークスペースに移動すると、左側のサイドバーのアプリのリストに EKB アプリが表示されます。
<Check>
App is successfully installed in your Slack workspace! The next step is to run the setup command to configure a channel for EKB.
</Check>

## EKB アプリのチャネルをセットアップする

EKB のチャネルを設定するには、目的のチャネルで `/setup` コマンドを実行する必要があります。このコマンドは、EKB で動作するようにチャネルを設定します。

1. Slack ワークスペースを開き、EKB を設定するチャネルに移動します。
2. メッセージ入力ボックスに「`/setup`」と入力し、**Enter** を押します。
3. ポップアップが表示され、次の情報の入力を求められます。
- **チャンネル** – EKB に設定するチャンネルを選択します。\
<Note>
If you want to use the app in direct messages, select your own user name.
</Note>
- **プロジェクト ID**: EKB プロジェクト ID を入力します。
- **API キー**: EKB API キーを入力します。
- **API シークレット**: EKB API シークレットを入力します。
4. [**送信**] をクリックしてセットアップ プロセスを完了します。アプリは情報を検証し、チャネルを構成します。
5. セットアップが成功すると、EKB が正常にセットアップされたことを示す確認メッセージがチャンネルに表示されます。<br/>
<Check>
EKB is now set up in your selected channel! You can start interacting with the bot by mentioning it in messages or using the slash commands.
</Check>