如何将 UnifyPort 与 OneSignal 结合用于全渠道消息传递

OneSignal 擅长通过推送通知、电子邮件、短信和应用内消息与用户互动。UnifyPort 擅长通过单一 API 在 WhatsApp、Telegram、LINE、TikTok、Zalo 和 X 等社交渠道上发送和接收消息。将两者结合，您可以在自有渠道和社交渠道上编排互动，而无需为每个平台构建单独的集成。

本指南解释了这两个平台如何互补，逐步介绍集成工作流，提供实用示例，并帮助您决定这种组合何时是合适的选择。

为什么结合 UnifyPort 和 OneSignal？

First viewport screenshot of onesignal.com.

onesignal.com 的首屏截图。

OneSignal 是一个客户互动平台，被超过 200 万家企业使用，为 20 万个应用提供支持，每年向 15 亿月活跃用户发送 1.3 万亿条消息。它通过 Journeys、个性化、分析、A/B 测试和权限管理提供推送通知、电子邮件、短信、应用内消息和 AI 驱动的生命周期营销。

UnifyPort 是一个统一消息 API 平台，通过单一 REST API 和标准化 Webhook 事件流连接 WhatsApp、Telegram、LINE、TikTok、Zalo 和 X。团队无需为每个社交渠道维护单独的集成，只需一次 POST /v1/messages 调用即可发送消息，并接收规范化事件（如 message.received），其中包含提供商、账户、对话、发送者和消息数据，且模式一致。官方 SDK 适用于 Node.js、PHP、Go 和 Python。

两者结合解决了一个常见问题：互动团队可以在用户偏好的渠道上触达用户，无论是应用内的推送通知还是手机上的 WhatsApp 消息，而无需重复受众逻辑或为每个社交平台构建自定义连接器。

集成如何工作

First viewport screenshot of onesignal.com.

onesignal.com 的首屏截图。

从高层来看，UnifyPort 处理社交消息层，而 OneSignal 处理受众细分、旅程编排和跨渠道互动。两个系统通过 API 和 Webhook 通信。

核心集成模式

连接平台有三种常见模式：

1. OneSignal 触发 UnifyPort 消息。 当用户进入 Journey 步骤或收到推送通知时，Webhook 或服务器端调用通过 UnifyPort 向用户首选的社交渠道发送消息。
2. UnifyPort 事件馈送 OneSignal 受众。 当用户在 WhatsApp 或 LINE 上回复时，UnifyPort 的 message.received Webhook 触发。您的后端处理事件并更新 OneSignal 用户属性或触发 Journey。
3. 双向编排。 结合两种模式，使社交回复影响推送活动，推送互动影响社交跟进。

数据流概述

典型的双向流程如下：

• 用户在您的应用中注册，并在 OneSignal 中注册用户 ID。
• 您的后端将该 OneSignal 用户 ID 链接到 UnifyPort 对话或账户标识符。
• OneSignal 发送推送通知；如果用户未互动，Journey 步骤调用您的后端，后端通过 UnifyPort 发送 WhatsApp 消息。
• 用户在 WhatsApp 上回复；UnifyPort 触发 message.received；您的后端更新 OneSignal 属性并将用户标记为“通过 WhatsApp 回复”。
• OneSignal 使用该标签抑制进一步的推送通知或触发后续 Journey。

先决条件

开始之前，请确保您拥有：

• 一个 UnifyPort 工作区，至少连接了一个消息账户（WhatsApp、Telegram、LINE、TikTok、Zalo 或 X）。
• 一个 OneSignal 账户，您的应用已配置推送、电子邮件或短信。
• 一个后端服务（Node.js、PHP、Go 或 Python），能够接收 Webhook 并发出 HTTP 请求。
• 两个平台的 API 密钥已安全存储。

分步设置

步骤 1：配置您的 UnifyPort 消息账户

在您的 UnifyPort 工作区中连接您想要使用的社交渠道。对于基于二维码的提供商，请遵循消息账户二维码认证中描述的认证流程。连接后，记下账户 ID 和提供商名称；发送消息时需要这些信息。

步骤 2：设置 OneSignal 受众和属性

在 OneSignal 中，定义将驱动跨渠道逻辑的用户属性和标签。例如：

• preferred_channel: whatsapp、telegram、line 等
• social_opt_in: true 或 false
• last_social_reply: 时间戳

这些属性让 OneSignal Journeys 根据渠道偏好和互动历史进行分支。

步骤 3：跨平台链接用户身份

在您的 OneSignal 用户 ID（或外部 ID）与 UnifyPort 对话或发送者标识符之间创建映射。将此映射存储在您的后端数据库中。当用户在社交渠道上回复时，UnifyPort 的 Webhook 负载包含发送者和对话数据，您可以使用这些数据查找对应的 OneSignal 用户。

