SuperAPI AI 工具集

communication-history

办公与效率

查看项目

更新于 10-15 22:15

技能介绍

用途:检索某条 CRM 记录的活动历史(CALL、EMAIL、NOTE、MEETING、TASK),并组装通话前简报。先阅读 bulk-operations/SKILL.md,JSONL 管道、批量读取与 jq 重塑模式适用;hubspot activities list --help 为权威来源。

主要能力:activities list 每行返回一条活动,最新在前,字段为 {id, type, timestamp, lastModified, title, body, status, owner_id}。timestamp、lastModified 为 ISO 8601,type 为 CALL|EMAIL|NOTE|MEETING|TASK。按时间点过滤应比较 lastModified 而非 timestamp,避免包含截止后编辑的内容。可按活动类型与最近条数过滤: hubspot activities list --contact 73235 hubspot activities list --deal 67890 --activity-type CALL hubspot activities list --type subscriptions --record 45123 --activity-type NOTE hubspot activities list --contact 73235 --limit 10

使用方式:记录参数需恰好传一个 --contact、--deal、--company、--ticket,或其他对象用 --type <object_type> --record <id>;--activity-type 按活动种类过滤,--limit N 取最近 N 条。客户端日期过滤可借助 ISO 8601 字典序比较,如: CUTOFF=$(date -v-30d +%Y-%m-%dT%H:%M:%SZ) hubspot activities list --contact 73235 | jq -c --arg cutoff "$CUTOFF" 'select(.timestamp > $cutoff)' 紧凑时间线:hubspot activities list --contact 73235 --limit 20 | jq -r '"(.timestamp[0:10]) (.type) (.title)"'。通话前简报由四条管道命令组成:联系人、公司、未关闭交易与最近活动;批量 objects get 走 stdin,不要用 xargs -I{}。

转录:按活动 ID 获取单条通话或会议转录,默认 CALL,会议用 --activity-type MEETING,可用 --fields 限制富化字段:hubspot activities transcript get 54321 --fields recordingUrl,aiSummary。输出含 transcriptStatus、numUtterances、recordingUrl、aiSummary、transcriptionProvider 五个富化字段,仅富化转录才有;utterances 为语音内容,无转录时为空。删除转录不可逆,先 --dry-run,再用 --digest/--confirm。

限制:--limit 默认 100,没有 --after 游标,长历史无法分页;body 可能很长,浏览时用紧凑时间线。原始 hs_call_* / hs_timestamp(Unix 毫秒)需通过 hubspot objects get --type calls 获取。