多平台私信合并助手

---

name: multi-inbox-merge description: 多平台私信合并助手：将邮箱、WhatsApp、Telegram、钉钉、企微、飞书、短信等消息统一为会话线程，自动去重、紧急度评分并生成跟进队列。用户提到“合并私信/统一收件箱/客户消息汇总/待跟进清单/读取钉钉消息”时使用。

---

多平台私信合并助手

把分散在不同平台的消息，合并成一个可执行的跟进队列。

能力

导入多个渠道的消息导出文件（CSV/JSON）

标准化字段（联系人、时间、内容、来源）

按联系人合并会话线程

消息去重（避免重复跟进）

紧急度评分并输出“优先跟进列表”

输入格式（建议）

支持 CSV 与 JSON。钉钉消息可直接导入 JSON（如 messages/data 列表），脚本会自动识别常见字段（conversation_id、sender_name、msg_time、msg_content 等）。

每条消息建议包含以下字段：

source：来源渠道（email / whatsapp / telegram / wecom / lark / sms ...）

contact_key：联系人主键（邮箱或手机号，建议唯一）

sender：发送方

timestamp：时间（建议 ISO8601）

text：消息内容

thread_id：会话ID（可选）

direction：inbound / outbound（可选，建议提供）

运行命令

先拉钉钉 API（可选）：

python3 skills/multi-inbox-merge/scripts/fetch_dingtalk_messages.py \
  --out data/inbox/dingtalk.json

再统一合并：

python3 skills/multi-inbox-merge/scripts/merge_inbox.py \
  --inputs data/inbox/*.csv data/inbox/dingtalk.json \
  --out reports/inbox-merge-$(date +%F)

输出结果

merged_messages.csv：标准化并去重后的消息

threads_summary.csv：按联系人汇总的线程信息

followup_queue.csv：按紧急度排序的跟进列表

summary.md：汇总统计与Top紧急线程

前置凭据检查（钉钉）

当用户要求“读取钉钉消息”时，先检查以下环境变量：

DINGTALK_CLIENT_ID

DINGTALK_CLIENT_SECRET

DINGTALK_MESSAGES_API_URL

若任意缺失：必须先停止执行并返回可复制配置命令，不继续后续步骤。

建议提示文案：

export DINGTALK_CLIENT_ID='你的appKey'
export DINGTALK_CLIENT_SECRET='你的appSecret'
export DINGTALK_MESSAGES_API_URL='你的消息查询接口URL'

然后提示用户回复：已设置。

建议工作流

1. 确认要合并的平台范围。 2. 若涉及钉钉，先完成“前置凭据检查”。 3. 提供各平台导出文件（或由已接入工具拉取）。 4. 执行合并脚本。 5. 返回 Top10 优先跟进对象 + 建议动作。

安全与边界

未经明确同意，不自动外发消息。

日志中避免输出密钥、令牌等敏感信息。

原始导出文件只读保留，不覆盖。

参考

字段与评分细则：references/schema.md

钉钉 API 对接：references/dingtalk-api.md