电商物流延迟检测 + 安抚短信技能#

概述#

为电商卖家提供「物流监控→延迟检测→安抚话术→短信发送」一站式服务。 检测到异常后，自动生成专业安抚短信并发送给客户，降低差评率和客诉。

核心能力#

1. 物流轨迹查询 — 支持60+快递公司，自动识别快递公司
2. 延迟风险检测 — 4条规则引擎：发货超时、运输停滞、派送异常、预计超时
3. AI安抚话术 — 根据延迟原因个性化生成短信内容
4. 短信发送 — 阿里云/腾讯云短信，支持dry-run预览

工作模式#

模式说明dry-run仅检测物流状态，预览安抚短信，不真实发送（默认）send检测 → 预览 → 确认 → 批量发送短信

快速开始#

模式 1：CSV批量导入#

准备CSV文件（UTF-8编码），包含以下列：

csv

order_id,customer_name,customer_phone,tracking_number,carrier_code,order_date,product_name
20260615001,张三,13800138000,SF1234567890,SF,2026-06-10,新款T恤
20260615002,李四,13900139000,YT9876543210,,2026-06-11,运动鞋
20260615003,王五,13700137000,JD000111222333,,2026-06-08,手机壳

必填列： order_id, customer_phone, tracking_number 可选列： customer_name, carrier_code（不填则自动识别）, order_date, product_name

模式 2：手动单号查询#

直接提供运单号，逐一手动输入客户信息。

使用流程#

Step 1: 获取订单数据#

python

# WorkBuddy 将执行：
python scripts/order_processor.py --input orders.csv --validate

Step 2: 查询物流状态并检测延迟#

python

python scripts/logistics_checker.py --input orders.csv --output results.json

Step 3: 生成安抚短信预览#

python

python scripts/sms_sender.py --input results.json --mode dry-run --output preview.html

Step 4: 确认并发送短信（可选）#

python

python scripts/sms_sender.py --input results.json --mode send --provider aliyun

延迟检测规则#

规则条件严重程度发货超时下单>48h，物流状态仍为「待揽件」🔴 高运输停滞最近更新>24h，状态为「运输中」🟡 中派送异常状态为「异常」「退回」「丢失」🔴 高预计超时当前时间>预计送达时间，未签收🟡 中

API 配置#

物流查询 — UAPI#

• 接口地址： https://uapis.cn/api/v1/misc/tracking/query
• 认证方式：API Key（免费注册即送积分）
• 费用：40积分/次（访客积分有限，建议注册）

配置方式：在 ~/.workbuddy/skills/logistics-care/references/api_config.md 中填写 API Key

短信发送 — 阿里云短信#

• SDK： dysmsapi20170525
• 需要：AccessKey + 短信签名 + 模板CODE

短信发送 — 腾讯云短信（备用）#

• SDK： tencentcloud-sdk-python
• 需要：SecretId + SecretKey + SDK AppID + 模板ID

安抚短信模板策略#

根据延迟原因选择话术风格：

• 发货超时：致歉 + 解释原因 + 新发货时间 + 补偿
• 运输停滞：告知已催促快递 + 预计到达时间 + 致谢耐心
• 派送异常：紧急通知 + 已联系快递处理 + 替代方案
• 预计超时：温和提醒 + 更新预计时间 + 随时联系

每条短信控制在70字以内（1条短信），减少成本。

输出#

1. HTML报告 — 可视化展示所有订单物流状态、延迟摘要、短信发送结果
2. JSON结果 — 结构化数据，可二次处理
3. 短信预览 — 每条短信内容 + 发送状态

技能维护#

• 物流API如有变动，更新 references/api_config.md
• 延迟规则阈值可在 scripts/logistics_checker.py 的 DELAY_RULES 字典中调整
• 安抚话术模板在 scripts/sms_sender.py 的 MESSAGE_TEMPLATES 中维护