如何使用 UnifyPort 与 Chatwoot

将 UnifyPort 和 Chatwoot 连接起来，您就能获得一个用于社交消息的单一管道和一个完整的客户支持工作区。UnifyPort 处理繁琐的部分——通过一个 REST API 和标准化的 webhook 流与 WhatsApp、Telegram、LINE、TikTok、Zalo 和 X 通信。Chatwoot 处理人工和 AI 方面——对话、代理、自动化和 Captain AI 助手。

本指南解释了这两个产品如何协同工作、确切的工作流程、设置步骤、实际示例以及该组合解决的问题。

为什么要结合 UnifyPort 和 Chatwoot？

First viewport screenshot of www.chatwoot.com.

www.chatwoot.com 的首屏截图。

大多数支持团队面临同样的问题：客户在五个不同的应用上发消息，但代理在一个收件箱中工作。为每个渠道构建和维护单独的集成既昂贵又脆弱。UnifyPort 通过相同的 API 表面和相同的事件模式暴露每个提供商，从而消除了按渠道的工作。

同时，Chatwoot 是一个 AI 驱动的开源客户支持平台，被超过 15,000 家企业使用。它将 AI 代理（Captain）、消息渠道、帮助中心、自动化规则和 SLA 策略集中在一个地方。它可以作为云服务运行，也可以自托管以实现完全的数据控制。

这种组合是互补而非重叠的：

• UnifyPort 是传输和标准化层。一次 POST /v1/messages 调用发送消息；一个 webhook 流传递 message.received 事件，带有一致的 provider、account、conversation、sender 和 message 字段。
• Chatwoot 是对话和支持层。它存储联系人、将对话分配给团队、运行自动化，并让 Captain 在转接给人工之前回答常规问题。

简而言之：UnifyPort 将您连接到渠道，Chatwoot 将您连接到客户。

工作流程如何运作

First viewport screenshot of www.chatwoot.com.

www.chatwoot.com 的首屏截图。

以下是您将构建的端到端流程：

1. 客户在 WhatsApp、Telegram、LINE、TikTok、Zalo 或 X 上发送消息。
2. UnifyPort 接收它并将其标准化为 message.received 事件。
3. 您的中间件接收 webhook，将 UnifyPort 负载映射到 Chatwoot 对话——创建或更新联系人，然后将消息发布到正确的收件箱。
4. Chatwoot 路由对话到正确的团队或代理，应用标签、优先级和自动化规则。
5. Captain 可能先回答，如果问题与您的帮助中心或连接的文档匹配；否则它会转接给人工。
6. 当代理在 Chatwoot 中回复时，您的中间件通过 UnifyPort 的 POST /v1/messages 调用将该回复发送回原始渠道。

由于 UnifyPort 的模式在各个提供商之间保持一致，您编写一次的中间件适用于所有渠道。以后添加 LINE 或 Zalo 是配置更改，而不是新的集成项目。

先决条件

Chatwoot dashboard showing a customer conversation.

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

• 一个 UnifyPort 工作区，至少连接了一个消息账户（WhatsApp、Telegram、LINE、TikTok、Zalo 或 X）。
• 一个 UnifyPort API 密钥以及注册 webhook 端点的能力。
• 一个 Chatwoot 账户——云端或自托管——具有管理员访问权限。
• 一个 Chatwoot API 访问令牌和您的账户 ID。
• 一个小型中间件服务（Node.js、PHP、Go 或 Python——UnifyPort 为所有四种语言提供官方 SDK），能够接收 webhook 并调用两个 API。

分步设置

Chatwoot 仪表板显示客户对话。

步骤 1：在 UnifyPort 中连接您的渠道

在 UnifyPort 仪表板中，添加您想要支持的消息账户。根据提供商的不同，身份验证可能使用二维码、验证码、会话或 Passkey 流程。每个连接的账户都会获得一个标识符，您在发送消息时将使用该标识符。

通过 API 向自己发送消息来测试每个账户。成功的响应确认账户已激活。

步骤 2：注册您的 webhook 端点

