Unipile 文档：入门、API 端点与 V2 迁移实用指南

Unipile 的文档是开发者的入口，他们希望将消息、电子邮件和日历功能集成到应用程序中，而无需为每个提供商构建单独的连接器。文档涵盖账户设置、身份验证、核心 API 路由、Webhook 行为以及目前处于测试阶段的较新 V2 平台。

本指南将介绍 Unipile 文档中最重要的部分，帮助您更快地从注册到实现可用的集成。同时，当您的主要需求是通过一个 REST API 实现多渠道消息传递时，本指南还将介绍 Unipile 与 UnifyPort 的对比。

Unipile 是什么

Unipile 文档：入门、API 参考与 V2 指南 - Unipile 是什么。

Unipile 将自己描述为用于将消息和通信渠道集成到软件应用程序中的 API。根据官方文档，它支持 WhatsApp、LinkedIn、Instagram 和 Telegram 等流行平台，以及包括 Google、Microsoft 和 IMAP 在内的电子邮件提供商。路线图提到了对 SMS/RCS 和联系人的计划支持。

核心价值主张是避免从头开始构建消息传递功能的复杂性。开发者无需维护单独的 SDK 并处理每个提供商的特殊之处，而是使用一个 API 来：

• 检索跨提供商的联系人的对话历史
• 通过 Webhook 实时接收新消息和电子邮件
• 向现有联系人发送消息或发起新的一对一聊天
• 邀请联系人并创建外联序列
• 获取个人资料信息、状态关系和帖子

Unipile 文档中的入门指南

Unipile 文档：入门指南、API 参考与 V2 指南 - Unipile 文档中的入门指南.

Unipile 文档：入门、API 参考与 V2 指南 - Unipile 文档中的入门指南。

官方入门指南 概述了一个简短的设置路径。第一步是通过 API 仪表板的注册页面创建账户。登录后，您会收到一个 DSN（数据源名称），它用于在 API 请求中标识您的应用程序的数据源。

接下来，您需要生成一个访问令牌。DSN 和令牌都是经过身份验证的请求所必需的。文档建议进行一个实用的首次测试：使用仪表板中的 Accounts 页面直接连接一个账户，这样您可以在不编写代码的情况下尝试发送和接收消息。

从那里，API 参考部分支持交互式测试。您输入 DSN 和令牌，选择一条路由，填写参数，即可在集成到自己的代码库之前看到真实的响应。

快速入门工作流

典型的首次会话遵循以下顺序：

1. 注册 Unipile 账户
2. 登录并复制您的 DSN
3. 生成访问令牌
4. 从仪表板连接测试账户
5. 使用 GET /api/v1/chats 列出聊天
6. 使用 POST /api/v1/chats/:chatId/messages 发送测试消息

文档中引用的快速入门视频正好涵盖了这些步骤：连接提供商账户、列出聊天和发送消息。

文档中的关键 API 概念

Unipile 文档：入门、API 参考与 V2 指南 - 文档中的关键 API 概念。

DSN 和访问令牌

DSN 是您的 Unipile 数据源的主要标识符。每个请求都必须包含它。访问令牌提供身份验证，应视为机密。文档强调，在 API 参考中测试路由时，必须指定这两个值。

账户

账户代表已连接的提供商身份，例如特定的 LinkedIn 个人资料、WhatsApp 号码或 Gmail 收件箱。仪表板的 Accounts 页面是在编写程序化添加账户流程之前连接和测试账户的最快方式。

聊天和消息

聊天和消息端点是消息 API 的核心。GET /api/v1/chats 列出可用的对话，而 POST /api/v1/chats/:chatId/messages 在特定聊天中发送消息。这些路由是收件箱同步、外联和通知功能的基础。

Webhooks

Unipile 使用 Webhook 实时通知您的应用程序有关新消息和电子邮件的信息。您的后端无需轮询，而是在事件发生时接收事件，这对于响应式聊天 UI 和自动化工作流至关重要。

Unipile V2 文档

V2 欢迎页面 对于任何计划进行新集成的人来说都很重要。Unipile V2 目前处于测试阶段，文档明确警告在此阶段可能会发生破坏性更改。某些功能或服务可能会被修改、中断或暂时不可用。

V2 文档中的要点：

• V2 仪表板可在 https://dashboardv2.unipile.com 访问
• 即使您已有 V1 账户，也必须为 V2 创建新账户
• 可以使用官方迁移指南迁移现有的 V1 数据
• 左上角的文档选择器可在 V1 和 V2 文档之间切换

