如何通过 Snov.io API 预热账户

本指南展示了如何使用邮箱预热 API 在 Snov.io 中预热发件人帐户。

使用邮件预热 API可以大规模自动化发件人预热流程。您可以创建和管理预热活动，监控送达率进度，并通过 API 请求将发件人帐户持续预热，将其融入您的推广工作流程中。

开始之前

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

创建预热活动

在正式使用发件人帐户进行推广之前，请先对其进行预热。此方法会使用您指定的设置启动一个新的预热活动。

必填项：

所需的参数设置您的预热基本设置——要预热哪个帐户以及每天应发送多少封电子邮件。

• email_account_id — 你想预热的邮箱帐户
• per_day — 每天发送多少封预热邮件。您可以根据您的套餐，将此值设置为每天 1 到 1000 封邮件。请在此处查看预热邮件数量限制。

可选输入：

可选参数可让您微调预热策略、电子邮件内容以及您要预热的提供商。

您还可以通过高级选项（例如高级发件人池（仅限企业域名）、自定义跟踪域名和动态代理）来提高效果。

• strategy — 如何快速提升发送速度：progressive （默认）逐步增加您的每日用量，同时 steady 始终保持其数值恒定。
• from — 使用 progressive 策略时的每日起始发送量。可设置为 1 到 5 之间的数值，并确保它不高于你的per_day 目标。
• increase — 使用 progressive 策略时，每天增加的发送量。可设置为 1 到 5 之间的数值。
• email_content — 预热期间发送的内容类型：autogenerated （默认）表示由 Snov.io 使用 AI 自动生成内容；specific 表示由你提供自定义模板。
• subject — 你的自定义邮件标题（1–200 个字符）。当 email_content设置为 specific 时，此项为必填。
• body — 你的自定义邮件正文（1–10000 个字符）。当email_content 设置为 specific 时，此项为必填。
• reply_rate — 收到的预热邮件回复率。可选值范围为 10% 到 45%。默认值为 30%。
• campaign_deadline — 预热结束日期（YYYY-MM-DD）。如果您不想设置截止日期，请省略此项。
• providers —  需要对哪些电子邮件服务提供商进行预热？请从以下选项中选择。gmail, microsoft, 或者other。
• send_to_paid_domain — 是否也向付费域名发送预热邮件。默认开启 false。
• enable_ctd — 为本次预热启用自定义跟踪域名。默认值为false。
• enable_proxy — 为本次预热启用动态代理。默认值为false。
• schedule_id — 你想将发送时间表附加到此预热活动中。
• template_name — 您想要使用的已保存电子邮件模板的名称。

获取预热列表

概览所有发件人帐户中的预热活动，并可选择按状态筛选或分页浏览结果。

必填项：

none — 如果您未指定任何可选参数，则返回所有预热活动。

可选输入：

可选参数允许您按活动状态进行筛选并控制分页——将结果缩小到活跃、暂停、已完成或失败的活动，并选择每页显示多少个结果。

• page — 要显示的结果页码。从 1 开始（默认值）。
• per_page — 每页显示的结果数量。可选值为 20, 50, 或100，默认值为 20。
• status — 按指定状态筛选结果，可选值为 active, paused, completed, 或 error。若不提供此项，则返回所有预热活动。

获取预热信息

查看预热活动的当前配置和状态。

此方法返回完整的活动详情，包括策略设置、每日限额、当前送达率统计数据和关联的电子邮件帐户，以便您在进行更改之前监控进度并验证设置。

必填项：

id — 你要查找的预热活动。你可以从“获取预热活动列表”方法的响应中获取此信息。

更新预热活动

无需重新开始推广活动，即可调整预热策略、每日限额、状态或内容设置。

此方法可对现有的预热活动进行部分更新——仅更改您传递的字段；所有其他设置保持不变。

必填项：

id — 您想要更新的预热活动。您可以从“获取预热活动列表”方法的响应中获取此信息。

可选输入：

make_endless: true — 移除活动的截止日期，让预热活动无限期持续进行。这将覆盖您之前设置的任何截止日期。
其他所有可选参数的工作方式与“创建预热活动”方法相同，因此您可以调整预热配置的任何部分。有关参数的完整列表，请参阅“创建预热活动” 。

获取预热统计数据

监控收件箱打开率进展情况，并找出预热效果不佳的电子邮件服务提供商。

此方法返回预热活动每日和每个提供商的送达率统计数据。

您可以查看默认时间段内的统计数据，也可以指定自定义日期范围——这对于跟踪不同阶段的进度或比较不同时间段的效果非常有用。

必填项：

id — 您想要统计数据的热身活动。您可以从“获取预热活动列表”方法的响应中获取此信息。

• period — 预设时间窗口：two_weeks 或者 month。若未提供 date_from / date_to，则此项为必填。
• date_from — 自定义时间范围的开始日期（YYYY-MM-DD）。若未提供 period ，则此项为必填。
• date_to — 自定义时间范围的结束日期（YYYY-MM-DD）。该日期必须晚于或等于 date_from，且晚于或等于营销活动开始日期。若未提供 period，则此项为必填。

删除预热活动

删除不再需要的预热活动。此操作无法撤销。

此方法会永久删除预热活动及其统计数据——这些数据将无法再通过其他预热 API 方法访问。请在完成预热或不再需要跟踪活动时使用此方法。

必填项：

id — 您要删除的预热活动。您可以从“获取预热活动列表”方法的响应中获取此信息。