Unipile 教程：数天内连接多渠道消息

将 WhatsApp、LinkedIn、Telegram 或电子邮件添加到您的应用程序通常意味着要处理不同的 SDK、不一致的数据格式以及维护噩梦。本 Unipile 教程向您展示统一消息 API 如何将这种复杂性简化为一个 REST 接口，让您的团队能够在数天而非数月内交付多渠道收件箱、CRM 连接器或 AI 代理后端。

您将学习如何创建账户、连接第一个渠道、发送和接收消息、配置 Webhooks，并了解定价模式——所有这些都附有您可以立即采用的实用示例。

什么是 Unipile，为什么要使用它？

First viewport screenshot of Quickstart: first message on WhatsApp — API Reference — UnifyPort.

UnifyPort 的第一个视口截图——一个端口，所有渠道。

Unipile 是一个统一 API，可跨提供商标准化消息和电子邮件。无需为 LinkedIn、WhatsApp、Instagram、Telegram、Gmail、Outlook 和 IMAP 构建单独的集成，您只需调用一组端点。该平台在后台处理身份验证、会话管理和提供商特定的差异。

核心功能包括：

• 多渠道收件箱：通过单个端点从任何已连接账户检索对话历史。
• 实时 Webhooks：以标准化的 JSON 事件接收新消息和电子邮件。
• 外发消息：以编程方式发送消息或发起新的一对一聊天。
• 联系人丰富：从支持的网络拉取个人资料数据、状态和关系信息。
• 电子邮件集成：将 Gmail、Microsoft 和通用 IMAP 账户与聊天渠道一起连接。

该平台符合 DMA 要求，并作为技术中介运营：每个 API 调用都代表经过身份验证的最终用户执行，受该用户在其自身会话中已能执行的操作限制。不会发生数据抓取或侧索引。

如果您正在评估更广泛的统一 API 策略，我们的数字平台指南解释了像 Unipile 这样的基础设施如何融入现代技术栈架构。

先决条件

在开始之前，请确保您具备：

• 一个开发环境，支持 Node.js、PHP 或 Go（官方 SDK 可用于这些语言）。
• 一个用于发出 HTTP 请求的工具，例如 curl、Postman 或 Unipile 仪表板中的交互式 API 参考。
• 至少一个您想要连接的消息或电子邮件提供商的有效凭据（例如 LinkedIn 账户、WhatsApp 号码或 Gmail 地址）。

第 1 步：创建账户并获取凭据

账户生命周期——API 参考——UnifyPort 的第一个视口截图。

1. 访问 Unipile 网站并注册免费 7 天试用。无需信用卡。
2. 登录 API 仪表板。
3. 找到您的 DSN（数据源名称）。此唯一标识符必须包含在每个 API 请求中。
4. 从仪表板生成 访问令牌。将此令牌视为密码——安全存储，切勿在客户端代码中暴露。

所有 API 调用使用基础 URL https://api1.unipile.com:13111。您将把 DSN 和访问令牌作为标头包含：

X-API-KEY: your_access_token

第 2 步：连接您的第一个消息账户

First viewport screenshot of Create account — API Reference — UnifyPort.

消息账户定价与 API 访问——UnifyPort 的第一个视口截图。

您可以直接在仪表板中连接账户进行测试，或通过 API 以编程方式连接。编程方式将是您在生产环境中使用的。

连接 LinkedIn 账户

使用 Node.js SDK：

import { UnipileClient } from "unipile-node-sdk";

const client = new UnipileClient("https://api1.unipile.com:13111", "your_access_token");

const linkedinAccount = await client.account.connect({
    provider: "LINKEDIN",
    username: "user@example.com",
    password: "your_linkedin_password"
});

console.log(linkedinAccount);

连接 WhatsApp 账户

WhatsApp 连接通常需要通过仪表板或托管身份验证流程扫描二维码。连接后，账户将出现在您的账户列表中，并立即可用于 API 调用。

列出已连接账户

要验证您的连接：

curl --request GET \
  --url https://api1.unipile.com:13111/api/v1/accounts \
  --header 'X-API-KEY: your_access_token'

