用途
本技能用于解答 Vitally 客户成功平台的使用与排障问题,覆盖平台各功能模块,并在问题超出 Vitally 本身时把用户路由到更合适的技能。
主要能力
技能按以下领域提供帮助:
- Health Scores:构建、加权、调试复合健康分
- Playbooks 与 Automation:触发器、动作、条件,以及未触发问题
- Projects:入职模板、里程碑、进度跟踪
- Integrations:Salesforce、HubSpot、Stripe、Segment 等数据同步问题
- REST API:创建/更新账户、用户、任务、自定义对象
- Dashboards 与 Reporting:视图、分群、指标
- Vitally AI:通话摘要、转录、copilot 功能
- NPS/Surveys:发送调研、收集回复、评分
- Notes、Tasks、Conversations:管理客户互动
- Custom Objects 与 Traits:扩展数据模型
- Admin:团队设置、角色、SSO、计费
使用方式
技能按步骤执行:
- 收集上下文:若存在 references/learnings.md 会先读取;向用户询问需要帮助的区域(A–K)、使用的 CRM(Salesforce、HubSpot 或无)、以及 Vitally 套餐(Tech-Touch、Hybrid-Touch、High-Touch 或不确定)。若用户提示已含足够上下文,则跳过此步。
- 路由或直接回答:客户成功策略问题路由到 /sales-customer-success;NPS/CSAT 调研设计路由到 /sales-customer-feedback;Salesforce/HubSpot CRM 配置路由到 /sales-integration;客户画像数据丰富路由到 /sales-enrich。路由时提供带用户原始问题的完整命令,否则基于平台参考直接作答。
- 平台参考:读取 references/platform-guide.md 获取完整平台参考(模块、定价、集成、数据模型、工作流);若涉及 API 端点,再读取 references/vitally-api-reference.md。只使用相关章节作答,不倾倒完整参考。
- 可操作指引:针对用户具体情境。健康分问题走查指标选择与加权;自动化问题追踪触发器→条件→动作链;集成问题检查字段映射与同步方向。若发现参考未覆盖的坑或技巧,追加到 references/learnings.md。
适用场景
- 健康分对已流失账户仍显示绿色
- 续约 Playbook 未按预期创建任务
- 通过 API PUT 的 Traits 未在界面显示
- CRM 数据不同步、仪表盘数据陈旧、NPS 调研未送达
限制与注意事项
- 初始设置最难,G2 评论普遍提到学习曲线,建议预留 2–4 周完成数据集成与健康分调优,不要一次配置全部。
- 健康分需 6–10 个月后再调整,过早改权重无法追踪趋势;建议从简单开始(最多 4 个指标),对照实际流失验证后再优化。
- 双向 CRM 同步可能产生循环,若同时推送健康分到 Salesforce 又拉取 Salesforce 字段作为健康分输入,需谨慎测试避免循环更新。
- 速率限制为令牌桶 1000 请求/分钟;写请求(POST/PUT/PATCH/DELETE)可能计为多个请求,写密集任务更快耗尽配额。超限返回 429,并带 RateLimit-Remaining 与 RateLimit-Reset 头。可通过 Postman 批量端点执行批量操作。
- DELETE 永久生效:通过 API 删除 Account 或 Organization 会永久销毁该记录及其专属数据,无法撤销。
- 自定义 trait 更新为增量式:PUT 请求中省略某 trait 会保留其当前值;要移除需显式设为 null。
- Conversations API 不发送消息,仅创建/更新会话记录作为参考点,不会发起会话或向客户发送外发消息。
- 欧盟与美国数据中心使用不同基础 URL:美国 https://{subdomain}.rest.vitally.io/resources/,欧盟 https://rest.vitally-eu.io/resources/。
- 上述坑点来自研究,属尽力而为,尤其套餐门控功能与集成坑点可能已过时,需复核。
相关技能
- /sales-customer-success:客户成功策略——健康分、流失预防、入职、扩展、Playbook 设计、CS 平台对比。安装:npx skills add sales-skills/sales --skill sales-customer-success
- /sales-customer-feedback:NPS、CSAT、CES、VoC 项目设计——调研方法、回复率、闭环反馈。安装:npx skills add sales-skills/sales --skill sales-customer-feedback
- /sales-integration:通过原生集成、Zapier 或 API 将 Vitally 连接 CRM、计费与分析工具。安装:npx skills add sales-skills/sales --skill sales-integration
- /sales-do:不确定用哪个技能时的路由器,将任意销售目标匹配到合适技能。安装:npx skills add sales-skills/sales --skill sales-do
示例
示例 1:健康分未反映风险账户。用户问“健康分对已流失账户显示绿色,哪里出问题?”做法:读取 platform-guide.md 健康分章节,审查指标选择——可能缺少使用/参与信号或过度加权登录频率;检查数据源(通过 Segment/Mixpanel 的产品分析、通过 Zendesk 的支持工单)是否正常同步;建议加入滞后指标如“距上次登录天数”和领先指标如“支持工单趋势”。
示例 2:Playbook 自动化未触发。用户问“我设置了续约前 90 天创建任务的续约 Playbook,但什么都没发生。”做法:读取 platform-guide.md 自动化章节,检查:(1) 账户上是否填充了 nextRenewalDate trait;(2) 触发条件是否使用正确字段名(自定义 trait 使用 vitally.custom. 前缀);(3) Playbook 是否处于激活状态(非草稿);(4) 账户是否匹配分群过滤。走查触发器→条件→动作链。
示例 3:REST API 自定义 traits 未更新。用户问“我通过 API PUT traits 但界面不显示。”做法:读取 vitally-api-reference.md,检查:(1) trait 键必须使用 Custom Fields 管理面板中的 vitally.custom. 前缀;(2) traits 更新为合并式,省略的 trait 不会被删除;(3) 验证 Authorization: Basic 头是否正确 base64 编码;(4) 检查响应状态——400 表示请求体格式错误,401 表示认证问题。
排障
CRM 数据不同步:检查集成状态,进入 Settings → Integrations 确认连接处于活动状态(未断开或报错);检查字段映射,Vitally 只同步白名单字段,确认期望字段已在集成设置中选中;检查同步方向,部分字段为单向(CRM → Vitally),如需双向必须显式启用两个方向。
仪表盘数据陈旧:检查数据源刷新计划,Snowflake、BigQuery 等集成按计划同步(非实时),确认上次同步完成时间;检查分群定义,若仪表盘按分群过滤,确认分群条件符合预期——分群会定期重算。
NPS 调研未收到:检查邮件送达,Vitally 通过已连接邮箱(Gmail/Outlook)或事务性服务商(SendGrid/Mailgun)发送 NPS,确认发送集成已连接且发送方未触达限制;检查节流规则,Vitally 可能节流调研以避免过度调研,确认用户近期是否已被调研;检查用户邮箱有效性,确认用户记录有有效邮箱且未退订(unsubscribedFromConversations: true)。