将 UnifyPort 指向您的中间件 URL，以便它可以传递事件。至少订阅 message.received；如果您计划将状态同步回 Chatwoot，您可能还需要投递和已读事件。

您的端点应快速响应（先确认，异步处理）并具有幂等性，因为 webhook 传递可能会重试。

步骤 3：为每个渠道创建 Chatwoot 收件箱

在 Chatwoot 中，转到 设置 → 收件箱，为您想要分开的每个社交渠道创建一个 API 渠道收件箱——例如，“WhatsApp — UnifyPort”和“LINE — UnifyPort”。记下每个收件箱的标识符；您将在通过 API 创建对话时使用它。

单独的收件箱使路由、报告和 Captain 的受众规则更容易管理。

步骤 4：构建入站中间件

当 message.received 事件到达时，您的中间件应：

1. 从 UnifyPort 负载中提取发送者标识符和显示名称。
2. 在 Chatwoot 中搜索具有该标识符的现有联系人，或创建一个。
3. 在正确的收件箱中查找或创建对话。
4. 发布消息内容，包括媒体说明（如果存在）。
5. 存储 UnifyPort 对话 ID 和 Chatwoot 对话 ID 之间的映射，以便回复可以路由回去。

将此映射保存在一个小型数据库表中。它是集成中最重要的状态部分。

步骤 5：构建出站路径

当代理在 Chatwoot 中回复时，来自 Chatwoot 的 webhook（或轮询任务）会通知您的中间件。您的中间件查找 UnifyPort 对话 ID 并调用：

POST /v1/messages

使用目标账户、对话和消息正文。UnifyPort 处理提供商特定的格式。如果您需要提及、消息置顶、撤回或表情回应，这些通过相同的 API 暴露，而不是按提供商编写代码。

步骤 6：配置 Captain 和路由

在 Chatwoot 中，在能增加价值的收件箱上启用 Captain。连接您的帮助中心、PDF 或网站内容，以便 Captain 可以端到端地回答常规问题，并在无法回答时转接。使用受众和日程规则将 Captain 限制在它表现良好的时间和渠道。

设置自动化规则，按渠道、语言或关键词分配对话。Chatwoot 的自动翻译让代理和客户用自己的语言交谈，这在服务多个亚太市场时很重要。

实际示例

示例 1：WhatsApp 订单状态问题

一位客户向您的 WhatsApp 号码发送消息询问：“订单 1234 在哪里？”UnifyPort 传递事件，您的中间件创建 Chatwoot 对话，Captain——通过连接到您订单 API 的自定义工具——查找状态并回复。如果订单需要退款决定，Captain 会将完整上下文转接给人工代理。

示例 2：日语 LINE 咨询

一位客户在 LINE 上用日语写信。Chatwoot 的自动翻译为英语代理呈现消息，代理用英语回复。回复被翻译回日语并通过 UnifyPort 发送到 LINE。客户从未离开应用，代理也从未学习新工具。

示例 3：TikTok 评论变成支持工单

TikTok 上的一条公开评论引发投诉。您的中间件将其转换为 Chatwoot 对话，标记为“social-escalation”，并路由到高级团队。代理通过 UnifyPort 私下回复，公开线程根据您的政策单独处理。

示例 4：主动通知活动

您的营销团队触发一批订单已发货通知。他们不是构建四个提供商集成，而是为每个收件人调用一次 UnifyPort 并指定适当的账户，投递状态作为对话更新流回 Chatwoot。有关多步骤消息排序的更多信息，请参阅我们的消息 API 的旅程构建器概念指南。

该组合解决了哪些问题？

www.chatwoot.com 的首屏截图。

• 集成蔓延。 一个标准化的 API 和一个事件模式取代了按渠道的代码。添加新渠道是一项配置任务。
• 代理体验碎片化。 代理在一个收件箱中工作，而不是在提供商仪表板之间切换。
• 首次响应缓慢。 Captain 全天候立即回答常规问题，并带着上下文升级。
• 语言障碍。 自动翻译让小团队能够服务跨市场的客户。
• 数据控制。 自托管 Chatwoot 将对话数据保留在您的基础设施上，而 UnifyPort 处理渠道连接。
• 报告缺口。 Chatwoot 的标签、团队和 SLA 策略为您提供提供商仪表板无法聚合的指标。