步骤 4：通过 UnifyPort 从 OneSignal Journeys 发送消息

OneSignal Journeys 支持调用外部服务的 Webhook 步骤。配置一个 Journey 步骤来调用您的后端端点，然后通过 UnifyPort 的 POST /v1/messages API 发送消息。您的后端应：

1. 接收包含用户 ID 和消息模板的 OneSignal Webhook 负载。
2. 查找用户的社交渠道标识符和首选渠道。
3. 使用适当的提供商、账户 ID、收件人和消息内容调用 UnifyPort。
4. 记录响应以进行分析和错误处理。

步骤 5：处理 UnifyPort Webhook 并更新 OneSignal

订阅 UnifyPort 的 message.received 事件。当用户在社交渠道上回复时，您的后端应：

1. 验证 Webhook 签名。
2. 解析规范化的事件负载（提供商、账户、对话、发送者、消息）。
3. 将发送者映射到 OneSignal 用户 ID。
4. 通过 OneSignal API 更新 OneSignal 属性或标签。
5. 可选地触发 OneSignal 事件或 Journey。

步骤 6：测试和监控

通过两个平台发送测试消息。验证推送通知触发社交消息、社交回复更新 OneSignal 属性，以及 Journeys 根据渠道偏好正确分支。监控两个 API 的送达率和错误响应。

实用示例

示例 1：跨推送和 WhatsApp 的废弃购物车恢复

一个电子商务应用使用 OneSignal 在用户放弃购物车时发送推送通知。如果用户在两小时内未打开应用，Journey 步骤调用您的后端，后端通过 UnifyPort 发送一条包含个性化提醒和返回购物车深度链接的 WhatsApp 消息。当用户在 WhatsApp 上回复“是”时，UnifyPort 的 Webhook 更新 OneSignal 用户标签 cart_recovered: true，Journey 退出。

示例 2：带渠道回退的入门序列

一个金融科技应用使用 OneSignal Journeys 引导新用户。第一步是应用内消息；如果用户未完成个人资料，下一步发送短信。如果用户仍未互动，最后一步通过 UnifyPort 向日本或台湾的用户发送 LINE 消息。LINE 上的回复更新 OneSignal 属性，使 Journey 能够个性化后续步骤。

示例 3：推送通知后的支持跟进

一家媒体公司发送关于突发新闻的推送通知。点击通知的用户在 OneSignal 中被标记。后续 Journey 通过 UnifyPort 向互动的用户发送 Telegram 消息，邀请他们加入讨论频道。UnifyPort 的 message.received 事件捕获他们的回复并更新 OneSignal 标签以供未来细分。

此组合解决的问题

onesignal.com 的首屏截图。

• 渠道碎片化： 无需为 WhatsApp、Telegram、LINE、TikTok、Zalo 和 X 构建单独的集成，您可以使用 UnifyPort 的单一 API，并让 OneSignal 处理编排。
• 重复的受众逻辑： OneSignal 成为用户细分和属性的单一事实来源，而 UnifyPort 处理渠道特定的送达。
• 有限的互动范围： 推送通知只能触达应用或浏览器内的用户。通过 UnifyPort 添加社交渠道可将触达范围扩展到用户已经花费时间的地方。
• 手动跟进： Journeys 自动化跨渠道序列，减少手动工作并缩短响应时间。
• 不一致的事件数据： UnifyPort 的规范化 Webhook 模式确保来自不同社交平台的事件共享一致的结构，简化后端处理。

决策指南：何时使用此组合

First viewport screenshot of onesignal.com.

onesignal.com 的首屏截图。

此集成非常适合以下情况：

• 您已经使用 OneSignal 进行推送、电子邮件或短信，并希望将互动扩展到社交渠道。
• 您的用户在 WhatsApp、Telegram、LINE、TikTok、Zalo 或 X 上活跃，尤其是在亚太市场。
• 您需要跨越自有渠道和社交渠道的自动化多步骤旅程。
• 您希望避免构建和维护单独的社交消息集成。

考虑替代方案如果：

• 您只需要推送通知，并且没有使用社交渠道的计划。
• 您需要 UnifyPort 不支持的深度渠道特定功能（查看最新的 UnifyPort 文档了解语音通话等功能，该功能在 WhatsApp 中处于私有测试阶段）。
• 您的团队更喜欢一个同时用于互动和消息传递的单一平台；在这种情况下，请比较我们的 UnifyPort vs SaleSmartly vs Gupshup.ai 对比中的选项。

