---
title: "应用推送通知：一个 API，一个平台"
description: "通过一个 REST API 向移动应用用户发送推送通知，可按用户 ID、设备令牌、主题或用户分群发送，并用短信或 WhatsApp 作为备用触达渠道。"
canonical: "https://omnichannels.ai/zh/channels/push-notifications/"
language: "zh"
updated: "2026-11-04"
publisher: "BroadNet Technologies"
brand: "OmniChannels.ai"
---

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

Canonical: https://omnichannels.ai/zh/channels/push-notifications/
Language: zh
Publisher: OmniChannels.ai by BroadNet Technologies

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

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

## 推送通知 API 能做什么

- **按用户、令牌、主题或分群定向:** 可使用您自己的用户 ID（userRefs）、明确的 FCM 设备令牌、FCM 主题，或按国家、城市、语言和标签定义的用户分群。
- **富媒体通知:** 可添加 HTTPS 图片、点击后打开的深度链接，以及“确认”“改期”等操作按钮。
- **已保存的模板:** 创建、预览、测试发送并发布带版本历史的模板，之后通过 templateId 和您自己的变量发送。
- **优先级、有效期与定时发送:** 可将时效性强的消息设为高优先级、设置有效期（TTL）、用折叠键替换旧通知，或定时发送。
- **发送前试运行:** 将 dryRun 设为 true，即可端到端校验请求内容，而不会向真实用户投递任何消息。
- **批次控制:** 可列出批次、查看批次详情，并通过批次接口暂停、恢复或中止批次。
- **基于位置触发通知:** 地理围栏可按位置触发通知。应您的要求，我们的团队会为您的应用启用地理围栏。
- **通过 Webhook 获取送达状态:** 在您账户配置的 Webhook 地址上跟踪送达状态，方式与其他渠道相同。

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

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

## 如何开始发送推送通知

1. **连接您的应用:** 我们的团队会连接您的 Firebase Cloud Messaging 项目，iOS 还会连接 APNs 凭据，并为您提供应用 ID。
2. **按用户 ID 注册设备:** 您的应用以您自己的标识符 userRef 注册每台设备，这样您就可以面向用户而不是令牌发送。
3. **用试运行检查请求内容:** 调用 POST /push/message/send 并将 dryRun 设为 true，在真实用户看到任何内容之前确认请求有效。
4. **发送或定时发送:** 可发送给 userRefs、令牌、主题或用户分群，也可定时发送。重复使用的消息可保存为模板。
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。开发者文档列出了所有推送接口。

## 官方来源

- [Firebase Cloud Messaging — Firebase](https://firebase.google.com/docs/cloud-messaging)
- [User Notifications — Apple Developer](https://developer.apple.com/documentation/usernotifications)

更新于: 2026-11-04