SuperAPI AI 工具集

iblai-crm

办公与效率

查看项目

更新于 10-16 05:56

技能介绍

用途:通过 ibl.ai 平台 API 管理单个组织的 CRM 记录,包括人员、组织、销售管道及其阶段、线索来源、交易、活动和标签,用于线索捕获、管道管理与交易流转。

主要能力:各资源均支持标准 REST 操作(列表、创建、读取、更新、删除)。交易提供规范化的阶段流转动作:POST /api/crm/deals/{id}/move-stage/(可用 stage_code 或 stage_id)、/won/、/lost/。标签可附加到人员、组织或交易。支持按 owner、lifecycle_stage、status、pipeline、stage、tags、日期范围等过滤,列表结果分页。

使用方式:基础地址为 https://api.iblai.app/dm,CRM 路径追加在其后,例如 https://api.iblai.app/dm/api/crm/persons/。每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。记录归属由令牌解析出的组织决定,路径中不含组织标识。除 Person 和 Organization 的 id 为 UUID 字符串外,其余资源 id 为整数。若尚未连接,先运行 /iblai-login 以填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。

适用场景:线索与联系人管理、组织账户维护、销售管道与阶段配置、交易创建与阶段推进、赢单/输单关闭、活动记录与提醒、标签分类。

限制:删除操作具有破坏性,需先与用户确认。交易 status 为只读,直接写入会被拒绝(400),须通过交易动作变更。阶段嵌套在管道下,不能跨管道移动,且不能同时为 is_won 和 is_lost。人员有交易时不可删除。组织、人员、管道、阶段、来源等引用必须属于同一组织,跨组织引用会被拒绝。每个组织至多一个默认管道。人员与平台用户可通过邮箱匹配自动关联。生命周期阶段为 lead、qualified、opportunity、customer、churned;交易状态为 open、won、lost;活动类型为 call、meeting、email、note、task、lunch、deadline。