客户关系助手

它解决什么问题

Capsule CRM 的 API 覆盖 parties、opportunities、kases、tasks、活动条目等多个实体，字段命名又和界面不一致。直接写集成的工程师通常卡在三件事上：筛选查询的嵌套条件怎么写、更新一条记录时哪些字段能改、删除子项时该传什么。这个技能把这类操作收敛成自然语言指令，由底层工具调用 Capsule CRM。

核心能力

• 联系人管理：CAPSULE_CRM_CREATE_PARTY 支持创建 person 或 organisation，可一次写入姓名、职位、邮箱、电话、地址、标签、自定义字段、关联组织与负责人；CAPSULE_CRM_UPDATE_PARTY 按 partyId 局部修改，删除邮箱、电话、标签等子项时需要带上子项 id 和 _delete: true。
• 组合条件筛选查询：CAPSULE_CRM_RUN_FILTER_QUERY 支持在 parties、opportunities、kases 上叠加多个条件，操作符包括 is、is not、starts with、ends with、contains、is greater than、is less than、is after、is before、is older than、is within last、is within next；支持 orderBy 排序、page/perPage 分页（每页最多 100）和 embed 返回关联数据。
• 任务与项目跟踪：CAPSULE_CRM_LIST_TASKS 按 status（open、completed、pending）过滤任务并可嵌入相关 party、opportunity、kase、owner；CAPSULE_CRM_LIST_PROJECTS 按 status（OPEN、CLOSED）和关键词检索项目；CAPSULE_CRM_LIST_ENTRIES_BY_DATE 拉取笔记、邮件、已完成任务等活动条目。

字段与约定的坑

• 地址字段是顶层的：state、city、country、zip，不是 address.state 这种嵌套写法。
• 国家码必须是 ISO 3166-1 alpha-2，如 US、GB、CA，不能写 United States。
• 自定义字段用 custom:{fieldId} 引用；组织级自定义字段写 org.custom:{fieldId}。
• 组织相关字段加 org. 前缀，例如 org.name、org.tag。
• 项目在 API 里叫 kases，界面叫 projects；筛选查询要用 kases。
• 删除子项需要先列出 party 拿到子项 ID，再带 _delete: true 更新。
• 列表端点默认每页 50 条、上限 100 条，取全量数据要自己做分页。
• embed 的可选值随实体不同，使用前要确认端点支持哪些值。

其余工具包括 CAPSULE_CRM_DELETE_PARTY、CAPSULE_CRM_LIST_ORG_EMPLOYEES、CAPSULE_CRM_LIST_DELETED_OPPORTUNITIES。工具文档：composio.dev/toolkits/capsule_crm。