SuperAPI AI 工具集

workflow-automation

办公与效率

查看项目

更新于 10-15 22:15

技能介绍

用途:通过 hubspot 代理 CLI 管理 HubSpot 工作流记录(v4 flows API),支持列出、查看、创建、更新和删除。注意与开发者 CLI hs 区分:hs 用于构建主题、模块、无服务器函数等开发项目,不创建或管理工作流记录。

认证:每个命令都支持 hubspot auth login(用户 OAuth,需授予 automation scope)或设置 HUBSPOT_ACCESS_TOKEN 服务密钥。若用户令牌报缺少 scope 的 403,可重新登录以授予新增的 automation scope。

主要能力:hubspot workflows list 输出 JSONL 的 id、name、isEnabled、type 等,可用 --format table 便于阅读,配合 jq 按名称筛选(例如 select(.name | test("Welcome"; "i")));get 支持单个、多个位置参数或 stdin 批量;create 从 JSON 文件或 stdin 创建;update 为整体替换;delete 为破坏性操作。

必要用法:创建时需指定 type(CONTACT_FLOW 或 PLATFORM_FLOW)、flowType(WORKFLOW)和 objectTypeId(如联系人用 0-1),可参考 resources/workflow-json-reference.md 与示例 JSON。更新必须先 get 获取完整响应(含 revisionId),修改后先 --dry-run 获取 digest,再以 --digest <hash> --confirm <flowId> 应用;只发送部分字段会静默清空其他字段。删除需先 --dry-run 获取 digest 与提示,再以 --digest 和 --confirm "工作流名称" 执行(confirm 值为名称而非 id),删除后无法通过自动化 API 恢复。

限制:list 只覆盖 v4 flows,不返回经典 v3 联系人工作流;没有搜索子命令,需 list | jq;分页每页 100,需按 --after 循环;dataSources 为只读;Sales Hub sequences 属于只读的独立界面。其余细节以 hubspot workflows --help 与 hs --help 为准,资料未提供的部分暂未提供。