如果您正在构建生产系统，测试状态是一个重要的考虑因素。除非您特别需要 V2 功能并接受破坏性更改的风险，否则 V1 仍然是稳定的选择。

Unipile 定价概览

定价基于已连接账户的数量。Unipile 网站 列出了每月 49 欧元 / 55 美元的起价，适用于最多 10 个已连接账户，并提供包含所有功能的免费 7 天试用，无需信用卡。

批量定价是递减的：

计费基于计费周期内同时连接的最大账户数。即用即付计划没有长期合同。

Unipile 与 UnifyPort：选择正确的消息 API

Unipile 和 UnifyPort 解决了类似的问题——将多个消息渠道统一到一个 API 后面——但它们优先考虑不同的渠道和开发者体验。

Unipile 的优势在于跨通信类型的广度。它结合了 WhatsApp、LinkedIn、Instagram 和 Telegram 等消息平台以及电子邮件和日历提供商。这使其非常适合需要跨聊天和电子邮件进行收件箱同步，或严重依赖 LinkedIn 外联的产品。

UnifyPort 专注于消息 API，支持 Telegram、WhatsApp、LINE、X（Twitter）、Zalo 和 TikTok 等渠道。它将特定提供商的 SDK 规范化为一个 REST API，具有标准化的 Webhook 事件、HMAC-SHA256 签名验证、内置速率限制、带幂等性的重试和故障隔离。对于构建 AI 代理、CRM、通知系统或运营工具且需要可靠的多渠道消息传递的团队，UnifyPort 更窄的专注可以减少集成开销。

要更深入地比较 Unipile 的功能、定价和替代方案，请参阅 Unipile 平台概述。如果您的路线图侧重于多渠道消息传递而不是电子邮件或日历，多渠道通信 API 指南 解释了在统一消息平台中应评估哪些内容。

关于 Unipile 文档的常见问题

Unipile 中的 DSN 是什么？

DSN（数据源名称）是分配给您的 Unipile 数据源的标识符。登录 API 仪表板后您会收到它，并且必须与访问令牌一起包含在每个 API 请求中。

如何在不编写代码的情况下测试 Unipile？

文档建议从仪表板的 Accounts 页面连接一个账户，然后交互式使用 API 参考部分。您输入 DSN 和令牌，选择一条路由，填写参数即可看到实时响应。

Unipile 支持 Webhook 吗？

支持。Webhook 会实时通知您的应用程序有关新消息和电子邮件的信息，这是处理传入通信的推荐方式，而不是轮询。

Unipile V2 稳定吗？

不稳定。Unipile V2 处于测试阶段，文档警告可能会引入破坏性更改。除非您特别需要 V2 功能，否则 V1 仍然是生产集成的稳定版本。

我可以从 Unipile V1 迁移到 V2 吗？

可以。V2 文档包含迁移指南。您必须创建一个新的 V2 账户，然后按照迁移步骤移动现有的 V1 数据。

Unipile 支持哪些渠道？

Unipile 支持 WhatsApp、LinkedIn、Instagram 和 Telegram 等消息平台，以及 Gmail、Outlook 和 IMAP 等电子邮件提供商。还提供 Google 和 Microsoft 的日历集成。

相关阅读

• 亚麻裤指南：款式、面料、合身与护理技巧 - 为各种场合找到最好的亚麻裤。比较抽绳与平前襟、100% 亚麻与混纺、合身建议以及持久穿着的护理技巧。
• 什么是语音 API？开发者可编程语音指南 - 了解什么是语音 API、可编程语音如何工作、要比较的关键功能、真实用例以及将呼叫集成到您的应用程序中的最佳实践。
• LINE 贴纸：如何购买、发送和创建 - 了解如何购买、发送和创建 LINE 贴纸，从官方包到自定义设计，以及销售自己的贴纸集的技巧。

结论

Unipile 文档为开发者提供了一条从注册到可用的消息集成的清晰路径。DSN 和访问令牌模型简单明了，仪表板支持无代码测试，聊天和消息端点涵盖了最常见的用例。主要的战略决策是建立在稳定的 V1 还是测试版 V2 上，以及 Unipile 的电子邮件和日历广度是否比像 UnifyPort 这样专注于消息的替代方案更符合您的产品需求。

从入门指南开始，在仪表板中测试已连接的账户，并尽早验证 Webhook 交付。这些步骤将在您投入完整构建之前揭示大多数集成问题。