决策指导：何时适合此技术栈

当您满足以下条件时，此组合非常适合：

• 在亚太市场运营，其中 LINE、Zalo 和 TikTok 与 WhatsApp 同样重要。
• 想要一个开源或自托管的支持平台，而不是封闭的 SaaS 收件箱。
• 拥有开发能力来运行一个小型中间件服务。
• 需要 AI 辅助支持，而无需重建渠道集成。

如果您只使用单一渠道且没有扩展计划，或者您需要完全无代码、零中间件的设置，则可能不太适合。在这些情况下，直接的 Chatwoot 渠道集成可能更简单。如果您仍在评估消息 API，我们的CPaaS 比较和UnifyPort 与 Chat SDK 对比分析可以帮助您权衡替代方案。

操作提示

• 记录每个 webhook 负载，在最初几周。提供商的特殊行为会在边缘情况中显现。
• 使处理程序幂等。 重复投递不应创建重复对话。
• 监控 Captain 信用使用情况。 信用由助手回复、Copilot 请求、编辑器操作、音频转录和自动翻译（当 Captain 是翻译服务时）消耗。在达到 80% 警告横幅之前设置计费警报。
• 保持工具列表简短。 Captain 在专注于一组自定义工具时效果最佳；太多会增加选择错误工具的机会。
• 使用真实设备测试。 表情回应、媒体说明和提及在不同提供商之间的行为不同，即使 API 是统一的。

相关阅读

• UnifyPort vs Linq vs Sinch：2026 年消息 API 比较 - 在渠道、API、定价和用例上比较 UnifyPort、Linq 和 Sinch。在 2026 年为您的团队找到合适的消息平台。
• UnifyPort vs 8x8 开发者门户：消息 API 比较 - 将 UnifyPort 的统一消息 API 与 8x8 开发者门户的 CPaaS 和 XCaaS 工具进行比较。查看渠道覆盖、SDK 和最适合的用例。
• SocialAPI.ai 评测：面向 AI 代理的统一社交媒体 API - 基于证据的 SocialAPI.ai 评测：13 平台统一社交 API、原生 MCP 服务器、设置、定价信号、限制以及谁应该使用它。

来源和进一步阅读

First viewport screenshot of www.chatwoot.com.

• 用户指南 | Chatwoot - 发现

Captain 使用 AI 信用。每个付费计划每月包含免费信用，您可以购买更多。

计划与访问：Startups、Business 或 Enterprise。每个计划包含多少信用以及充值价格在 定价与计划 > Captain AI 信用中。管理员在计费中查看使用情况并购买信用。

设置与尝试

什么使用信用

以下每一项使用一个信用：

• 对客户的助手回复。

• 助手 Playground 中的消息。

• Copilot 请求。

• 编辑器操作，例如改写、总结或建议回复。

• 音频转录。

• 由自动翻译翻译的消息，当 Captain 是翻译服务时。

添加文档、批准常见问题、来自 Suggest with Captain 的标签和优先级建议以及自动化规则中的 Captain 条件不使用信用。

查看您的使用情况

1. 转到设置 > 计费。

2. Captain 部分显示已使用的信用和文档。点击刷新以更新。

购买更多信用

1. 在计费 > Captain 中，点击购买更多信用。

2. 选择一个包并点击购买信用，然后确认。您保存的卡将立即扣款。

购买的信用：

• 立即添加并在您的月度计划信用之后使用。

• 6 个月后过期。

• 需要活跃订阅才能使用。

• 不可退款。

测试它

购买后，在计费 > Captain 中检查新余额。

获取价值

• 月度信用在您的计划续订日期重置。购买信用或更改计划不会重置使用量。

• 未使用的月度信用不会结转。如果您使用的超过月度信用，额外部分将从您购买的信用中扣除。

• 当您更改计划时，您的余额会按两个计划月度信用的差额增加或减少。您的使用量保持不变。

