跳至主要内容

Slack 集成使用指南

本指南将帮助您快速配置并使用 FormAgent.ai 与 Slack 的集成,实现访客对话自动同步到 Slack,让您的客服团队可以在 Slack 中查看和回复访客咨询。

✨ 功能特点​

  • 🚀 一键授权 - 通过 OAuth 快速连接您的 Slack 工作区
  • 🎯 可视化选择 - 授权后可直接选择接收消息的频道
  • 📊 自动同步对话 - 所有访客对话自动同步到 Slack
  • 👤 访客画像显示 - Thread 中包含访客详细信息(位置、设备、来源等)
  • 💬 双向消息同步 - 访客消息和客服回复实时双向同步
  • 🔄 人工接管 - 支持在 Slack 中一键开启/关闭人工服务

前提条件​

  • 已有 Slack 工作区账号
  • 已注册 FormAgent.ai 账号并创建 Agent
  • 管理员已完成 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 频道会自动创建一个新的 Thread
  2. Thread 开头包含访客画像信息:
    • 访客位置(城市、国家)
    • 设备信息(浏览器、操作系统)
    • 来源页面 URL
    • 访问时间
  3. Thread 中显示访客消息和 AI 自动回复
  4. Thread 底部有 "🚀 开启人工服务" 按钮

人工接管对话​

当您需要人工介入时:

  1. 在 Slack Thread 中,点击 "🚀 开启人工服务" 按钮
  2. 系统会显示提示: "人工服务已开启"
  3. 此时 AI 自动回复会暂停
  4. 在 Thread 中回复访客,访客会实时收到您的消息
  5. 访客的后续回复也会实时同步到这个 Thread

结束人工服务​

当对话结束或希望 AI 恢复自动回复时:

  1. 在 Slack Thread 中点击 "结束人工服务" 按钮
  2. 按钮状态会变回 "🚀 开启人工服务"
  3. AI 会恢复自动回复访客的新消息

常见问题​

如何更换频道?​

  1. 在 Slack 中,将 FormAgent.ai Bot 添加到新频道(使用 /invite @FormAgent.ai 命令或通过频道设置添加)
  2. 进入 FormAgent.ai 集成配置页面
  3. 从下拉列表选择新频道
  4. 点击 "Save" 保存

💡 更换频道后,新对话会推送到新频道,旧对话的 Thread 仍在原频道

如何取消授权?​

方法 1: 在 FormAgent.ai 中取消

  1. 进入集成配置页面
  2. 点击 "Disconnect" 按钮
  3. 确认取消授权

方法 2: 在 Slack 中撤销

  1. 进入 Slack Workspace Settings
  2. 选择 "Apps" → "Installed Apps"
  3. 找到 FormAgent.ai,点击 "Remove"

多个 Agent 可以共用一个授权吗?​

可以,但不推荐。

  • ✅ 推荐做法: 每个 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. Redirect URL 配置错误
  2. 环境变量未正确配置

解决方法: 请联系您的系统管理员检查配置

支持​

如有疑问,请联系:

文档版本: v1.1 最后更新: 2025-11-26 更新说明: 调整步骤顺序,添加通过频道设置添加 Bot 的方法