SuperAPI AI 工具集

ticket-resolution

办公与效率

查看项目

更新于 10-15 22:15

技能介绍

用途:通过 hubspot CLI 管理 HubSpot 支持工单的全生命周期,包括创建、分诊、推进阶段和关闭。使用前应先阅读 bulk-operations/SKILL.md,了解 JSONL 管道、批量读取、分页、dry-run/digest/confirm 与历史恢复;以 hubspot <command> --help 为准。工单对象类型为复数 tickets(如 tickets:45123)。

主要能力与必要用法:

  1. 流水线发现。阶段 ID 因门户而异,切勿硬编码,每个会话都要运行:hubspot pipelines list --type tickets --format table 与 hubspot pipelines stages --type tickets --pipeline <pipeline_id> --format table,获取各阶段 ID 与标签;用 jsonl/json 可一次映射 hs_pipeline_stage 到标签。
  2. 校验枚举值。hs_ticket_priority、hs_ticket_category、hs_resolution 均为门户可配置枚举,用 hubspot properties options-list --type tickets <property> 列出允许值(旧的 probe 探针已不可用);也可用 hubspot objects list --type tickets 读取在用值。不要假设 HubSpot 默认值。
  3. 创建并关联。subject 是唯一实际必填属性;不指定 hs_pipeline/hs_pipeline_stage 会落入默认流水线首阶段。用 hubspot objects create --type tickets --property ... 创建并捕获返回 id,再用 hubspot associations create --from tickets:<ticket_id> --to contacts:<contact_id> 或 companies:<company_id> 关联。可用 JSONL 队列经 jq 整形后通过管道批量创建。
  4. 分诊查询。用 hubspot objects search --type tickets --filter 按阶段与优先级筛选,支持 !hubspot_owner_id 查未分配,owner 用 hubspot_owner_id=<id>(ID 来自 hubspot owners list --format table)。
  5. 批量推进阶段。search 管道到 jq 生成 {id, properties:{hs_pipeline_stage:...}} 后执行 hubspot objects update --type tickets --dry-run;因更新不可逆,必须复用搜索、带上预览行中的 --digest/--confirm,任意行数都需确认(confirm 为该批次行数)。批量改派同理。
  6. 记录解决备注。备注等活动的创建在 sales-execution/SKILL.md,创建后用 hubspot associations create --from notes:<note_id> --to tickets:<ticket_id> 关联。
  7. 关闭工单。hs_resolution 为枚举,需传允许值而非自由文本;HubSpot 会据此计算 hs_is_closed、closed_date 与 time_to_close。更新不可逆,先 --dry-run 再带 --digest 与 --confirm <ticket_id> 重跑。

适用场景:门户工单流水线发现、批量工单入库、优先级/未分配分诊队列、批量阶段迁移与改派、解决备注关联、关闭与解决枚举填写。

限制:枚举选项随门户配置,须逐门户查询;更新操作不可逆,必须走 dry-run 加 digest/confirm;阶段与优先级等具体值资料未提供,需实查;聊天/收件箱由 hubspot conversations 读取(如 --associated-ticket-id 拉取工单背后会话)。