响应返回每个账户及其提供商、状态和唯一的 account_id。存储这些 ID——您需要它们来定位特定渠道。

第 3 步：检索对话和消息

Unipile 将所有聊天规范化为一致的结构，无论底层提供商如何。

列出所有聊天

curl --request GET \
  --url https://api1.unipile.com:13111/api/v1/chats \
  --header 'X-API-KEY: your_access_token'

这将返回所有已连接账户中的每个对话，每个对话都有唯一的 chat_id。您可以使用查询参数按账户或提供商进行筛选。

获取消息历史

要检索特定聊天的完整消息线程：

curl --request GET \
  --url https://api1.unipile.com:13111/api/v1/chats/{chat_id}/messages \
  --header 'X-API-KEY: your_access_token'

响应包括发送者信息、时间戳、消息正文和附件，采用标准化的 JSON 格式。这个单一端点取代了 LinkedIn、WhatsApp、Instagram、Telegram 和电子邮件的提供商特定轮询逻辑。

第 4 步：发送消息

无论渠道如何，发送消息都遵循相同的模式。

curl --request POST \
  --url https://api1.unipile.com:13111/api/v1/chats/{chat_id}/messages \
  --header 'X-API-KEY: your_access_token' \
  --header 'Content-Type: application/json' \
  --data '{
    "text": "Hi, following up on our conversation!"
  }'

要发起全新的对话，请使用 POST /api/v1/chats 端点，并提供收件人的标识符和提供商。API 返回一个 chat_id，您可以立即用于消息传递。

对于构建招聘自动化的团队，此功能支持诸如从单一界面自动向 LinkedIn 和电子邮件上的候选人发送消息等工作流。我们的招聘消息自动化指南深入探讨了此用例。

第 5 步：配置 Webhooks 以获取实时事件

First viewport screenshot of Introduction — API Reference — UnifyPort.

API 参考——UnifyPort 的第一个视口截图。

轮询效率低下。Unipile 的 Webhook 系统会在事件发生时将新消息、状态更改和账户事件推送到您的服务器。

设置 Webhook 端点

1. 在 Unipile 仪表板中，导航到 Webhooks 部分。
2. 提供您的端点 URL（必须是 HTTPS）。
3. 选择您要接收的事件类型：新消息、消息状态更新、账户连接/断开连接。
4. 设置用于 HMAC-SHA256 签名验证的密钥。

验证 Webhook 签名

每个 Webhook 负载都包含一个签名标头。在您的服务器上验证它，以确保请求确实来自 Unipile：

const crypto = require("crypto");

function verifySignature(payload, signature, secret) {
    const expected = crypto
        .createHmac("sha256", secret)
        .update(payload)
        .digest("hex");
    return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
}

Webhook 负载结构

新消息事件如下所示：

{
  "event": "new_message",
  "account_id": "your_account_id",
  "chat_id": "chat_identifier",
  "message": {
    "id": "msg_123",
    "text": "Hello from a customer",
    "sender": {
      "id": "sender_id",
      "name": "Jane Doe"
    },
    "timestamp": "2026-01-15T10:30:00Z"
  }
}

这种规范化结构意味着无论消息是通过 WhatsApp、LinkedIn 还是 Telegram 到达，您的后端逻辑都保持不变。

第 6 步：探索 SDK

虽然 curl 适用于探索，但生产应用程序受益于官方 SDK。

Node.js

npm install unipile-node-sdk

该 SDK 为账户、聊天、消息和 Webhooks 提供类型化方法。它自动处理身份验证标头和请求序列化。

PHP

composer require unipile/php-sdk

Go

go get github.com/unipile/unipile-go-sdk

所有三个 SDK 都遵循相同的逻辑结构，因此在语言之间切换不需要重新学习 API 表面。

Unipile 定价：如何运作

在构建之前了解成本模型至关重要。Unipile 根据连接账户的数量收费，而不是 API 调用或发送的消息数量。

连接账户数	每个账户/月价格
最多 10 个	€49 / $55 固定
11 到 50	€5.00 / $5.50
51 到 200	€4.50 / $5.00
201 到 1,000	€4.00 / $4.50
1,001 到 5,000	€3.50 / $4.00
5,001+	€3.00 / $3.50

