技能介绍

问题背景

销售团队在 Capsule CRM 里维护联系人、商机和项目时，往往要在 Web 界面里反复点筛选器、翻分页，批量查「加州 VIP 客户」或「2025 年以来改过的联系人」这类条件组合既慢又容易漏字段。任务、项目（Cases）和活动流分散在不同菜单里，用自然语言把「查—改—记」串起来，需要一层稳定的 API 封装而不是手写 REST。

技能如何工作

本技能通过 Composio MCP 暴露 Capsule CRM 工具集，你在客户端里完成 OAuth 绑定账号后，用对话驱动常见 CRM 操作：

结构化筛选：CAPSULE_CRM_RUN_FILTER_QUERY 对 parties（联系人）、opportunities、kases（API 里项目叫 kases）组合 field / operator / value，支持排序与 embed 展开关联数据。
联系人读写：CAPSULE_CRM_LIST_PARTIES 按 since 增量拉取；CAPSULE_CRM_CREATE_PARTY / CAPSULE_CRM_UPDATE_PARTY 创建或更新个人/组织、邮箱电话地址、标签与自定义字段。
跟进视图：CAPSULE_CRM_LIST_TASKS 按 open/completed/pending 过滤；CAPSULE_CRM_LIST_PROJECTS 与 CAPSULE_CRM_LIST_ENTRIES_BY_DATE 浏览项目状态与近期活动（备注、邮件、完成任务等）。

Toolkit 文档见 composio.dev/toolkits/capsule_crm。

边界与坑

筛选时 地址字段在顶层：用 state、country，不要写 address.state；国家必须是 ISO 3166-1 alpha-2（如 US）。自定义字段在 filter 里用 custom:{fieldId}，组织级用 org.custom:{fieldId}。更新联系人删除子项（邮箱、标签）时要在 party 里带上子项 id 并设 _delete: true，通常需先 list 再改。列表默认 每页 50、上限 100，全量数据要自行分页；各 endpoint 支持的 embed 并不相同，需对照文档。