Your AI Connector Docs

LINE

连接您自己的 LINE 官方账号,让您的 LINE 对话流入本应用,并由 AI 智能体进行回复。您只需粘贴 LINE Messaging API 凭据(Channel secret 和 access token)并设置一个 Webhook URL 即可完成连接,无需编写任何代码。


什么是 LINE 集成?

LINE 集成使用 LINE 官方的 Messaging API 将您拥有的 LINE 官方账号 (OA) 连接到本平台。这是 LINE 官方用于自动发送和接收消息的系统,无需您在 LINE 应用中手动输入。您与添加了您的 OA 为好友的用户之间的一对一聊天将可以在本应用内进行,并且 AI 智能体、广播功能和共享收件箱都可以在此基础上运行。

与 Telegram 或 WhatsApp Web 不同,这是一个官方集成——它使用 LINE 自有的 Messaging API,因此非常稳定且符合 LINE 的规则。由于 LINE 没有为第三方工具提供一键“连接”按钮,您需要在设置过程中粘贴一次 OA 的凭据。

可用性。 LINE 官方账号在日本、台湾、泰国和印度尼西亚最为常见,且在欧盟地区不可用。您需要一个在受支持地区注册的 LINE 官方账号才能使用此渠道。


开始之前

您需要在 LINE 的控制台中创建(或使用)三样东西。这是一次性设置,大约需要 5 分钟。

  1. 一个 LINE 官方账号(在 LINE 官方账号管理后台 中创建)。如果您还没有账号,请使用您的 LINE Business ID 登录并创建一个新账号——为其命名并填写简短的表格。
  2. 该 OA 的 Messaging API 频道。最简单的方法是在 OA 管理后台内启用它(请参阅下方的第 1 步)——您不必先在开发者控制台中手动创建频道。出现提示时,选择现有的提供商 (provider) 或创建一个新的。
  3. 从该频道中获取三个值,您将把它们粘贴到本应用中:
    • Channel ID(“基本设置”选项卡)——可选,仅供参考
    • Channel secret(“基本设置”选项卡)
    • Channel access token —— 您在 Messaging API 选项卡上签发的长期令牌

标准(未认证)官方账号不需要任何商业文件——只需一个 LINE Business ID。认证(蓝色徽章)是可选的,且仅在部分地区提供。


设置 LINE

第 1 步:为您的官方账号启用 Messaging API

  1. 登录 LINE 官方账号管理后台(如果还没有,请先创建一个官方账号)。
  2. 打开您的 OA。
  3. 点击设置(右上角)。
  4. 在设置菜单中,点击 Messaging API
  5. 状态最初显示为已禁用——点击以启用它。
  6. 为此频道选择提供商(拥有该频道的公司/开发者)。如果您还没有提供商,请创建一个新提供商,然后确认。

第 2 步:从开发者控制台获取您的凭据

启用 Messaging API 会在 LINE 开发者控制台 中您的提供商下创建一个频道。

  1. 打开开发者账号 / 提供商
  2. 点击进入 Messaging API 频道
  3. 打开 Basic settings(基本设置)选项卡,复制您的 Channel IDChannel secret
  4. 打开 Messaging API 选项卡,签发(或重新生成)一个长期有效的 Channel access token,并将其复制。

请妥善保存这些值——您接下来需要将它们粘贴到应用程序中。

第 3 步:在应用程序中连接 LINE

  1. 在左侧边栏中,点击底部的 Settings(设置)。
  2. 在“设置”左侧导航栏的 Channels(频道)下,点击 Channels
  3. 找到 LINE 卡片并点击 Connect(连接)。
  4. (可选)粘贴您的 Channel ID——仅供参考。
  5. 粘贴您的 Channel secret
  6. 粘贴您的 Channel access token
  7. 点击 Connect
  8. 应用程序会向 LINE 验证凭据,并显示 “Connected to: <您的 OA 名称>”。如果凭据错误,您会收到错误提示——请在 LINE 开发者控制台中重新签发访问令牌并重试。

第 4 步:在 LINE 中设置 Webhook URL

连接后,应用程序会显示一个带有 webhook URLFinish setup in LINE(在 LINE 中完成设置)部分——请复制该 URL。(Webhook URL 只是一个网址;将其粘贴到 LINE 中可以告诉 LINE 将新消息自动发送到哪里。)然后,在您的 Messaging API 频道的 LINE Developers Console(LINE 开发者控制台)中:

  1. 打开 Messaging API 选项卡。
  2. 将 URL 粘贴到 Webhook URL 中。
  3. 点击 Update(更新)。
  4. Use webhook(使用 Webhook)开关打开 (ON)。

第 5 步:修正官方账号管理器的设置(重要)

默认情况下,LINE 官方账号 (OA) 会自行处理聊天和自动回复,这会导致消息无法到达 AI。回到 LINE Official Account Manager,打开您的 OA 设置并进行如下配置:

