跳转到正文
OmniChannels.ai
菜单

应用推送通知：一个 API，一个平台

使用与短信、WhatsApp 和 RCS 相同的 REST API 向应用用户发送推送通知，再通过其他渠道触达尚未打开应用的用户。

咨询 API 专家预约在线演示
POST /push/message/sendcURL
curl -X POST https://api.broadnet.me/push/message/send \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "userRefs": ["user-10293"],
    "title": "Your order has shipped",
    "body": "Tap to track your parcel.",
    "deepLink": "https://example.com/orders/8842",
    "category": "UTILITY",
    "priority": "HIGH",
    "ttl": 3600
  }'

向 OmniChannels.ai API 发送推送通知的请求。数值为示例数据。

简短回答

更新于

OmniChannels.ai 是面向移动应用的推送通知服务和 API。您调用 POST /push/message/send，并提供标题、正文和受众：用户 ID、设备令牌、主题或用户分群。通知可附带图片、深度链接和操作按钮，可使用已保存的模板、定时发送，并可先用试运行进行校验。开通阶段，我们的团队会为您连接 Firebase Cloud Messaging 项目，iOS 还会连接 APNs 凭据。

值得信赖的基础设施Meta 官方 Business Solution ProviderGoogle RBM 合作伙伴GSMA 成员ISO/IEC 27001:2022ISO/IEC 27018ISO 9001:2015ISO 22301SOC 2 Type II符合 GDPR

推送通知 API 能做什么

推送、短信还是 WhatsApp：该选哪个？

推送触达已安装您应用的用户，短信和 WhatsApp 则触达手机号码。多数企业三者并用，并按每条消息的优先顺序选择渠道。

渠道触达对象最适合说明
推送通知已安装您的应用并注册了设备的用户应用内动态：订单状态、提醒、应用内优惠、重新激活用户用户在使用您的应用时，作为第一步。
WhatsApp按手机号码触达已授权的客户丰富的对话、模板、客服和回执需要对话或媒体内容时使用。
短信任何手机号码验证码、紧急提醒，以及没有安装应用或 WhatsApp 的客户作为通用的备用渠道。

如何开始发送推送通知

推送基于 Firebase Cloud Messaging 运行，iOS 则基于 Apple 的 APNs，因此需要先完成一个简短的开通步骤。

  1. 1

    连接您的应用

    我们的团队会连接您的 Firebase Cloud Messaging 项目，iOS 还会连接 APNs 凭据，并为您提供应用 ID。

  2. 2

    按用户 ID 注册设备

    您的应用以您自己的标识符 userRef 注册每台设备，这样您就可以面向用户而不是令牌发送。

  3. 3

    用试运行检查请求内容

    调用 POST /push/message/send 并将 dryRun 设为 true，在真实用户看到任何内容之前确认请求有效。

  4. 4

    发送或定时发送

    可发送给 userRefs、令牌、主题或用户分群，也可定时发送。重复使用的消息可保存为模板。

  5. 5

    添加备用渠道

    确定哪些消息需要第二渠道，例如验证码或配送提醒使用短信，并按场景设置顺序。

推送何时是合适的渠道？

适合以下情况

  • 您有移动应用，希望在无需手机号码的情况下触达已安装应用的用户。
  • 消息与应用内活动相关，例如订单状态、预约提醒或账户提醒。
  • 您希望推送、短信、WhatsApp 和其他渠道共用一个 API 和一种 Webhook 格式。
  • 您希望按自己的用户 ID 发送，而不是管理设备令牌。

开始前需要了解的事项

  • 推送只能触达已安装您的应用并允许通知的用户。
  • 文档中的 API 覆盖通过 FCM 和 APNs 实现的移动应用推送。超出此范围的需求，请在规划前先咨询我们的团队。
  • 验证码或关键提醒不要只依赖推送，请添加短信或语音作为备用。
  • 地理围栏需应要求为您的应用启用。

推送通知服务常见问题

什么是推送通知服务？

推送通知服务把短消息从您的服务器发送到用户设备，即使应用已关闭也能送达。Android 通过 Firebase Cloud Messaging 投递，iOS 通过 Apple 的 APNs 投递。OmniChannels.ai 这样的服务位于两者之前，为您提供统一的 API。

推送通知 API 如何工作？

您的应用用令牌注册每台设备，后端再带上受众和内容调用 API，服务随后把通知交给 FCM 或 APNs 投递。在 OmniChannels.ai 中，您调用 POST /push/message/send，并可按自己的用户 ID 定向用户。

推送通知和短信有什么区别？

推送触达已安装应用并允许通知的用户，并且需要数据网络。短信无需应用即可触达任何手机号码。推送适合应用内更新和用户互动，短信适合验证码、紧急提醒和没有安装您应用的客户。

可以向一部分用户分群发送推送通知吗？

可以。除用户 ID、设备令牌和主题外，API 还接受包含国家、城市、语言和标签等条件的分群对象，并需提供您的应用 ID。您也可以定时发送，并为其添加活动名称。

发送前可以测试推送通知吗？

可以。将 dryRun 设为 true 即可校验请求而不实际投递。对于模板，您可以用示例数据预览，并在发布版本前向自己的设备发送测试。

可以添加图片、链接和按钮吗？

可以。通知可包含 HTTPS 图片、点击后打开的深度链接、供应用使用的自定义数据，以及操作按钮，每个按钮都有 ID、标题和动作。您还可以发送仅数据消息和静默消息。

如果用户没有打开应用或关闭了通知怎么办？

推送无法触达这些用户。对于重要的消息，请配置回退到短信或 WhatsApp 等其他渠道。回退顺序按场景设置，送达状态以统一的 Webhook 格式返回。

如何开始？

请预约演示。开通阶段，我们的团队会连接您的 Firebase 项目和 APNs 凭据，并为您提供应用 ID，之后您就可以用令牌调用 API。开发者文档列出了所有推送接口。

资料来源

相关指南

了解平台更多功能

为您的消息体系加入推送

请介绍一下您的应用。我们将连接 FCM 和 APNs，并让您在短信和 WhatsApp 旁边看到推送的实际效果。

请分享您的技术栈以及想要连接的内容，解决方案工程师会与您跟进。

咨询 API 专家

我们将用它回复您。任何企业域名均可。

选填。如希望电话沟通，请附上国家区号。

补充详情（选填）
您感兴趣的渠道(选填)

我们的团队将就您的集成需求与您联系。