crm-maintenance

CRM 维护

快速开始

从引用的邮件或日历事件中获取上下文，确定正确的 HubSpot 联系人和商机，记录活动，并汇报发生的变化。对于商机清理，请将该商机与近期的邮件/日历活动进行核对，并提出更新建议——未经批准绝不应用任何更新。

User: "log this call to the Acme deal"
→ Read the most recent completed calendar event
→ Confirm attendees map to the Acme deal's contacts
→ Write a call activity on the Acme deal
→ Report: "Logged call to Acme Q2 Expansion. [deal link]"

工作流

1. 识别意图。 根据用户消息和上下文，判断适用以下三条路径中的哪一条：

   • 邮件路径——“更新我的 CRM”、“把这个加到商机里”，或任何提及邮件线程的表述
   • 通话路径——“记录这次通话”、“记录这次会议”，或任何提及日历事件的表述
   • 清理路径——“清理 HubSpot”、“这个商机是最新的吗”，或任何要求核查特定商机的请求 如果意图不明确（例如只说“更新 HubSpot”，但没有提及邮件、会议或商机），请先询问用户选择哪条路径，再继续操作。

2. 收集上下文。

   • 邮件路径：阅读邮件线程（主题、参与者、最后 1–3 条消息）。确定主要外部联系人。
   • 通话路径：阅读日历事件（标题、参会人、时间、描述）。如果未指定事件，则使用过去 24 小时内最近完成的会议，并在继续前与用户确认。
   • 清理路径：获取商机信息（阶段、金额、预计成交日期、下一步、关联联系人、过去 60 天内的活动），以及过去 14 天内涉及该商机联系人的邮件线程和日历事件。

3. 确定 HubSpot 联系人和商机。 针对邮件/通话路径：

   • 通过邮箱地址搜索 HubSpot 联系人。如果联系人不存在，则根据邮件签名或日历邀请数据创建联系人——写入前需在聊天中说明创建操作。
   • 按以下顺序查找正确的商机：(a) 如果用户指定了商机，则进行精确匹配；(b) 联系人唯一的未关闭商机；(c) 将联系人未关闭的商机与邮件主题或会议标题进行模糊匹配——写入前需确认；(d) 如果没有匹配项，则询问用户。绝不自动创建商机。
   • 在向 HubSpot 写入任何内容之前，请先阅读 reference/hubspot-fields.md，了解字段名称、活动类型和关联规则。
   • 如果去重或商机匹配存在歧义，请在继续前查阅 reference/gotchas.md，其中涵盖了最常见的故障模式。

4. 执行操作。

   • 邮件路径：创建邮件活动，标题为邮件线程主题，正文为简洁摘要（而非完整线程）。时间戳设为最新一条消息的时间。完整示例请参见 reference/examples/log-email-happy-path.md。
   • 通话路径：创建通话活动，包含事件标题、时长以及可用的备注。时间戳设为事件开始时间。包含联系人缺失场景的完整示例请参见 reference/examples/log-call-happy-path.md。
   • 清理路径：按照 reference/cleanup-checklist.md 逐项检查字段，并整理出建议修改列表。以“当前 → 建议”的并排形式展示。仅写入用户批准的内容。完整示例请参见 reference/examples/cleanup-deal.md。

5. 审批关卡——所有对外可见的写入操作。 对于联系人创建和活动记录，写入前需先说明，写入后需反馈结果。对于清理编辑，在用户批准具体修改内容之前，不得写入任何内容。

6. 汇报操作结果。 告知用户已写入的内容以及待处理的事项。如有可能，附上受影响商机的 HubSpot 链接。内容保持简短。

审批关卡

• 绝不删除记录。 包括联系人、交易和活动。如果用户提出要求，请告知该技能无法执行，并引导其前往 HubSpot 操作。
• 未经用户明确批准，绝不更改交易阶段或关闭交易。 即使证据充分也是如此。应标记并暂缓处理。
• 未经提示，绝不创建新交易。 如果无法确定正确的交易，应询问用户。
• 写入前先告知即将创建联系人。 用一行说明即可，便于用户发现拼写错误或重复项。
• 清理时使用并排对比。 展示当前值与建议值；每一项都需等待批准。

参考资料

• reference/hubspot-fields.md — 本技能使用的活动类型、字段名称和关联规则
• reference/cleanup-checklist.md — 交易清理期间检查的字段，以及标记每个字段所需的证据
• reference/gotchas.md — 联系人解析、活动摘要和清理建议的正误示例对照
• reference/examples/log-email-happy-path.md — 完整示例：将邮件记录到现有交易
• reference/examples/log-call-happy-path.md — 完整示例：将会议记录到现有交易（缺少联系人）
• reference/examples/cleanup-deal.md — 完整示例：陈旧交易审计