用途:为 HubSpot CRM 联系人汇总跨越所有收件箱的会话线程与消息内容,形成可嵌入大型客户简报的结构化数据。依赖 hub-cli PR #251 的 conversations 命令组,以 hubspot conversations --help 为准;本技能只覆盖 Conversations 收件箱,不含 CRM 通话、邮件、备注等历史。
主要能力:枚举收件箱(conversations inboxes list);按收件箱与联系人查找线程(conversations threads list --inbox-id --associated-contact-id);将 originalChannelId 与 conversations channels list 关联以得到渠道类型;分页获取每条线程的消息并附加线程与渠道信息;生成按最近活动排序的时间线、首条消息摘录及结构化 JSON 简报段落。
必要用法:线程查询必须提供 --inbox-id,需先枚举全部收件箱再逐个查询;列表命令默认 --limit 100,分页游标只在 --format json 的 .meta.next 中暴露,直接重定向 --format jsonl 会静默截断,因此提供 conv_page 帮助函数逐页取完并写入文件;消息同样需分页。单条消息可用 conversations messages get --thread-id --message-id 获取完整内容。
适用场景:通话前准备客户简报,或需要将收件箱会话与 CRM 活动历史合并查看时;可配合 communication-history/SKILL.md 补充 CRM 活动记录。
限制:无服务端日期范围过滤,需在客户端用 jq 按 latestMessageTimestamp 过滤;每页上限 100 行,提高 --limit 无法突破;线程上没有 channelType,需自行关联渠道列表,且 originalChannelId 只表示线程起始渠道;subject 非保证字段,需用 // "(no subject)" 兜底;部分消息内容在 richText 而非 text,提取时需两者都检查。