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 分钟。
- 一个 LINE 官方账号(在 LINE 官方账号管理后台 中创建)。如果您还没有账号,请使用您的 LINE Business ID 登录并创建一个新账号——为其命名并填写简短的表格。
- 该 OA 的 Messaging API 频道。最简单的方法是在 OA 管理后台内启用它(请参阅下方的第 1 步)——您不必先在开发者控制台中手动创建频道。出现提示时,选择现有的提供商 (provider) 或创建一个新的。
- 从该频道中获取三个值,您将把它们粘贴到本应用中:
- Channel ID(“基本设置”选项卡)——可选,仅供参考
- Channel secret(“基本设置”选项卡)
- Channel access token —— 您在 Messaging API 选项卡上签发的长期令牌
标准(未认证)官方账号不需要任何商业文件——只需一个 LINE Business ID。认证(蓝色徽章)是可选的,且仅在部分地区提供。
设置 LINE
第 1 步:为您的官方账号启用 Messaging API
- 登录 LINE 官方账号管理后台(如果还没有,请先创建一个官方账号)。
- 打开您的 OA。
- 点击设置(右上角)。
- 在设置菜单中,点击 Messaging API。
- 状态最初显示为已禁用——点击以启用它。
- 为此频道选择提供商(拥有该频道的公司/开发者)。如果您还没有提供商,请创建一个新提供商,然后确认。
第 2 步:从开发者控制台获取您的凭据
启用 Messaging API 会在 LINE 开发者控制台 中您的提供商下创建一个频道。
- 打开开发者账号 / 提供商。
- 点击进入 Messaging API 频道。
- 打开 Basic settings(基本设置)选项卡,复制您的 Channel ID 和 Channel secret。
- 打开 Messaging API 选项卡,签发(或重新生成)一个长期有效的 Channel access token,并将其复制。
请妥善保存这些值——您接下来需要将它们粘贴到应用程序中。
第 3 步:在应用程序中连接 LINE
- 在左侧边栏中,点击底部的 Settings(设置)。
- 在“设置”左侧导航栏的 Channels(频道)下,点击 Channels。
- 找到 LINE 卡片并点击 Connect(连接)。
- (可选)粘贴您的 Channel ID——仅供参考。
- 粘贴您的 Channel secret。
- 粘贴您的 Channel access token。
- 点击 Connect。
- 应用程序会向 LINE 验证凭据,并显示 “Connected to: <您的 OA 名称>”。如果凭据错误,您会收到错误提示——请在 LINE 开发者控制台中重新签发访问令牌并重试。
第 4 步:在 LINE 中设置 Webhook URL
连接后,应用程序会显示一个带有 webhook URL 的 Finish setup in LINE(在 LINE 中完成设置)部分——请复制该 URL。(Webhook URL 只是一个网址;将其粘贴到 LINE 中可以告诉 LINE 将新消息自动发送到哪里。)然后,在您的 Messaging API 频道的 LINE Developers Console(LINE 开发者控制台)中:
- 打开 Messaging API 选项卡。
- 将 URL 粘贴到 Webhook URL 中。
- 点击 Update(更新)。
- 将 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 步:测试机器人
- 使用另一部手机(例如您自己的 LINE 应用程序),将您的官方账号添加为好友并发送一条消息。
- 打开应用程序并进入 Chats(聊天)——收到的消息会出现在对话列表中。
- 如果有 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) — 任何拥有它的人都可以以您的官方账号名义发送消息。如果发生泄露,请在开发者控制台中重新签发。