# 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 官方账号管理后台](https://manager.line.biz) 中创建）。如果您还没有账号，请使用您的 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 官方账号管理后台](https://manager.line.biz)（如果还没有，请先创建一个官方账号）。
2. 打开您的 OA。
3. 点击**设置**（右上角）。
4. 在设置菜单中，点击 **Messaging API**。
5. 状态最初显示为**已禁用**——点击以启用它。
6. 为此频道选择**提供商**（拥有该频道的公司/开发者）。如果您还没有提供商，请**创建一个新提供商**，然后确认。

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

启用 Messaging API 会在 [LINE 开发者控制台](https://developers.line.biz/console/) 中您的提供商下创建一个频道。

1. 打开**开发者账号 / 提供商**。
2. 点击进入 **Messaging API 频道**。
3. 打开 **Basic settings**（基本设置）选项卡，复制您的 **Channel ID** 和 **Channel 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 URL** 的 **Finish 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](https://manager.line.biz)，打开您的 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)** — 任何拥有它的人都可以以您的官方账号名义发送消息。如果发生泄露，请在开发者控制台中重新签发。