SuperAPI AI 工具集

crm

智能体与模型

查看项目

更新于 10-16 06:24

技能介绍

用途:该技能用于通过 HubSpot CRM v3 API 读取联系人记录、搜索联系人、查看交易管道,并在获得明确人工指令后变更交易阶段。它面向日常智能体工作流,而非构建 HubSpot 应用。

主要能力:contacts list/get/search 读取联系人;deals list 查看交易(可按 pipeline、stage 过滤);pipelines list 将阶段标签解析为阶段 ID;deals update-stage 在确认后修改 dealstage。

使用方式:脚本为 scripts/crm-cli,仅依赖标准库。示例:crm/scripts/crm-cli --help;crm/scripts/crm-cli --json --limit 20 contacts list;crm/scripts/crm-cli --json contacts search --query "ada";crm/scripts/crm-cli --json pipelines list;crm/scripts/crm-cli deals update-stage --id 901 --stage closedwon --dry-run;crm/scripts/crm-cli deals update-stage --id 901 --stage closedwon --yes。退出码 0 成功、1 API 错误或检查失败、2 用法错误。读取受 --limit 限制(默认 20,最大 100)。

限制:阶段变更必须有人工指令、--dry-run 预览和 --yes 确认,否则脚本拒绝且不调用 API;阶段变更可逆但留下审计历史。令牌存于 HUBSPOT_TOKEN,不得写入代码、聊天或提交。读取需 crm.objects.contacts.read 与 crm.objects.deals.read,阶段更新需 crm.objects.deals.write。不适用于构建 HubSpot 应用、营销自动化、其他 CRM 或 CRM 策略设计。其他细节暂未提供。