SuperAPI AI 工具集

suppress-hard-bounced

通用与其它

查看项目

更新于 10-16 03:35

技能介绍

用途:硬退信联系人邮箱永久无法投递,继续发送会浪费发送量并损害发件人声誉。该技能识别全部硬退信联系人、生成审计记录与监控列表,并引导手动抑制。

前置条件:HubSpot 私有应用访问令牌,需 crm.objects.contacts.read 与 crm.lists.read/crm.lists.write 权限;Python 3.10+ 与 uv;.env 中含 HUBSPOT_ACCESS_TOKEN;手动抑制需 Super Admin 或 Marketing Hub Admin 权限。

执行模式为四阶段:Plan(确认影响与时间)、Before(发现与审计)、Execute(建列表并手动抑制)、After(复核)。脚本用 uv run skills/suppress-hard-bounced/scripts/before.py 与 after.py 运行,无 execute 脚本。

主要能力:分页搜索硬退信联系人,按退信原因与营销状态统计,导出 CSV(data/audit-logs/hard-bounced-contacts.csv);通过 API 创建动态活动列表“CLEANUP: Hard Bounced Contacts”;可选创建 3 次以上退信复核列表。

关键限制:hs_marketable_status 在 API 中只读,无法通过 API 设为非营销,必须在 HubSpot UI 操作;非营销状态在下一账单周期生效,费用节省不即时。属性名必须是 hs_email_hard_bounce_reason_enum;hs_email_bounce 为字符串,需 int(float()) 转换。全部自动化可借助自定义属性加工作流实现,但更复杂。被抑制联系人保留在 CRM,可在 UI 恢复;取消退信需另行联系 HubSpot 支持。