SuperAPI AI 工具集

conversation-inbox-triage

通用与其它

查看项目

更新于 10-15 22:15

技能介绍

用途:对 HubSpot 会话收件箱做审计与分流,包括列线程、找滞留会话、分配负责人、归档已解决线程并输出统计摘要。需使用 hub-cli 的 conversations 命令组,以 hubspot conversations --help 为准。

主要能力与用法:先枚举收件箱(conversations inboxes list),ID 因门户而异,不可硬编码;查看渠道用 conversations channels list --inbox-id。列出线程必须带 --inbox-id,状态与分配人需用 jq 在客户端过滤。找未分配线程按 assignedTo 为空判断;找滞留线程以 latestMessageTimestamp 与计算出的 ISO 时间比较(macOS 用 date -u -v-24H,Linux 用 date -u -d '24 hours ago')。分配用 conversations threads assign --id --actor-id;归档为守卫式两步流程,先 --dry-run 取 digest,再用 --digest 与 --confirm 执行,撤销用 threads restore --id。

关键限制:所有 list 命令默认 --limit 100 且只有 --format json 暴露游标,--format jsonl 重定向会静默截断,批量与计数须用资料给出的 conv_page 逐页取完;无服务端状态过滤;线程只有 originalChannelId,需与渠道列表关联类型;digest 仅 5 分钟有效,须在使用前即时生成;批量归档不可合并为单次循环,须先预览候选集并获批;批量循环应从文件读取而非管道,以免子 shell 丢失失败计数。owners list 需要服务键,OAuth 登录下返回 403。