账户是任何已连接的提供商实例——一个 LinkedIn 个人资料、一个 WhatsApp 号码、一个 Gmail 收件箱。如果用户连接了 LinkedIn、WhatsApp 和 Gmail，则计为三个账户。计费基于计费周期内同时连接账户的峰值数量，无需长期合同。

对于比较统一消息提供商的团队，我们的 UnifyPort 与 MessengerPeople 与 CM.com 对比 分解了各平台的定价、渠道覆盖范围和开发者体验。

常见陷阱和最佳实践

令牌管理

访问令牌会定期过期。Unipile 为已连接账户处理自动续订，但您自己的 API 访问令牌必须安全轮换。将其存储在环境变量或密钥管理器中，切勿存储在源代码控制中。

速率限制

虽然 Unipile 抽象了提供商特定的速率限制，但负责任的使用仍然很重要。在重试逻辑中实现指数退避，并监控仪表板中的 Webhook 投递状态。

提供商合规性

您必须遵守每个平台的服务条款。Unipile 支持合规、用户授权的访问——不要将 API 用于垃圾邮件、抓取或任何违反 LinkedIn 或 Meta 可接受使用政策的活动。

错误处理

始终检查 HTTP 状态代码和响应正文。API 返回描述性错误消息，帮助您调试身份验证问题、无效参数或提供商端故障。

相关阅读

• 如何在 2026 年永久删除您的 Telegram 账户 - 通过浏览器、移动设备或自动删除永久删除 Telegram 账户的分步指南。在停用之前了解聊天、群组和联系人会发生什么。
• 支付解决方案：类型、工作原理及如何选择 - 探索现代支付解决方案——从商户服务和网关到统一 API。了解它们的工作原理、比较选项，并为您的业务选择合适的基础设施。

来源和进一步阅读

• 一个 API 用于您应用中的多渠道消息 - Unipile - 提升您应用的能力：集成 LinkedIn 和 WhatsApp，实现简化的消息传递和改善的用户体验。

常见问题解答

Unipile 支持哪些渠道？

消息：WhatsApp、LinkedIn、Instagram 和 Telegram。电子邮件：Gmail、Microsoft（Outlook/Exchange）和通用 IMAP 提供商。SMS 和 RCS 在公开路线图上。

集成需要多长时间？

大多数团队在两天内上线。仪表板包含一个交互式 API 参考，您可以在不编写代码的情况下测试端点，并提供个性化入门电话。

有免费试用吗？

有。7 天试用包括所有功能，无需信用卡。

我可以为每个用户管理多个账户吗？

可以。单个用户可以连接多个 LinkedIn 个人资料、WhatsApp 号码和电子邮件收件箱。每个都计为单独账户用于计费。

Unipile 如何处理会话过期？

该平台在可能的情况下自动续订提供商会话。如果会话无法恢复地过期，您会收到一个 Webhook 事件，以便您的应用程序提示用户重新连接。

Unipile 是否符合 DMA？

符合。该 API 的设计符合《数字市场法》。它支持安全的消息互操作性，而不会存储或抓取用户个人资料。

结论

First viewport screenshot of Start code authentication — API Reference — UnifyPort.

本 Unipile 教程涵盖了完整的集成流程：账户创建、渠道连接、消息检索、外发发送、Webhook 配置和定价。统一 API 模型消除了单独学习 LinkedIn 合作伙伴计划、Meta 的 WhatsApp Business API 或 IMAP 协议细节的需要。

对于 AI 代理构建者和多渠道通知系统，将统一消息 API 与像 UnifyPort 这样的平台配对——它提供了跨 Telegram、WhatsApp、LINE、X、Zalo 和 TikTok 的标准化事件层和 Webhook 控制平面——可以创造更广泛的覆盖范围。UnifyPort 的架构增加了内置速率限制、幂等重试和故障隔离，使其成为您的消息基础设施需要扩展到 Unipile 当前支持的渠道之外时的自然补充。

要继续探索，请查看官方 Unipile 入门指南 和 LinkedIn API 文档 以获取特定渠道的详细信息。