• 更改席位数不会重置使用量。

• 要让信用持续更久：仅将助手连接到有帮助的收件箱，使用受众和日程规则（控制 Captain 回复谁以及何时回复），并关闭您不使用的 AI 功能，例如转录。

• 当您使用超过 80% 的信用时，会显示警告横幅。没有电子邮件警报，信用不会自动充值。

• 使用量是账户的一个总数。它不按代理、助手或功能拆分。要查看每个助手表现如何，请使用其概览（Captain 概览和报告）。

故障排除

症状 可能原因 该怎么办 新对话直接转到团队而没有助手回复 信用用完 购买信用或等待续订 助手在对话中显示“正在转接给另一位代理以获取进一步帮助。” 对话期间信用用完 购买信用或等待续订 Copilot 说您的 Copilot 信用用完 信用用完 购买信用或等待续订 购买后使用量没有归零 预期。使用量仅在续订时重置；购买会增加余额 无 信用使用速度比预期快 助手在繁忙的收件箱上，或 AI 功能使用频繁 缩小受众或日程；关闭您不需要的功能 无法购买信用 您不是管理员，或没有活跃订阅 询问管理员；检查订阅

更多原因：Captain 故障排除。

• 如何在 Chatwoot 中使用仪表板应用？ - 通过我们的分步指南了解如何将自定义应用集成到您的 Chatwoot 仪表板中。
• 使用 ChatWoot 的公司（活跃客户列表） - 我们检测到 287 家公司使用 ChatWoot，56 家公司流失，以及 9 家客户在未来 3 个月内即将续订。我们通过检测客户网站上的 JavaScript 片段或配置来发现新客户。

常见问题

我需要编写代码来连接 UnifyPort 和 Chatwoot 吗？

是的，在大多数情况下。您需要一个小型中间件服务来将 UnifyPort webhook 事件转换为 Chatwoot 对话，并将 Chatwoot 回复通过 UnifyPort 发送回去。UnifyPort 为 Node.js、PHP、Go 和 Python 提供的官方 SDK 可以减少工作量。

我可以连接哪些渠道？

UnifyPort 支持 WhatsApp、Telegram、LINE、TikTok、Zalo 和 X。Chatwoot 的原生渠道包括实时聊天、电子邮件、WhatsApp、社交渠道和语音通话；UnifyPort 集成将覆盖范围扩展到额外的社交提供商。

Captain 能在这些渠道上回答问题吗？

是的。一旦对话进入 Chatwoot 收件箱，Captain 可以根据其受众和日程规则进行回复，使用您的帮助中心、PDF 和网站内容作为知识来源。

这要花多少钱？

UnifyPort 使用透明的分级月度消息账户定价（美元），每个工作区都有免费消息账户。Chatwoot 提供免费的 Hacker 计划，最多 2 个代理，每月 500 次对话；付费云计划起价为 $19/代理/月和 $39/代理/月；永久免费的自托管社区版；以及自托管高级支持，价格为 $19/代理/月。提供 15 天免费试用。

我可以自托管 Chatwoot 并仍然使用 UnifyPort 吗？

是的。Chatwoot 的自托管社区版在您自己的基础设施上运行，而 UnifyPort 是一个云 API，因此您的中间件只需调用两者。这为您提供了渠道连接，而无需放弃数据控制。

如果 webhook 失败会发生什么？

UnifyPort 会重试投递。设计您的中间件以快速确认并异步处理，并使用存储的对话映射来避免重复消息。

结论

UnifyPort 和 Chatwoot 解决了同一问题的不同部分。UnifyPort 为每个社交渠道提供一个 API 和一个事件流；Chatwoot 为您提供一个 AI 辅助的支持工作区，代理可以真正在其中工作。它们一起让小团队能够处理亚太市场的多渠道对话，而无需为每个提供商重建集成。

从连接一个渠道开始，构建入站和出站中间件，并在单个收件箱上启用 Captain。一旦该循环可靠运行，再扩展到下一个渠道——模式保持不变，因此工作不会倍增。