如何将 UnifyPort 与 Kommo CRM 结合用于即时通讯销售

销售对话如今始于 WhatsApp、Instagram、TikTok、Telegram、LINE、Zalo 和 X——而且常常同时发生。Kommo CRM 正是为这一现实而构建：它是一款面向即时通讯销售的 AI 驱动 CRM，受到数千个团队信赖，用于自动化 WhatsApp、Instagram、TikTok 及其他渠道上的对话。但 Kommo 的原生连接器只覆盖固定的一组提供商。如果你的客户通过 LINE、Zalo 或 X 给你发消息，你要么为每个网络单独构建集成，要么就会丢失这段对话。

UnifyPort 填补了这一空白。它是一个统一消息 API 平台，将 WhatsApp、Telegram、LINE、TikTok、Zalo 和 X 连接在一个 REST API 和一个标准 webhook 事件流之后。将其与 Kommo 搭配使用，你就能获得一条单一管道：来自任何受支持渠道的每条入站消息都会变成一个标准化事件，而每个事件都可以在 Kommo 内变成一个潜在客户、一个联系人或一个任务。

本指南将解释这两个产品如何协同工作、设置路径、代码层面的工作流，以及在你投入之前需要权衡的取舍。

为什么将 UnifyPort 与 Kommo CRM 搭配使用

First viewport screenshot of Estimate your WhatsApp Business API costs.

这一组合解决了即时通讯优先的销售团队在扩展时遇到的三个具体问题。

渠道碎片化。 Kommo 提供了 WhatsApp Business、TikTok、Instagram、Facebook Messenger、Telegram、Viber、WeChat 和 Apple Messages for Business 等集成。这是一个强大的原生集合——但每一个都是独立连接器，都有自己的配置，而列表之外的提供商则需要自定义开发。UnifyPort 用一个集成面替代了逐提供商构建：通过一次 POST /v1/messages 调用发送，并以一种 JSON 结构接收每个提供商的入站流量。

CRM 同步层中的提供商特定代码。 如果没有标准化层，你的中间件就必须以不同于 Telegram 更新的方式解析 WhatsApp 负载，处理每个提供商的状态回调，并维护单独的 SDK。UnifyPort 的标准事件层将每条消息、状态更新和账户事件转换为一种稳定的 JSON 结构，因此你的 Kommo 同步逻辑只需编写一次。

投递可靠性。 即时通讯渠道会以不同方式进行限流、重试和失败。UnifyPort 提供可靠的投递队列，内置速率限制、重试、幂等性和故障隔离，并配有用于签名、订阅、重试行为和故障跟踪的 webhook 控制平面。这意味着更少的后续跟进丢失，以及 Kommo 中更少的重复潜在客户。

两个产品如何分工

可以这样理解这种分工：

层级	职责
UnifyPort	渠道连接、提供商身份验证、消息标准化、投递保证、webhook 安全
Kommo CRM	潜在客户和联系人记录、管道阶段、AI 代理回复、任务分配、报告
你的中间件	将标准化事件映射到 Kommo 实体，并将 Kommo 操作通过 UnifyPort 路由出去

UnifyPort 围绕工作区、消息账户和连接运行时状态组织资源，并记录了账户生命周期，涵盖二维码、验证码、密码、Passkey 和会话导入等身份验证流程。Kommo 围绕潜在客户、联系人、公司、备注和任务组织工作。你的工作是让这两个模型保持同步。

先决条件

开始之前，请确认你具备：

• 一个 UnifyPort 工作区，且至少连接了一个消息账户。每个工作区都包含免费消息账户，定价基于以美元计的消息账户成本，并采用透明的阶梯定价。
• 一个 Kommo 账户，并拥有在 Settings → Integrations 下创建集成的权限。
• 一个可公开访问的 HTTPS 端点，用于你的中间件——它接收 UnifyPort webhook 并调用两个 API。
• 一个用于工作区 API 密钥的服务端环境。切勿将其暴露给浏览器或移动客户端。

第 1 步：创建 Kommo 集成并收集凭据

Kommo 支持两种集成身份验证类型：OAuth2 和长期令牌。

OAuth2（生产环境推荐）：

1. 在 Kommo 中，转到 Settings → Integrations → Create Integration。
2. 提供所需详细信息，包括与你的应用程序匹配的 Redirect URI。
3. 选择你的应用所需的访问范围——账户数据、文件，以及你计划调用的特定实体操作。
4. 保存集成，然后打开 Key and Scopes 部分。
5. 复制 Integration ID（客户端 ID）和生成的客户端密钥。将两者都存储为机密。

基于令牌（更适合内部工具，速度更快）：

1. 创建集成并定义所需范围。
2. 在 Key and Scopes 中，生成一个长期令牌。
3. 安全存储该令牌——它授予对你的 Kommo 账户的访问权限。