对于评估更广泛平台选择的团队，请参阅我们的十大 AI 客户体验和通信平台。

最佳实践

• 尊重选择加入和权限。 OneSignal 的权限管理帮助您跟踪同意；通过在 OneSignal 中将选择加入状态存储为属性，在 UnifyPort 中为社交渠道镜像该逻辑。
• 使用标签表示渠道偏好。 让用户选择他们偏好的渠道，并将其存储为 OneSignal 标签，以便 Journeys 可以相应分支。
• 处理速率限制和错误。 两个平台都有 API 速率限制；实现带指数退避的重试并记录失败以进行监控。
• 保持消息模板适合渠道。 推送通知简短；WhatsApp 和 LINE 支持更丰富的媒体。在相关情况下使用 UnifyPort 的媒体说明文字支持。
• 监控 Webhook 送达。 UnifyPort 的 Webhook 流是集成的骨干；为失败的送达设置警报并验证签名。

相关阅读

• UnifyPort vs Vonage API Developer：消息 API 对比 - 比较 UnifyPort 和 Vonage API Developer 的社交消息传递。了解渠道覆盖、统一 API、SDK 以及哪个平台适合您的构建。
• bundle.social 评测：面向 SaaS 和 AI 的统一社交 API - 基于证据的 bundle.social 评测：15 平台 API、定价、设置、优势、限制，以及它适合谁用于 SaaS、代理机构和 AI 代理。

来源和进一步阅读

First viewport screenshot of onesignal.com.

• 推送概述 - OneSignal - 使用仪表板或 API 通过 OneSignal 发送和管理移动和 Web 推送通知，具有定位、个性化和调度功能。
• 教程和用例 - OneSignal - 探索分步教程和最佳实践示例，帮助您实施 OneSignal 功能并提升互动、留存和收入。
• 如何使用 OneSignal 推送通知活动分步指南 - 在这个完整的 OneSignal 教程中，您将学习如何创建、管理和优化推送通知活动。这个分步指南涵盖了所有内容...

常见问题

什么是 UnifyPort？

UnifyPort 是一个统一消息 API 平台，让开发者通过单一 REST API 和标准化 Webhook 事件流连接 WhatsApp、Telegram、LINE、TikTok、Zalo 和 X。它提供适用于 Node.js、PHP、Go 和 Python 的官方 SDK。

什么是 OneSignal？

OneSignal 是一个客户互动平台，用于推送通知、电子邮件、短信和应用内消息，具有 Journeys、个性化、分析和 A/B 测试等功能。它被超过 200 万家企业使用。

集成 UnifyPort 与 OneSignal 需要后端吗？

是的。需要一个后端服务来接收来自两个平台的 Webhook、映射用户身份并发出 API 调用。您可以使用 UnifyPort 的 SDK 在 Node.js、PHP、Go 或 Python 中构建它。

我可以从 OneSignal Journeys 发送 WhatsApp 消息吗？

是的，间接地。OneSignal Journeys 可以调用一个 Webhook 步骤来触发您的后端，然后通过 UnifyPort 的 POST /v1/messages API 发送 WhatsApp 消息。

如何将 OneSignal 用户链接到 UnifyPort 对话？

在您的后端数据库中存储 OneSignal 用户 ID（或外部 ID）与 UnifyPort 发送者或对话标识符之间的映射。当回复到达时，使用 UnifyPort 的 Webhook 负载查找 OneSignal 用户。

UnifyPort 支持双向消息传递吗？

是的。UnifyPort 支持双向消息传递、文本和媒体说明文字、提及、消息固定、撤销、表情符号反应以及账户生命周期管理，包括二维码、代码、会话和 Passkey 认证流程。

定价考虑因素有哪些？

UnifyPort 使用透明的分级月度消息账户成本（以美元计），提供统一 API 访问和每个工作区中的免费消息账户。OneSignal 根据订阅者数量和功能提供自己的定价层级。根据您预期的消息量和渠道组合评估两者。

结论

结合 UnifyPort 和 OneSignal 为您提供了一个强大的全渠道互动堆栈：OneSignal 编排受众和旅程，而 UnifyPort 在用户实际使用的社交渠道上传递消息。通过链接用户身份、使用 Webhook 同步事件以及设计根据渠道偏好分支的 Journeys，您可以在用户所在之处触达他们，而无需为每个平台构建单独的集成。

首先在 UnifyPort 中连接一个社交渠道，在 OneSignal 中设置一个简单的 Journey，并端到端测试流程。一旦成功，扩展到更多渠道和更复杂的自动化。

有关相关的集成模式，请参阅我们的如何使用 UnifyPort 与 Chatwoot指南。