如何通过 Snov.io API 设置和管理营销活动

本指南解释了如何设置营销活动序列并通过 Snov.io API 控制完整的营销工作流程。

在使用营销 API 之前

准备账户设置

• 至少连接一个发件人电子邮箱帐户。在发起营销活动之前，请使用应用内的“电子邮箱预热”功能或“电子邮箱预热 API”预热您的发件人帐户。
• 在营销活动计划中至少创建一个发送计划。
• 在“请勿联系列表”中创建或导入至少一个“请勿联系列表” ，或者通过 API 方法添加。

准备潜在客户名单

• 创建新的潜在客户名单
• 将潜在客户添加到列表中

营销 API 方法

以下是按工作流程阶段划分的 API 方法：

获取账户设置

这些方法可以帮助您检索已添加到帐户中的现有发送配置。使用 API 方法创建营销活动时，您需要以下每个设置的 ID。

获取您的发件人电子邮箱帐户

在将账户分配给营销活动之前，请获取发件人账户 ID 并确认每日限额。

返回所有已连接的邮箱帐户及其发件人姓名、电子邮箱地址、每日限额和提供商信息。

检查发件人帐户 SMTP/IMAP 状态

在广告系列中使用前，请确认账户连接已激活且无错误。

必填项：

email — 要检查的发件人帐户的电子邮箱地址

获取您的“请勿联系”名单

检索您帐户中创建的“请勿联系”列表。

获取您将分配给营销活动的“请勿联系”列表 ID，以便自动将特定联系人排除在序列接收范围之外。

获取您的竞选日程安排

获取您将在广告系列中使用的日程 ID。

返回您帐户中创建的所有计划，包括时区、活动日期和发送窗口。

管理发件人电子邮箱帐户

这些方法可让您连接、配置和预热电子邮件帐户。

添加新的电子邮箱帐户

使用 SMTP 和 IMAP 设置连接电子邮件帐户，以便您可以将其指定为营销活动中的发件人。

必填项：

帐户的 SMTP 凭据和服务器设置。

sender_name, email_from, password, smtp.host, smtp.port, smtp.encryption

可选输入

• IMAP 设置：跟踪从此发件人帐户发送的电子邮件的回复
• 邮件发送间隔：如果未指定，则帐户将使用默认的 600 秒邮件发送间隔
• 每日发送限制：如果未指定，则帐户将使用默认的 SMTP 限制 —— 每天 50 封电子邮件

更新电子邮箱帐户

更新现有发件人帐户的设置，例如每日发送限额或显示名称，而无需重新连接帐户。只会更新您在请求中包含的字段；其他所有内容保持不变。

必填项：

account_id — 要更新的发送方帐户 ID

开始热身

必填项：

sender_account_id — 用于预热的电子邮件帐户 ID

per_day — 每日发送目标，即预热阶段每日发送的电子邮件数量。对于初始预热阶段，我们建议将此限制设置为每天 40 封电子邮件。根据您的套餐，此限制最高可达 1000 封电子邮件。

strategy — 选择预热策略：渐进式，逐步增加新账户或不活跃账户的每日发送量（建议从 2 封邮件增加到 40 封邮件）；或稳定式，以固定的每日发送量维护发件人信誉。

email_content — 您可以预先设置电子邮件模板以提高送达率，或者使用人工智能生成的内容。

创建和管理营销活动

这些方法允许您设置包含完整配置的营销活动：序列步骤（电子邮件 + 领英）、日程安排、跟踪、发件人帐户、收件人列表和发送设置。

创建新营销活动

创建营销活动并获取营销 ID，该 ID 将用于所有后续 API 调用。

创建包含启动所需核心设置的新营销草稿。

必填项：

活动名称、发送计划以及至少一个发件人帐户。

name, schedule_id, sender_account_ids

获取活动信息

在进行更新或启动活动之前，请检查活动的当前设置和状态。

检索有关特定活动的完整详细信息——状态、发件人帐户、发送设置、收件人和序列步骤。

必填项：

campaign_id — 请求 URL 中的营销 ID

更新营销活动

在活动启动前或暂停期间更新活动设置。只有您在请求正文中包含的设置才会更改。

必填项：

campaign_id — 请求 URL 中的营销 ID，以及您想要更新的任何字段

更改营销活动状态

掌控营销活动的生命周期 —— 启动推广、暂停推广或在活动结束后关闭营销活动。此方法会将营销活动的状态更新为：进行中、已暂停、已恢复、已完成或已存档。

必填项：

campaign_id — 请求 URL 中的营销 ID；action — 要切换到的目标状态

支持的状态：启动、暂停、恢复、完成、存档

删除营销活动

从您的帐户中永久删除该营销活动。

必填项：

campaign_id — 请求 URL 中的营销 ID

添加和更新电子邮件内容

这些方法允许您管理营销活动序列中每个电子邮件步骤的内容（主题行和正文）。

创建电子邮件步骤内容

添加邮件主题和邮件正文。

在序列中指定的电子邮件步骤中添加内容块。

必填项：

campaign_id, step_id — URL 中的营销 ID 和步骤 ID

subject, body — 电子邮件主题和正文内容

获取电子邮件步骤内容

更新邮件内容前，请先检查邮件内容。

返回电子邮件步骤中的特定内容块。

必填项：

campaign_id, step_id, content_id — URL 中的广告系列 ID、步骤 ID 和内容块 ID。

更新电子邮件步骤内容

编辑电子邮件步骤的标题或正文，而无需替换整个内容块

必填项：

campaign_id, step_id, content_id — URL 中的营销 ID、步骤 ID 和内容块 ID；以及任何需要更新的内容字段

删除电子邮件步骤内容

从电子邮件步骤中移除内容块。

必填项：

campaign_id, step_id, content_id — URL 中的广告系列 ID、步骤 ID 和内容块 ID。

管理收件人

这些方法可以让你控制潜在客户在营销活动中的状态。

更改收件人状态

手动停止或调整对特定潜在客户的联系 —— 例如，如果他们通过其他渠道回复，或者需要在营销过程中将其排除。此方法会更新营销活动中特定收件人的状态。

必填项：

campaign_id — URL 中的营销 ID；email, status — 申请人的电子邮箱地址和新的申请状态

检查收件人状态

在更改收件人状态或将其添加到营销活动之前，请先验证收件人当前的联系状态。此方法会检查指定的电子邮箱地址是否已包含在特定营销活动的收件人列表中。

必填项：

campaign_id, recipient_id — URL 中的营销 ID 和收件人 ID

API的下一步

这些指南涵盖了营销活动工作流程中的剩余步骤——设置实时事件通知和提取效果数据。

设置网络钩子

订阅活动事件，即可在您的端点 URL 上接收实时通知。有关支持的事件、方法和有效负载详细信息的完整列表，请参阅 Webhooks 指南。

获取营销分析和报告

获取单个收件人的互动数据和汇总的营销活动效果指标。有关完整的报告方法、参数和响应示例列表，请参阅营销活动分析 API 指南。