使用Papo API (https://papo.global/)，您可以直接从您的系统自动化创建、发送和分析电子邮件营销活动，无需手动访问面板。电子邮件营销端点允许您通过REST调用管理活动、模板、受众和性能指标，使用与API其余部分相同的密钥认证。
通过API的操作摘要
| 操作 | 您可以通过编程方式做什么 |
|---|---|
| 列出活动 | 获取带有指标（发送数、打开数、点击数）的活动列表，用于仪表板或报告。 |
| 创建活动为草稿 | 创建处于草稿状态的新电子邮件活动，定义受众、模板、发件人和计划。 |
| 触发活动 | 启动（发送）已处于草稿或暂停状态的活动，开始实际发送。 |
| 发送单个电子邮件 | 立即发送单个电子邮件，适用于事务性通信或测试。 |
| 列出模板 | 检索账户中保存的电子邮件模板，以便在活动中重复使用。 |
| 列出受众 | 获取可用的联系人列表（受众），包括动态列表，用于自动细分。 |
所有操作都遵循REST标准，响应为JSON，并通过 Authorization: Bearer <secret_key> 进行认证。与任何其他Papo端点一样，您需要在面板的 Developers 部分生成一个密钥（sk_live_…）。
工作原理：自动化活动的完整周期
1. 认证并探索端点
在进行任何调用之前，请在Papo面板（Developers 部分）获取您的密钥。基础URL与通用API相同，所有请求都必须包含授权头。拿到密钥后，您可以列出已有的受众和模板来规划活动。
2. 以草稿模式创建活动
使用电子邮件活动创建端点（草稿模式）来构建发送内容而不立即发送。在请求中，您需要提供：
- 发送凭证（已配置的邮箱）。
- 模板ID（如果内联创建，则提供内容负载）。
- 受众（列表ID或联系人数组）。
- 可选设置，如计划日期/时间和发送窗口。
响应会返回活动的唯一标识符，以便您稍后检索。
3. 触发活动或安排发送
拿到活动ID后，您可以通过另一次调用触发（启动）它。如果您更喜欢自动计划，只需在创建时包含日期和时间字段——活动将处于计划草稿状态，并在指定时间发送。
4. 监控性能
使用活动列表端点随时查询指标。您将收到诸如总发送数、打开率和点击数等数据。这些数字可以通过定期调用或webhooks拉取到您系统中的仪表板（例如，Google Data Studio、Power BI或电子表格）中。
典型用例
- 事件驱动的潜在客户培育： 您的ERP的webhook通知某个潜在客户达到了特定分数；您的系统通过API自动触发电子邮件活动，将潜在客户移动到下一阶段。
- 统一的企业报告： 您的BI工具定期查询活动指标，并将其与销售数据结合，全部以编程方式完成。
- n8n或Zapier中的自动化： 创建流程，当CRM中收到新联系人时，创建欢迎活动草稿并触发它，无需手动干预。
- 白标转售： 将活动的创建和管理集成到您自己的客户门户中，在使用Papo基础设施的同时保持您的品牌视觉识别。
此解决方案适用于谁
- 希望将电子邮件营销集成到内部系统的开发人员和IT团队。
- 需要为数十个客户批量生成活动而无需访问每个客户面板的代理机构。
- 希望将电子邮件发送作为其产品组合一部分提供的白标经销商，通过API控制。
- 使用n8n、Zapier或自定义脚本进行自动化的公司。
常见问题
我需要不同的API密钥来使用电子邮件营销端点吗？
不需要。您用于Papo其他资源的相同密钥（公共和私有）在电子邮件端点中同样有效。认证方式相同，通过 Authorization: Bearer 头。
我可以发送单个电子邮件，例如事务性通知吗？
是的。API允许立即发送单个邮件，无需创建活动。只需提供收件人、主题、内容和发送凭证。
我如何知道活动是否真的被触发了？
调用启动端点时，API会返回活动状态。之后，您可以查询活动列表，检查状态是否从“草稿”变为“发送中”或“已完成”，并获取进度指标。
API返回哪些指标？
响应至少包括总发送电子邮件数、打开数和点击数。确切可用的字段在列表端点中有文档说明，可以使用Postman或API自身的发现界面进行探索。
我可以通过API创建电子邮件模板吗？
当前的模板列表功能允许检索账户中已有的模板。新模板的创建可以通过面板进行；请查看更新的文档以确认创建路由是否可通过API使用。
是否可以将活动安排到特定日期？
是的。创建草稿时，您可以提供所需的日期和时间。活动将保持该状态，并在计划时间自动发送，除非手动暂停。
另请阅读
集中管理渠道，使用AI自动化回复，管理电子邮件活动——一切都在一个面板中，无需初始成本。