关于 sales-zerobounce
为处理邮箱验证与送达问题的 ZeroBounce 用户提供指导,适用于销售、营销和运营人员。内容涵盖名单清理、监控、预热和 API,并为常见任务提供分步流程。
主要功能
- 01批量与实时邮箱验证指导
- 02Catch-all AI 评分指导
- 03黑名单与 DMARC 监控帮助
- 04收件箱位置测试与预热流程
- 05API 配置和使用建议
- 06将通用任务转交相关技能
适用场景
- 01营销活动前清理联系人名单
- 02监控发送 IP 和域名
- 03配置实时邮箱验证
- 04排查收件箱位置或预热问题
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ sales-skills/ sales --skill sales-zerobounce安装后在 Claude Code 中输入/sales-zerobounce确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/learnings.mdplatform-guide.mdzerobounce-api-reference.md详细介绍
ZeroBounce 平台帮助
帮助用户解答 ZeroBounce 平台相关问题,涵盖电子邮件验证和列表清理、AI 评分、活动数据、收件箱投递测试、黑名单监控、DMARC 监控、电子邮件预热、API 集成和电子邮件查找。
ZeroBounce 是电子邮件验证和投递能力平台,支持 30 多种电子邮件状态类型,准确率达 99.6%。通过 SOC 2 Type 2 和 ISO-27001 认证,符合 GDPR/HIPAA/CCPA 要求。核心优势包括:批量和实时电子邮件验证、AI 驱动的全收邮件评分、用于互动跟踪的活动数据、收件箱投递测试、黑名单监控、DMARC 监控和电子邮件预热。
第 1 步 — 收集背景信息
如果 references/learnings.md 存在,请先阅读以了解积累的知识。
询问用户:
-
你需要 ZeroBounce 哪方面的帮助?
- A) 电子邮件验证 — 批量列表清理或实时 API 验证
- B) 电子邮件查找 — 根据姓名和域名查找 B2B 电子邮件
- C) 电子邮件评分(AI)— 全收邮件验证和互动评分
- D) 活动数据 — 跟踪订阅者互动情况
- E) 收件箱投递测试 — 测试电子邮件配置以及邮件进入收件箱还是垃圾邮件
- F) 黑名单监控 — 检查 200 多家服务商的 IP/域名黑名单状态
- G) DMARC 监控 — 监控域名身份验证并设置策略
- H) 电子邮件预热 — 建立域名/IP 信誉
- I) API 和 SDK — 以编程方式访问和自动化
- J) 集成 — HubSpot、Salesforce、Mailchimp、Zapier 等
- K) 账户和账单 — 点数、定价、套餐
- L) 其他 — 请描述
-
你的角色是什么?
- A) 销售代表 / AE / BDR
- B) 销售经理 / 团队负责人
- C) RevOps / Sales Ops
- D) 营销人员 / 电子邮件营销人员
- E) 管理员 / IT
- F) 创始人 / 独立销售人员
- G) 其他
-
你想实现什么目标?(描述你的具体目标,例如:“在 HubSpot 营销活动前清理 10 万个联系人”“为 5 个发送 IP 设置黑名单监控”“使用 AI 评分验证全收邮件地址”)
如果用户的请求已经提供了大部分背景信息,请直接跳转到相关步骤。 根据合理假设(并明确说明)先给出尽力而为的回答,然后只在结尾询问最关键的 1 至 2 个澄清问题;不要因为要收集完整背景信息而暂缓回答。
第 2 步 — 路由或直接回答
如果请求对应某项专门技能,请进行路由:
- 常规投递能力策略(SPF/DKIM/DMARC、预热规划、收件箱投递策略)→
/sales-deliverability - 跨工具的丰富数据策略(瀑布式数据丰富、CRM 数据清理)→
/sales-enrich - 构建潜在客户列表 / 定义 ICP →
/sales-prospect-list - 使用 Zapier/webhooks 以通用方式连接工具 →
/sales-integration
否则,请根据以下参考资料中的平台知识直接回答。
第 3 步 — ZeroBounce 平台参考资料
阅读 references/platform-guide.md,了解详细的模块文档、定价、集成和数据模型。
无需再了解平台指南中的详细信息;请专注于用户的具体情况。
第 4 步 — 提供可执行的指导
根据用户的具体问题,提供分步说明:
批量列表验证工作流
- 准备列表:将联系人导出为 CSV,每行一个电子邮件地址。删除重复项以节省额度。
- 上传:登录 ZeroBounce → Bulk Email Validator → 上传 CSV 文件。也可以通过 API 使用
POST /v2/sendfile。 - 等待处理:ZeroBounce 会异步处理列表。通过控制面板或
GET /v2/filestatus检查状态。 - 查看结果:通过控制面板或
GET /v2/getfile下载结果。按状态查看细分结果(Valid、Invalid、Catch-All、Spam Trap、Abuse、Disposable、Unknown、Do Not Mail)。 - 处理 Catch-All 地址:对 Catch-All 结果运行 AI Scoring。设置分数阈值(建议为 7+)以决定是否纳入。
- 下载清理后的列表:导出 Valid 邮件地址(以及高分的 Catch-All 地址),用于营销活动。
- 导入营销活动工具:将清理后的列表上传到你的 ESP、CRM 或营销活动平台。
- 定期重新验证:每 3 个月重新验证一次,或在任何大型营销活动开始前验证。
实时 API 验证设置
- 获取 API 密钥:登录 ZeroBounce → API settings → 复制你的 API 密钥。
- 选择区域:默认区域(
api.zerobounce.net)、美国区域(api-us.zerobounce.net)或欧盟区域(api-eu.zerobounce.net)。 - 集成:对单个地址调用
GET /v2/validate?api_key=YOUR_KEY&[email protected]进行验证,或调用POST /v2/validatebatch一次验证最多 200 个地址。 - 处理响应:检查
status字段——将 Valid 邮件地址发送到你的系统,拒绝 Invalid/Spam Trap/Abuse/Disposable,并将 Catch-All 标记为需要进行 AI Scoring。 - 使用 SDK:ZeroBounce 提供 13 个官方 SDK——使用适用于你的语言的 SDK,而不是直接调用原始 HTTP 接口。
- 监控用量:通过
GET /v2/getcredits检查额度,通过GET /v2/getusage检查用量。
黑名单监控设置
- 添加 IP 和域名:在 ZeroBounce → Blacklist Monitor → 添加所有发送 IP(IPv4 和 IPv6)及域名。
- 配置提醒:设置黑名单事件的电子邮件或 webhook 通知。
- 查看初始扫描结果:ZeroBounce 会执行初始检查——查看已有的黑名单记录。
- 处理提醒:收到黑名单提醒时,确定黑名单提供方,查看其移除流程并提交移除申请。结合近期发送活动排查原因。
- 持续监控:定期查看控制面板——有些黑名单会自动过期,其他则需要手动移除。
DMARC 监控设置
- 添加域名:在 ZeroBounce → DMARC Monitor → 添加所有用于发送电子邮件的域名。
- 发布 DMARC 记录:如果你还没有 DMARC 记录,请从
v=DMARC1; p=none; rua=mailto:[email protected]开始。ZeroBounce 会提供正确的记录供你发布。 - 监控报告:在控制面板中查看 DMARC 汇总报告——找出所有已授权的发送方。
- 逐步收紧策略:确定所有合法发送方后,在数周或数月内从 p=none → p=quarantine → p=reject 逐步调整。
- 留意可疑活动:收到有关未经授权的发送方冒用你域名的提醒时,及时处理。
电子邮件预热工作流
- 连接电子邮件帐户:在 ZeroBounce → Email Warmup → 连接你想要预热的 Gmail 或 Outlook 帐户。
- 配置设置:设置每日发送量目标和逐步提升计划。
- 开始预热:ZeroBounce 会开始自动互动——发送、打开、回复邮件,并将邮件从垃圾邮件中挽回。
- 监控进度:在控制面板中查看预热指标——送达率、收件箱投递率。
- 运行收件箱投递测试:2-3 周后运行投递测试,确认声誉有所改善。
- 过渡到营销活动:预热指标稳定后,开始以较低发送量发送真实营销活动,并逐步增加发送量。
注意事项
基于研究得出的最佳判断——请核查以下内容,尤其是关于定价、额度成本和 API 行为的条目,这些内容可能已经发生变化。
-
不要把 Catch-All 一概视为有效或无效。 Catch-All 域名会在 SMTP 层面接受所有邮件,因此 ZeroBounce 仅通过标准验证无法确认单个邮箱是否存在。不要盲目纳入(可能导致退信),也不要盲目排除(可能丢失有效潜在客户)。请使用 AI Scoring 逐个评估 Catch-All 地址——这正是该功能的设计用途。
-
不要低估 Email Finder 的额度成本。 每成功查找到一个地址需 20 个额度,批量查找 500 个地址最多可能花费 10,000 个额度——相当于验证 10,000 封邮件。请将 Email Finder 的用量与验证额度分开预算。如果需要大规模发现邮箱,请对比每次查找的成本与专用邮箱查找工具。
-
不要忽略区域 API 端点。 除默认端点外,ZeroBounce 还提供美国和欧盟区域端点。如果有数据驻留要求(GDPR),请使用欧盟端点(
api-eu.zerobounce.net)。如果延迟很重要,请使用距离基础设施最近的区域端点。默认端点可在全球使用,但可能无法满足合规要求。 -
了解实际速率限制:这是突发窗口限制,而非每小时上限。 ZeroBounce 每 10 秒 限制 80,000 次验证请求(ZeroBounce ONE™ 客户为 100,000 次);超出后只会触发 1 分钟的临时封锁。硬性上限针对错误的 API 密钥请求(200 次/小时 → 封锁 1 小时)。处理大型列表时,优先使用批量上传(
POST /v2/sendfile,异步)或批量验证(POST /v2/validatebatch,每次最多 200 个),而不是频繁调用单邮箱端点。 -
不要在同一账户中同时进行预热和营销活动。 邮件预热通过受控的互动模式建立信誉。在预热期间发送正式营销活动会扰乱这些模式,可能适得其反。请先完成预热(2-4 周),再逐步转为正式发送。
-
持续改进:如果你发现此处未涵盖的内容,请将其附加到
references/learnings.md,并注明今天的日期。
第 5 步 — 相关技能
/sales-deliverability— 跨工具的邮件送达策略(SPF/DKIM/DMARC、预热规划、收件箱投递、退信管理)/sales-enrich— 跨工具的丰富数据策略(瀑布式数据丰富、CRM 卫生、额度优化)/sales-prospect-list— 通过定义 ICP 和细分受众,构建有针对性的潜在客户列表/sales-integration— 通过 Zapier 或直接集成,将 ZeroBounce 连接到 CRM 和其他工具/sales-do— 不确定该使用哪项技能?路由器会将任何销售目标匹配到合适的技能。安装:npx skills add sales-skills/sales --skill sales-do
示例
示例 1:在 HubSpot 营销活动开始前清理邮件列表
用户说:“我在 HubSpot 中有 50,000 个联系人,想在发送产品发布邮件前验证他们。” 技能会:
- 建议将 HubSpot 联系人列表导出为 CSV
- 引导将列表上传到 ZeroBounce 进行批量验证(需要 50,000 个额度)
- 说明如何解读结果——移除无效、垃圾邮件陷阱、滥用、一次性邮箱和禁止发送的地址
- 建议对 Catch-All 结果运行 AI Scoring(将纳入阈值设为 7+)
- 介绍原生 HubSpot 集成,作为手动导出/导入的替代方案 结果:清理并验证后的列表重新导入 HubSpot,已移除无效和高风险地址,并对 Catch-All 地址进行了评分和筛选
示例 2:为发送基础设施设置黑名单监控
用户说:“我们通过 3 个 IP 和 2 个域名发送邮件——我想在被列入黑名单时立即收到通知。” 技能执行:
- 引导添加全部 3 个 IP(IPv4 和/或 IPv6)和 2 个域名到 Blacklist Monitor
- 配置电子邮件和 webhook 提醒,以便立即收到通知
- 说明覆盖的 200 多个黑名单提供方,以及自动过期名单和手动移除名单之间的区别
- 建议搭配 DMARC Monitor,实现完整的域名身份验证监控
- 建议将任何黑名单命中情况与近期发送活动交叉核对,以找出原因 结果:全天候监控所有发送 IP 和域名在 200 多个提供方上的黑名单状态,并在命中时立即提醒
示例 3:使用 API 在注册时实时验证电子邮件
用户说:“我想在注册表单中添加电子邮件验证,避免虚假电子邮件进入我们的数据库。” 技能执行:
- 建议使用实时验证端点
GET /v2/validate,或使用批量端点处理表单提交 - 展示使用
api_key参数进行身份验证的设置方法 - 建议在表单层面拦截状态为 Invalid、Disposable、Spam Trap 和 Abuse 的地址
- 建议使用距离用户基础设施最近的区域 API 端点,以降低延迟
- 建议根据用户的后端语言使用 SDK(有 13 种可选),而不是直接发送原始 HTTP 请求
- 根据预期注册量计算积分用量 结果:实时验证表单,防止无效、一次性和高风险电子邮件进入数据库
故障排除
Catch-All 结果占比过高
现象:列表中有很大一部分结果为 Catch-All,难以判断列表质量。 原因:许多企业域名会配置 catch-all 邮件服务器,以接受所有地址;标准验证无法确认这些域名下的单个邮箱是否存在。 解决方案:对所有 Catch-All 结果运行 AI Scoring。设置纳入营销活动的分数阈值(建议为 7+)。监控评分地址的退信率,并随着时间推移调整阈值。如果列表中大多数地址都是 catch-all,它可能偏向大型企业——这是正常现象。
批量验证任务卡住或速度缓慢
现象:上传 CSV 进行批量验证后,任务状态长时间显示为“processing”。
原因:处理大型列表需要更长时间。上传期间出现网络问题可能导致文件传输不完整。CSV 格式错误也可能拖慢处理速度。
解决方案:通过控制面板或 GET /v2/filestatus 检查任务状态。大型列表(100K+)可能需要数小时处理——这是正常现象。如果卡住超过 24 小时,请使用 GET /v2/deletefile 删除文件并重新上传。确保 CSV 格式正确,每行只有一个电子邮件地址,且电子邮件列中不含特殊字符。
API 对许多电子邮件返回“Unknown”状态
现象:实时验证中有相当比例的电子邮件返回“Unknown”状态。 原因:接收方邮件服务器超时或返回了模糊响应。收件方服务器的灰名单机制可能导致暂时出现 Unknown 结果。ZeroBounce 与收件方服务器之间也可能存在网络问题。 解决方案:几小时后重试 Unknown 邮件——灰名单机制通常会在后续尝试中解除。如果某个特定域名的 Unknown 比例持续偏高,其邮件服务器可能在积极拦截验证尝试。不要将 Unknown 视为 Valid——应将其排除在营销活动之外,或在发送前重试。