范围选择很重要。如果你只需要创建潜在客户和联系人，就只请求这些操作。Kommo 集成模型暴露了细粒度操作，例如创建潜在客户、创建联系人、创建带联系人的潜在客户、创建备注、创建任务、查找潜在客户、查找联系人、更新潜在客户和关联实体——以及潜在客户已创建、潜在客户已更新、潜在客户状态已更新、联系人已创建、任务已创建等触发器。请求最小集合可以降低凭据泄露时的爆炸半径。

第 2 步：注册已签名的 UnifyPort webhook

UnifyPort 的 webhook 控制平面用于管理签名、订阅、重试行为和故障跟踪。注册你的中间件端点，并订阅你关心的事件类型——至少包括入站消息事件和投递状态更新。

安全性通过工作区 API 密钥和 HMAC-SHA256 签名处理。在解析正文之前，验证每次投递的签名，并拒绝任何验证失败的内容。如果你想要按渠道逐一了解此模式，Telegram 设置指南 涵盖了账户创建、已签名 webhook 注册、HMAC-SHA256 验证，以及将 message.received 事件路由到你的应用程序。

第 3 步：标准化入站事件并将其映射到 Kommo

First viewport screenshot of WhatsApp CRM for beauty salons.

估算你的 WhatsApp Business API 成本首屏截图。

这是集成的核心。一个典型的处理程序做四件事：

1. 验证 HMAC-SHA256 签名。
2. 识别 标准化事件中的工作区、消息账户和渠道。
3. 解析 发送者到 Kommo 联系人——先搜索，仅在缺失时创建。
4. 路由 消息：将其作为备注附加到现有潜在客户，或者如果不存在则创建带联系人的新潜在客户。

一个简化的 Node.js 示例：

app.post('/webhooks/unifyport', async (req, res) => {
  if (!verifyHmac(req.headers['x-unifyport-signature'], req.rawBody)) {
    return res.status(401).end();
  }

  const event = req.body; // 所有提供商共用一种稳定的 JSON 结构
  res.status(200).end();  // 快速确认，异步处理

  if (event.type !== 'message.received') return;

  const contact = await findOrCreateKommoContact({
    channel: event.channel,          // whatsapp | telegram | line | tiktok | zalo | x
    externalId: event.sender.id,
    name: event.sender.displayName,
  });

  const lead = await findOpenLeadFor(contact.id);

  if (lead) {
    await addKommoNote(lead.id, formatMessage(event));
  } else {
    await createKommoLeadWithContact({
      contactId: contact.id,
      pipeline: 'Messenger Sales',
      source: event.channel,
      note: formatMessage(event),
    });
  }
});

两个细节可确保其可靠性。首先，立即确认 webhook 并异步处理——UnifyPort 的重试行为会在失败时重新投递，而处理程序过慢会导致重复工作。其次，在写入 Kommo 时使用幂等键，这样重试投递不会为同一条消息创建第二个潜在客户。

第 4 步：通过一个端点发送回复

当 Kommo 代理或 AI 代理回复时，你的中间件通过 UnifyPort 的单一消息端点发送，而不是通过提供商 SDK：

curl -X POST https://api.unifyport.com/v1/messages \
  -H "Authorization: Bearer $UNIFYPORT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "acc_whatsapp_sales",
    "to": "+15551234567",
    "type": "text",
    "text": { "body": "感谢您的联系——这是您的报价。" }
  }'

相同的调用形式适用于 Telegram、LINE、TikTok、Zalo 和 X。如果你更喜欢类型化客户端而不是原始 HTTP，官方 SDK 可用于 Node.js、PHP、Go 和 Python。

实际示例：多渠道潜在客户捕获流程

First viewport screenshot of WhatsApp CRM for healthcare.

健身中心 WhatsApp CRM 首屏截图。

一个零售品牌在 TikTok 和 Instagram 上投放广告，在 WhatsApp 上保留支持热线，并在 Zalo 和 LINE 上为越南和日本的客户提供服务。

1. 一位购物者给 TikTok 账户发消息询问尺码。
2. UnifyPort 标准化入站事件，并通过已验证的签名将其投递到中间件。
3. 中间件没有为该 TikTok 账号找到现有 Kommo 联系人，因此它在 Messenger Sales 管道中创建一个联系人和一个潜在客户，并将渠道记录为来源。
4. Kommo 的 AI 代理起草一条包含尺码表的回复；代理批准并发送。
5. 中间件通过 POST /v1/messages 将回复发布到 TikTok 账户。
6. 两天后，购物者在 Zalo 上留言。UnifyPort 投递事件，中间件将电话号码匹配到现有联系人，消息作为备注落到同一个潜在客户上——跨两个渠道的一条连续线程。

最后一步就是回报所在。如果没有标准化层，第 6 步通常会产生第二条彼此断开的记录。

