WAthink 使用手册

LINE 官方账号接入教程:准备连接凭据、验证 HTTPS 回调并在收件箱接待好友消息

连接已授权的 LINE 官方账号,在团队收件箱中处理访客消息。按已开通的能力配置自动回复、流程、AI 接待、富菜单与广播,并核对 LINE 的消息额度和发送规则。

实际入口、可用参数与操作权限,请结合所用版本、套餐及已启用模块核对。
本篇内容

概览

LINE 通道用于连接一个 LINE 官方账号(Official Account),把它加为好友的人会与其他渠道的访客一样出现在团队收件箱中。LINE 是日本、台湾和泰国的主流即时通讯应用;它复用 WAthink 的自动回复、流程、AI 助手与广播 — 另加 富菜单与 Flex 消息等 LINE 专有能力。

无需应用审核。LINE Messaging API 通道为自助开通:自行创建、复制两个值即可连接,通常十分钟内完成。

通道工作原理

  • LINE 官方账号通过官方的 Messaging API 通信,使用 Channel access token 认证。
  • WAthink 会给你一个 Webhook URL,粘贴到 LINE 控制台。每条入站事件(消息、关注、postback、贴纸)都会即时推送到 WAthink。
  • 每次 Webhook 投递都由 LINE 签名,WAthink 会用你的 Channel secret 校验,因此伪造请求会被拒绝。
  • 用户通过把你的官方账号加为好友来联系你 — 可通过 LINE ID、二维码或 Add friend 链接。

创建通道与获取凭据

所有内容都来自 LINE 自己的开发者控制台。步骤如下:

  1. 创建 LINE Business ID。访问 developers.line.biz/console,用 LINE 账号或邮箱登录(或注册)。
  2. 创建 Provider。Provider 代表你的公司/组织。点击 Create a new provider 并命名。
  3. 创建 Messaging API 通道。在 Provider 内点击 Create a Messaging API channel。填写通道名称(客户看到的名称)、描述、类别与国家/地区。
  4. 打开 Messaging API 选项卡。创建后,打开该通道并切换到 Messaging API 选项卡。
  5. 签发 Channel access token。滚动到 Channel access token (long-lived),点击 Issue,复制出现的长字符串。
  6. 复制 Channel secret。切换到 Basic settings 选项卡,复制 Channel secret。
  7. 关闭 LINE 自带的自动回复。仍在 Messaging API 选项卡,打开 LINE Official Account features → Auto-reply messages 并设为 Disabled;如果希望由 WAthink 发送欢迎语,也把 Greeting messages 设为 Disabled。保留 LINE 内置自动回复会导致客户收到两条回复。
  8. 允许 Webhook。在同一屏幕把 Use webhook 设为 Enabled。
两个值都要保密。Channel access token 能以你的品牌名义发送消息,Channel secret 用于证明入站请求确实来自 LINE。任一泄露都请在控制台重新签发,并在 WAthink 中重新连接。

在 WAthink 中连接

  1. 打开 LINE 页面 — 菜单中的 Channels → LINE。
  2. 粘贴 Channel access token 与 Channel secret,然后保存。WAthink 会立即向 LINE 校验它们,成功后显示官方账号的名称与头像。
  3. 复制 WAthink 显示的 Webhook URL。形如 https://your-domain.com/api/line/inbound/<token> — 路径中的 token 是该通道独有的。
  4. 粘贴到 LINE。回到 LINE 控制台的 Messaging API 选项卡,把该 URL 填入 Webhook URL,点击 Update,再点击 Verify。LINE 应报告成功。
  5. 测试。把你的官方账号加为好友(扫描 Messaging API 选项卡上的二维码)并发送一条消息 — 几秒内就会出现在团队收件箱中。
你的站点必须能通过 HTTPS 访问。LINE 拒绝调用纯 http:// URL 或 IP 地址。如果 Verify 失败,几乎都是这个原因。

Token 轮换

LINE 支持轮换 Channel access token — 由密钥对签发的短期 Token,替代单个长期字符串。WAthink 两种都支持。如果你在 LINE 侧启用轮换,WAthink 会保存 key id,并在 Token 过期前自动刷新,通道不会中断。若使用简单的长期 Token,则无需额外配置。

API 限制与规则

规则含义
回复 vs 推送回复(用 LINE 的 reply token 回应入站事件)免费,但必须尽快发送,且每个事件只能回复一次。推送(主动给某人发消息)会消耗每月配额。WAthink 尽可能使用回复路径。
免费消息配额LINE 套餐包含每月一定数量的免费推送消息;超出后按条计费,免费套餐的推送会停止。请在 LINE Official Account Manager 中查看配额。
必须为好友你不能给未把你的官方账号加为好友的人发消息。LINE 上不存在冷启动外呼。
删除好友 / 屏蔽用户随时可以屏蔽或删除好友;发给他们的消息会失败。WAthink 会在下次广播时跳过他们。
群发规模广播分批发送。WAthink 会对发送限速,避免被 LINE 限流。

使用收件箱

  • 每个好友一个线程。每个给你的官方账号发消息的 LINE 用户都会得到一个线程,标注其 LINE 显示名称与头像。
  • 媒体。图片、视频、音频、文件、贴纸与位置消息可内联显示并回复。
  • 按钮与 Flex。流程中构建的快捷回复与 LINE Flex 消息卡片会在 LINE 应用中原生渲染。

富菜单

富菜单(rich menu)是固定在 LINE 聊天底部的可点击面板 — 为客户提供一组常驻快捷方式的最快途径。在 Channels → LINE → Rich menus 中上传菜单图片、定义点击区域,并把每个区域指向一条消息、一个 URL 或一个流程。发布后,它会显示给该账号的所有好友。

自动回复、流程与 AI

  • 自动回复。在自动回复中,把欢迎 / 离开 / 非工作时间 / 关键词规则限定到你的 LINE 通道。
  • 流程。在流程构建器中把触发节点的渠道设为 LINE。按钮、快捷回复、媒体与提问步骤均可在 LINE 上运行。
  • AI 助手。为通道指定一个 AI 助手,实现自动回复并转接人工。

LINE 广播

LINE 广播编辑器可触达所有已把你的官方账号加为好友的人。选择通道、挑选受众、撰写消息(带实时预览)并发送。设置了受众筛选时,WAthink 使用 LINE 的 narrowcast API,并对发送限速以遵守速率与配额限制。请记住广播属于推送消息,会消耗每月额度。

故障排查

现象原因与解决方法
LINE 控制台 Verify 失败Webhook URL 无法通过公网 HTTPS 访问,或粘贴时出错。请从 WAthink 的 LINE 页面重新复制并再次验证。
收不到消息LINE 控制台中的 Use webhook 仍为 Disabled,或 WAthink 中的 Channel secret 不匹配 — 此时签名校验会拒绝每次投递。
客户收到两条回复LINE 自带的 Auto-reply messages 功能仍处于启用状态。请在 LINE 控制台中关闭,只让 WAthink 回复。
发送失败并报配额错误本月的套餐免费推送消息已用完。升级 LINE 套餐或等待重置;对入站消息的回复仍然免费。
“Invalid reply token”该事件的回复窗口已过。WAthink 会自动回退为推送;无需处理。
仍需进一步帮助?查看反馈与支持方式

文档目录

返回官网

搜索操作文档

正在准备文档索引…

↑ ↓ 切换结果 · Enter 打开Esc 关闭