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

Slack連携ガイド

本ガイドでは、FormAgent.aiとSlackの連携を素早く設定し、訪問者との会話を自動的にSlackに同期させ、カスタマーサービスチームがSlack内で訪問者からの問い合わせを確認・返信できるようにする方法をご紹介します。

✨ 機能​

  • 🚀 ワンクリック認証 - OAuthでSlackワークスペースに素早く接続
  • 🎯 ビジュアル選択 - 認証後、インターフェースから直接メッセージ受信チャンネルを選択可能
  • 📊 自動会話同期 - すべての訪問者会話が自動的にSlackに同期
  • 👤 訪問者プロフィール表示 - スレッドに訪問者の詳細情報（位置、デバイス、参照元など）を表示
  • 💬 双方向メッセージ同期 - 訪問者メッセージとエージェント返信がリアルタイムで同期
  • 🔄 人間による引き継ぎ - Slack内でワンクリックで人間によるサービスの有効化/無効化をサポート

前提条件​

  • Slackワークスペースアカウント
  • 作成済みのAgentを持つFormAgent.aiアカウント
  • 管理者がSlack Appの設定を完了していること（未設定の場合は、システム管理者にお問い合わせください）

クイックスタート​

ステップ1：連携設定ページに移動​

  1. FormAgent.ai管理ダッシュボードにログイン
  2. Agentを選択
  3. 「Settings」 → 「Integrations」 → 「Slack」 に移動

ステップ2：Slackに接続​

  1. ページ上の 「Connect to Slack」 ボタンをクリック
  2. ブラウザがSlack認証ページにリダイレクトされます
  3. 認証するWorkspaceを選択
  4. 権限リストを確認し、「Allow」 をクリックして認証

認証が成功すると、ページは自動的にFormAgent.aiに戻ります。

ステップ3：チャンネルにBotを招待​

⚠️ 重要：FormAgent.ai Botが追加されたチャンネルのみ、次のステップのチャンネルリストに表示されます。

Slackでチャンネルを開くまたは作成し、次のいずれかの方法でBotを追加します：

方法1：コマンドを使用（推奨）

チャンネルでコマンドを入力：

/invite @FormAgent.ai

方法2：チャンネル設定から追加（コマンドに不慣れなユーザー向け）

  1. Slackチャンネルで、チャンネル名をクリックしてチャンネル詳細を開く
  2. 「Integrations」（連携）タブを選択
  3. 「Add apps」（アプリを追加）をクリック
  4. FormAgent.ai を検索
  5. 「Add」 ボタンをクリックしてBotをチャンネルに追加

Botがチャンネルに正常に参加すると、FormAgent.aiでそのチャンネルを選択できるようになります。

ステップ4：メッセージ受信チャンネルを選択​

FormAgent.ai連携設定ページに戻ります：

  1. ドロップダウンからメッセージ受信チャンネルを選択（先ほどBotを追加したチャンネル）
  2. 「Save」 をクリックして設定を保存
  3. 「連携を有効にする」 トグルをオンにする

💡 ヒント:

  • ドロップダウンリストには、FormAgent.ai Botが追加されたチャンネルのみが表示されます
  • チャンネルが表示されない場合は、まずSlackでそのチャンネルにBotを追加してください
  • 再認証せずに、いつでもチャンネルを変更できます

機能の使用​

訪問者会話の確認​

訪問者がウェブサイトでメッセージを送信すると：

  1. Slackチャンネルに新しいスレッドが自動作成されます
  2. スレッドのヘッダーには訪問者プロフィール情報が含まれます：
    • 訪問者の位置（都市、国）
    • デバイス情報（ブラウザ、オペレーティングシステム）
    • 参照元ページURL
    • アクセス時間
  3. スレッドに訪問者メッセージとAI自動返信が表示されます
  4. スレッドフッターに 「🚀 人間によるサービスを開始」 ボタンがあります

人間による引き継ぎ​

人間による介入が必要な場合：

  1. Slackスレッドで、「🚀 人間によるサービスを開始」 ボタンをクリック
  2. システムにプロンプトが表示されます：「人間によるサービスが有効になりました」
  3. AI自動返信が一時停止します
  4. スレッド内で訪問者に返信すると、訪問者がリアルタイムでメッセージを受信します
  5. 訪問者のその後の返信もリアルタイムでこのスレッドに同期されます

人間によるサービスの終了​

会話が終了するか、AIに自動返信を再開させたい場合：

  1. Slackスレッドで 「人間によるサービスを終了」 ボタンをクリック
  2. ボタンのステータスが 「🚀 人間によるサービスを開始」 に戻ります
  3. AIが訪問者の新しいメッセージへの自動返信を再開します

よくある質問​

チャンネルを変更するには？​

  1. Slackで、新しいチャンネルにFormAgent.ai Botを追加（/invite @FormAgent.ai コマンドまたはチャンネル設定を使用）
  2. FormAgent.ai連携設定ページに移動
  3. ドロップダウンから新しいチャンネルを選択
  4. 「Save」 をクリック

💡 チャンネルを変更すると、新しい会話は新しいチャンネルにプッシュされ、古い会話のスレッドは元のチャンネルに残ります

認証を取り消すには？​

方法1：FormAgent.aiで取り消す

  1. 連携設定ページに移動
  2. 「Disconnect」 ボタンをクリック
  3. 取り消しを確認

方法2：Slackで取り消す

  1. Slack Workspace Settingsに移動
  2. 「Apps」 → 「Installed Apps」 を選択
  3. FormAgent.aiを見つけて 「Remove」 をクリック

複数のAgentで1つの認証を共有できますか？​

できますが、推奨されません。

  • ✅ 推奨：各Agentが個別に認証し、異なるチャンネルを選択可能
  • ⚠️ 認証の共有：すべてのAgentのメッセージが同じチャンネルに送信され、混乱を招く可能性があります

チャンネルリストが空の場合は？​

考えられる原因:

  1. まだどのチャンネルにもFormAgent.ai Botを追加していない
  2. Slackでどのチャンネルにも参加していない
  3. OAuth Scopesに必要な権限がない（管理者にお問い合わせください）

解決方法:

  1. まず、Slackでチャンネルを作成または参加
  2. 次に、そのチャンネルにFormAgent.ai Botを追加（ステップ3を参照）
  3. 最後に、FormAgent.aiページを更新すると、チャンネルがドロップダウンに表示されます

💡 ヒント：ドロップダウンには、FormAgent.ai Botが追加されたチャンネルのみが表示され、参加しているすべてのチャンネルが表示されるわけではありません

認証リダイレクトが失敗する場合は？​

考えられる原因:

  1. リダイレクトURLの設定エラー
  2. 環境変数が正しく設定されていない

解決方法: システム管理者に連絡して設定を確認してください

サポート​

ご質問がある場合は、以下までお問い合わせください：

ドキュメントバージョン: v1.1 最終更新: 2025-11-26 更新内容: ステップの順序を調整し、Botを追加するGUI方法を追加