SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场line-notification-message

line-notification-message

办公与效率

查看项目

更新于 10-15 10:47

技能介绍

用途

LINE Notification Messages 用于按电话号码向 LINE 用户发送通知类消息，即使该用户尚未将 LINE 官方账号添加为好友也能送达。该服务仅面向企业，仅在日本、泰国、台湾地区提供，且不得用于广告或商业目的。

两种消息类型

  • 模板类型（Template）：使用预定义布局，通过 templateKey、itemKey、buttonKey 配置内容，设置简单，无需 UX 审核。发送端点为 POST /v2/bot/message/pnp/templated/push，返回 202。该类型于 2025 年 6 月新增。
  • 灵活类型（Flexible）：可自由构造消息对象（Flex Message、文本等），设计自由度更高，但需要事先通过 UX 审核。发送端点为 POST /bot/pnp/push，返回 200。

两种类型均不允许发送图片、视频或音频。

主要能力与接口

发送（模板）：POST /v2/bot/message/pnp/templated/push，返回 202。 发送（灵活）：POST /bot/pnp/push，返回 200。 计数（模板）：GET /v2/bot/message/delivery/pnp/templated?date=yyyyMMdd，返回 200。 计数（灵活）：GET /v2/bot/message/delivery/pnp?date=yyyyMMdd，返回 200。

域名为 api.line.me，所有端点速率限制为 2,000 请求/秒。不支持 X-Line-Retry-Key，请勿使用重试键。请勿在频道安全设置中限制服务器 IP，否则可能导致发送失败。

使用方式

  1. 电话号码哈希：先规范化为 E.164 格式（含国家代码、无连字符），如 +818000001234；再用 SHA256 哈希，得到 64 位小写十六进制字符串，作为收件人标识。
  2. 发送：按所选类型调用对应端点，携带 Authorization: Bearer {channel_access_token}。模板类型可附带可选的 X-Line-Delivery-Tag 追踪标签。
  3. 送达确认：API 返回 200/202 并不保证送达，需通过 delivery 类型 webhook（event.type = "delivery"）确认实际送达；24 小时内未收到 webhook 表示消息未送达。

环境变量：LINE_CHANNEL_ACCESS_TOKEN（Messaging API 频道的机器人访问令牌）、LINE_CHANNEL_SECRET（频道密钥，用于 webhook 签名验证）。

发送条件

以下条件必须全部满足：电话号码与用户 LINE 账号匹配；电话号码有效（已通过短信认证）；用户同意接收 LINE 通知消息；用户未屏蔽该 LINE 官方账号；电话号码签发地为日本、泰国或台湾地区；用户已同意 LINE 隐私政策（2022 年 3 月修订版）。

用户同意状态

  • 同意（开启）：消息正常送达。
  • 拒绝（关闭）：消息被删除，不送达。
  • 未设置：用户收到同意提示，需在 24 小时内同意，否则消息被删除。

同意是全局性的，一旦同意即适用于所有 LINE 官方账号。

短信认证

每 180 天需要认证一次；账号创建或电话号码变更后的 180 天内无需认证。

适用场景与限制

适用于企业向非好友用户发送通知类消息（如发货完成等）。限制包括：仅限日本、泰国、台湾地区；仅限企业；不得用于广告或商业推广；不支持图片、视频、音频；灵活类型需事先通过 UX 审核；不支持重试键；不得限制服务器 IP。

参考资料索引

  • references/api-common.md：先读。速率限制、状态码、错误处理、前向兼容。
  • references/sending-api.md：发送 API（模板 + 灵活）、计数 API、请求/响应规范、错误码。
  • references/template-system.md：模板结构：templateKey、itemKey、buttonKey、字段限制、国家后缀。
  • references/technical-specs.md：电话号码哈希、发送条件、同意流程、短信认证、计费、IP 限制。
  • references/delivery-webhook.md：送达完成事件、X-Line-Delivery-Tag、用户同意流程、非好友行为。
  • references/experts.md：LINE Notification Messages 领域专家，用于架构指导。

SDK

官方 SDK 支持 Python、Node.js、Go、Java、PHP、Ruby。其他语言可使用 LINE OpenAPI 规范配合 OpenAPI Generator。

注意事项

不要凭记忆回答 LINE Notification Messages 相关问题——LINE 频繁更新 API，训练数据不可靠，应始终查阅上述参考资料。