用途:该技能用于通过 ibl.ai 平台 API 管理某一组织的 CRM 记录,涵盖销售与关系管理,包括线索获取、管道管理与商机流转。
主要能力:支持人员(Person)、组织(Organization)、管道(Pipeline)、阶段(Stage,嵌套于管道)、线索来源(Lead Source)、商机(Deal)、活动(Activity)、标签(Tag)等资源。每个资源支持标准 REST:列表、创建、读取、更新、删除。另有人合并(persons/merge/)、发送邀请(persons/{id}/invite/)、关联平台用户(persons/{id}/link-user/),以及商机阶段流转(deals/{id}/move-stage/)、赢单(won/)、输单(lost/,需 lost_reason)。活动可标记完成(activities/{id}/done/)。标签可在 persons、organizations、deals 上附加与移除。
使用方式:基础地址为 https://api.iblai.app/dm,路径在 /api/crm/ 下,例如 https://api.iblai.app/dm/api/crm/persons/。每个请求需带 Authorization: Api-Token $IBLAI_API_KEY。记录按令牌解析组织,路径中无 {org}。Person 与 Organization 的 id 为 UUID 字符串,其余为整数。列表 GET 使用 ?page={n} 分页,?page_size={n} 调整每页大小(默认 50),响应含 count、next_page、previous_page、results,其中 next_page/previous_page 为页码而非 URL。可用过滤如 owner={user_id}、owner__isnull=true、?is_default=true。若尚未连接,先运行 /iblai-api-login 以生成 IBLAI_ORG、IBLAI_USERNAME、IBLAI_API_KEY。
适用场景与限制:适用于组织内的线索捕获、管道与商机流转管理。生命周期阶段为 lead、qualified、opportunity、customer、churned。删除操作具破坏性,需先与用户确认;标签删除会级联移除所有关联;发送邀请会对外发送,需确认。读取仅限令牌所属组织,跨组织记录返回 404 而非 403。字段级结构、枚举与过滤参数见 references/schema.md 等参考文件。具体字段默认值与 RBAC 细节本文未完整展开。