Kommo 原生集成更合适的情况

First viewport screenshot of WhatsApp CRM for fitness centers.

美容院 WhatsApp CRM 首屏截图。

UnifyPort 并不自动适合每个团队。Kommo 的内置连接器在以下情况下非常合适：

• 你只使用 Kommo 已原生支持的渠道，并且不预期增加更多渠道。
• 你的团队完全在 Kommo 界面内工作，没有工程能力来运行中间件。
• 你希望与 Kommo 自己的 AI 代理和自动化构建器实现尽可能紧密的集成，而不需要外部跳转。

当你需要 Kommo 原生列表之外的渠道、希望所有提供商共用一条代码路径、需要可观察的投递保证和故障隔离，或者消息传递是产品功能而不仅仅是销售收件箱时，UnifyPort 会成为更好的选择。如果你仍在评估 API 层本身，多渠道消息和电子邮件 API 对比 和 UnifyPort vs MessengerPeople.dev vs CM.com 解析 会更深入地介绍定价、webhook 设计和 WhatsApp 设置。

运营检查清单

• 将工作区 API 密钥和 Kommo 令牌存储在机密管理器中，切勿放在客户端代码中。
• 在解析之前，验证每个入站 webhook 的 HMAC-SHA256 签名。
• 在一秒内确认 webhook，并异步处理。
• 让每次 Kommo 写入都具备幂等性，这样重试不会重复创建潜在客户。
• 记录 UnifyPort 发送者 ID 与 Kommo 联系人 ID 之间的映射；对账时你会需要它。
• 监控 UnifyPort 控制平面中的 webhook 故障跟踪视图，并对持续故障发出警报。
• 只请求你实际调用的 Kommo 范围。

相关阅读

• HubSpot 评测：定价、优缺点与最适合用户 - 一篇基于证据的 HubSpot 评测，涵盖理想用户、用例、定价信号、设置、优势、局限以及 2026 年的决策标准。

来源与延伸阅读

• Kommo - 将你的应用与 Kommo 连接，以简化 CRM 工作流、自动化销售流程并增强客户互动
• 所有集成 - 所有 Kommo 集成的列表，可帮助你自定义账户并添加新功能
• Kommo 知识库 - 查找分步指南，以设置 Kommo、连接消息渠道、管理潜在客户、自动化工作流并排查常见问题。

常见问题

Kommo 已经原生支持 WhatsApp、Instagram 和 TikTok 吗？

是的。Kommo 为 WhatsApp Business、WhatsApp Lite、TikTok、Instagram、Facebook Messenger、Telegram、Viber、WeChat 和 Apple Messages for Business 提供原生集成，并提供 Zapier 和 Make 等 CRM 自动化工具。当你需要该列表之外的渠道，或希望在所有渠道上使用一个标准化 API 时，UnifyPort 最有价值。

我可以通过 UnifyPort 添加哪些渠道？

WhatsApp、Telegram、LINE、TikTok、Zalo 和 X（原 Twitter），全部通过一个 REST API 和一个 webhook 事件流。账户身份验证流程包括二维码、验证码、密码、Passkey 和会话导入。

我需要为每个渠道编写提供商特定代码吗？

不需要。这正是标准事件层的意义。每个提供商的消息、状态更新和账户事件都以一种稳定的 JSON 结构到达，因此你的 Kommo 同步逻辑无需按提供商分支。官方 SDK 适用于 Node.js、PHP、Go 和 Python。

该集成如何保障安全？

UnifyPort 在 webhook 投递中使用工作区 API 密钥和 HMAC-SHA256 签名，并配有用于管理签名、订阅、重试行为和故障跟踪的控制平面。在 Kommo 侧，使用 OAuth2 或具有范围限制的长期令牌，并且只请求你需要的操作。

定价如何运作？

UnifyPort 定价基于以美元计的消息账户成本，采用透明的阶梯定价和统一 API 访问。每个工作区都包含免费消息账户，因此你可以在扩展之前验证集成。

如果 webhook 投递失败会怎样？

UnifyPort 的投递队列处理重试和故障隔离，控制平面会暴露故障跟踪。将其与 Kommo 侧的幂等写入配合使用，这样重新投递的事件会更新现有潜在客户，而不是创建重复项。

结论

Kommo CRM 为基于即时通讯的销售团队提供了一个管理潜在客户、自动化回复和运行管道的地方。UnifyPort 则让他们能够触达客户实际使用的每个渠道，而无需为每个渠道维护单独的集成。两者结合后，技术栈很直接：UnifyPort 负责连接、标准化和投递可靠性；Kommo 负责客户记录和销售流程；你的中间件通过已验证的 webhook 和幂等写入将两者相互映射。

从一个渠道开始，端到端验证从潜在客户到备注的流程，然后再添加提供商。架构不会改变——改变的只是你指向的账户。