用途:针对被标记为3次及以上退信的联系人,进行每周人工复核。退信监控工作流会自动压制这些联系人,但需由人工决定是永久删除还是尝试恢复,以避免过度压制。
前提条件:退信监控工作流已启用(先运行 /bounce-monitoring-workflow);联系人上存在 email_health_flag 自定义属性;在 .env 中配置 HubSpot 私有应用访问令牌 HUBSPOT_ACCESS_TOKEN,用于脚本预筛选。
使用方式: 阶段一:用 CRM Search API 拉取 email_health_flag 已设置的联系人,导出为 CSV 供复核。示例请求为 POST https://api.hubapi.com/crm/v3/objects/contacts/search,筛选 propertyName 为 email_health_flag、operator 为 EQ、value 为 true,请求头使用 Authorization: Bearer $TOKEN。 阶段二:逐个复核。检查邮箱域名是否有效(MX 记录查询或访问域名)、是否为已知客户或高价值联系人(查看生命周期阶段和交易历史)、退信原因(硬退信=无效邮箱,软退信=邮箱满或临时错误)。决策矩阵:域名无效则删除;域名有效、非高价值且硬退信则删除;域名有效、非高价值且软退信则保持压制,下季度复查;域名有效、高价值且硬退信则尝试查找更新邮箱;域名有效、高价值且软退信则保持压制并监控。 阶段三:通过 HubSpot UI 或 API 批量删除标记删除的联系人;清除所有已复核联系人的 email_health_flag;记录复核结果(删除数、保留数、恢复尝试)用于季度报告。
回滚:已删除联系人可在90天内从 HubSpot 回收站恢复;保持压制的联系人可通过工作流或 UI 手动更新恢复营销状态。
限制与其它说明:建议每周一早上运行,耗时约5至15分钟,视数量而定;若每周超过50个联系人,应调查根因(如不良列表来源、表单垃圾)。此每周分诊属于交互式、依赖判断的工作,适合 HubSpot MCP 服务器,可在对话中让 Claude 拉取每个被标记联系人的详情、交易历史和退信原因(见 /connect-hubspot-mcp)。MX 查询、域名访问等具体实现细节资料未提供。