SuperAPI AI 工具集

customer-retention

通用与其它

查看项目

更新于 10-15 22:15

技能介绍

用途:在 HubSpot CRM 中识别长期无触达或高流失风险的客户,并为其批量生成跟进任务,用于客户留存运营。

前置条件:须先阅读 bulk-operations/SKILL.md,因为所有读写都使用其 JSONL 管道、分页和 dry-run/digest 模式;活动属性表和关联规则见 sales-execution/SKILL.md。Schema 因门户而异,过滤前需逐项验证属性,例如用 hubspot properties get --type contacts 查看 notes_last_contacted、hs_last_sales_activity_date 等。若 subscriptions 返回 403,说明令牌缺少 subscriptions-read 权限,需使用具备该 scope 的 private-app 令牌。

主要能力:一是查找不活跃客户,可用 --filter 表达式按 lastcontacted、last sales activity、从未联系等条件筛选;更多信号(邮件退订、停滞工单、无开放商机)见 resources/customer-health-signals.md;结果超过 100 条时使用 bulk-operations 的分页循环。可用 hubspot objects history --type contacts --properties lifecyclestage 审计阶段变更来源。二是标记有风险的订阅,用 hubspot properties options-list --type subscriptions hs_subscription_status 先确认枚举值,再按 past_due 等状态筛选;用 hubspot associations list 将订阅映射到联系人。三是创建跟进任务或 check-in 备注,任务必须关联记录,否则在 UI 中不可见。四是批量创建任务:先用 objects create 创建任务,再用 associations create 关联;associations create 每次 API 调用最多批处理 100 对。objects create 是附加操作,不受 digest 门控,--dry-run 仅作预览,去掉即执行。

已知限制:没有原生 churn-score / health-score 属性,需通过自定义属性跟踪;hubspot sequences 为只读,CLI 无法创建序列或登记联系人;segments 可拉取列表成员并将风险人群保存为可复用列表;再触达登记可通过 workflows create/update 构建为工作流。