设置 所需值 原因
聊天 (Chat) 开启 (On) 开启聊天功能以使对话能够通过(允许您使用聊天过滤器)。
响应模式 (Response mode) 聊天机器人 (Bot) 允许 API(您的 AI 代理)处理消息。“仅聊天”模式会拦截消息。
响应时间 / 自动回复消息 关闭 (Off) 禁用 LINE 自带的自动回复,以便由 AI 处理响应(这是导致“重复回复”的首要原因)。
问候消息 关闭 (Off) 防止 LINE 自带的自动问候与 AI 产生冲突。
Webhooks 开启 (On) 确保 LINE 将消息转发给应用程序。

如果应用程序提示您的账号处于 Chat mode(聊天模式),请在此处将其切换为 Bot mode(机器人模式)——否则机器人将无法接收或发送消息。

第 6 步:测试机器人

  1. 使用另一部手机(例如您自己的 LINE 应用程序),将您的官方账号添加为好友并发送一条消息
  2. 打开应用程序并进入 Chats(聊天)——收到的消息会出现在对话列表中。
  3. 如果有 AI 代理正在处理此频道,您会看到它自动回复了测试消息。

一旦连接成功、Webhook 设置完成且上述开关配置正确,您的 LINE 账号将在“频道”页面显示为 Connected(已连接),并且 AI 将会对收到的消息做出响应。


费用

LINE 是应用内的一个免费渠道——我们不收取每条消息的费用,也不收取月度连接费。请注意,LINE 自身的套餐推送消息(主动发送)有每月的限额,具体取决于地区和账户类型。在客户向您发送消息后的短时间内回复是免费的;主动发送/广播消息会计入您的 LINE 套餐配额。


媒体消息

系统可以识别传入的照片、视频、语音备忘录、文件、贴纸和位置,以便 AI 知道已发送媒体(对话中会添加简短说明)。在此版本中,AI 的外发回复支持文本和图片。长回复会自动截断至 LINE 的 5,000 字符限制。


会话管理

检查连接状态

您的 LINE 连接状态显示在“渠道”页面的 LINE 卡片上:

状态 含义
已连接 一个 LINE 官方账号已链接到此账户
未连接 未设置连接

每次您打开“渠道”页面时,该卡片还会重新检查您账户的聊天模式设置。如果您的 LINE 账户被切换回了聊天模式(这会阻止机器人接收或发送消息),卡片上会出现一个琥珀色的警告,提示您在 LINE 官方账号管理器中将其切回机器人模式——重新检查那里的第 5 步开关,警告会在下次访问时清除。

断开连接

打开 LINE 卡片并点击 管理,然后在打开的面板中点击 断开连接,并确认 移除 LINE?。这会从我们这边移除连接。要完全停止 LINE 发送事件,还需要在 LINE 开发者控制台中关闭 使用 Webhook(或删除 Webhook URL)。


限制

  • 每个连接仅限一个官方账号。 请分别连接每个官方账号;一个官方账号只能链接到一个账户。
  • 发送文本 + 图片。 AI 回复支持文本和图片;此版本不支持发送富媒体“Flex”/模板/轮播消息。
  • 地区。 LINE 官方账号在欧盟不可用;您需要一个在受支持地区(例如日本、台湾、泰国、印度尼西亚)的官方账号。
  • 回复时机。 LINE 的免费即时回复有较短的时间窗口;之后发送的消息会自动作为(计入配额的)推送消息发送。

故障排除

连接时凭据被拒绝

  • 请确保您创建的是 Messaging API 渠道(而非“LINE Login”)。
  • 在 Messaging API 选项卡上重新签发一个长期渠道访问令牌,并粘贴新的值。
  • 确认您从“基本设置”选项卡复制的是 Channel secret(而非 Channel ID)。

机器人未回复

  • 请确认开发者控制台 (Developers Console) 和 OA 管理后台 (OA Manager) 中的 Webhooks 均已开启
  • 请确认 Webhook URL 与应用中显示的一致。
  • 请确认 OA 管理后台中的 响应模式 (Response mode) 设置为 机器人 (Bot)(而非聊天)。

客户收到两条回复

  • 请在 OA 管理后台中关闭 自动回复消息 (Auto-response messages)欢迎消息 (Greeting messages) — LINE 的内置自动回复会与 AI 的回复同时发送。

消息未送达应用

  • 请核实联系人是否已将您的官方账号添加为好友(LINE 仅投递来自好友的消息)。
  • 请重新检查 Webhook URL,并确保 使用 Webhook (Use webhook) 已开启。

最佳实践

  • 完成 OA 管理后台的开关设置(机器人模式、开启 Webhooks、关闭欢迎消息 + 自动回复)— 大多数设置问题都源于此。
  • 及时回复,以确保回复在 LINE 的免费窗口期内,并节省您的推送配额。
  • 妥善保管您的访问令牌 (Access token) — 任何拥有它的人都可以以您的官方账号名义发送消息。如果发生泄露,请在开发者控制台中重新签发。