wike-chi whatsapp-outreach — WhatsApp触达 v3.0
Skill Graph： 领域 → [[_index-outreach|多渠道触达领域]] | 上游 ← [[company-research|企业背调]] ← [[_index-outreach|触达领域]] | 下游 → [[delivery-queue|发送队列]] → [[follow-up-signal-monitor|跟进监控]]
v3.0 更新：内置
whatsapp_send工具替代 wacli CLI，无需外部依赖。基于 Baileys WebSocket 协议，无需 Chromium/Puppeteer。QR 码扫码绑定一次后持久化 session。
🎯 使用场景
| 场景 | 说明 |
|---|---|
| WhatsApp直联 | 客户留有WhatsApp号码，直接发送消息 |
| 渠道降级 | 邮件发不了时，降级到WhatsApp |
| 多渠道触达 | 邮件+WhatsApp双通道触达 |
| 文件/目录发送 | 发产品PDF、报价单、企业画册 |
| 快速跟进 | 已有WhatsApp对话的客户，直接跟进 |
📋 消息风格规范
WhatsApp ≠ 邮件开发信！ 必须遵守以下风格规则：
| 规则 | 说明 |
|---|---|
| 长度 | 50-150词，不超过手机一屏 |
| 语气 | 半正式（semi-formal），比邮件轻松但保持专业 |
| Emoji | 可用1-2个，不要过度（🤝 ✅ 📋 可接受，❌🎉🔥 不用） |
| 段落 | 每段1-2句话，用空行分隔 |
| CTA | 明确但不过于推销（"Shall I send you our catalog?" 而非 "BUY NOW"） |
| 开头 | 直呼名字，不用Dear/Sir（"Hi Ahmed," 而非 "Dear Mr. Ahmed,"） |
| 结尾 | 简短落款（"- Wike, Honglong Industrial" 一行即可） |
消息模板
模板1：首次触达（渠道商/集成商）
Hi {name},
I'm Wike from Honglong Industrial — we manufacture conveyor belt processing equipment (slitting, splicing, skiving machines) in China.
I noticed {company} works with conveyor systems in Saudi Arabia. We're looking for a reliable channel partner in the region.
Would you be open to reviewing our product catalog?
- Wike, Honglong Industrial
模板2：首次触达（终端用户）
Hi {name},
I'm Wike from Honglong Industrial. We make conveyor belt processing equipment — slitting machines, splicing presses, and skiving tools.
I understand {company} operates conveyor systems. Our machines help reduce belt maintenance costs by up to 40%.
Shall I share our latest catalog?
- Wike, Honglong Industrial
模板3：跟进（已发邮件无回复）
Hi {name},
I sent an email last week about our conveyor belt equipment. Just wanted to follow up here — happy to answer any questions directly.
Our machines are used by distributors in 30+ countries.
- Wike
模板4：产品目录/报价发送（带文件）
Hi {name},
Here's our product catalog as promised. Key highlights:
- Air-cooled splicing presses (300-3600mm)
- Water-cooled presses for heavy-duty belts
- Complete skiving & slitting solutions
Happy to discuss specific models for your needs.
- Wike
🔧 执行流程
客户有WhatsApp号码？
├─ 是 → 检查 WhatsApp 认证状态（whatsapp_auth_status 工具）
│ ├─ 已认证 → 生成WhatsApp风格消息 → 确认 → 调用 whatsapp_send 发送
│ └─ 未认证 → 提示用户在 设置 > 渠道 > WhatsApp 个人版 中扫码绑定
└─ 否 → 尝试搜索号码（search_whatsapp.py）→ 找到则继续 / 找不到降级到邮件
单条发送流程
- 号码验证：确认客户号码格式（国际格式，如 +966xxxxxxxxx）
- 消息生成：根据客户背景+产品匹配度生成WhatsApp风格消息
- 消息评分：评分>=8.0分才发送（WhatsApp容忍度比邮件低）
- 用户确认：展示消息内容+收件人，等待用户确认
- 发送：调用内置工具
whatsapp_send({to: "号码", message: "消息"}) - 文件发送（可选）：
whatsapp_send({to: "号码", message: "说明", file: "/path/file.pdf", caption: "文件说明"})
批量发送流程（已验证）
实战数据：2026-04-06 沙特客户 8/8 全部成功
Step 1: 搜索号码
└─ 运行 search_whatsapp.py 从 DuckDuckGo 搜索客户 WhatsApp 号码
└─ 结果保存到 whatsapp_search_results.json
Step 2: 更新 Pipeline
└─ 将找到的号码回填到 Excel Pipeline
Step 3: 批量发送
└─ 运行 whatsapp_bulk_send.py --yes
└─ 自动读取 Excel 中有号码的客户
└─ 按行业选择消息模板，个性化生成
└─ 每条间隔 30-60 秒随机延迟
└─ 发送完成自动更新 Excel 状态为「已WhatsApp触达」
Step 4: 结果汇总
└─ 发送结果保存到 whatsapp_send_results.json
└─ Excel 状态列更新
相关脚本
| 脚本 | 路径 | 用途 |
|---|---|---|
search_whatsapp.py |
workspace 根目录 | 搜索客户 WhatsApp 号码 |
工具参考（holo-desktop 内置）
whatsapp_send — 发送消息
通过个人 WhatsApp 账号发送文本或文件。
参数：
to (必需): 收件人号码，国际格式（如 966501234567 或 +966501234567）
message (必需): 消息文本（50-150词，半正式语气）
file (可选): 附件路径（PDF、图片、视频）
caption (可选): 文件说明文字
whatsapp_auth_status — 检查认证
返回：
authenticated: true/false
state: "disconnected" | "connecting" | "qr_ready" | "authenticated" | "error"
accountName: WhatsApp 显示名称
accountNumber: 绑定的手机号
首次绑定
- 打开 holo-desktop 设置 > 渠道 > WhatsApp 个人版
- 点击"扫描二维码绑定"
- 用手机 WhatsApp → 设置 → 关联设备 → 扫码
- 绑定成功后 session 自动持久化，下次启动无需重新扫码
⚙ 配置
# WhatsApp触达配置
max_message_length: 500 # 单条消息最大字符数
quality_score_min: 8.0 # 消息最低评分（满分10分）
quiet_hours: # 静默时段（沙特时间）
start: "23:00" # UTC+3
end: "08:00"
max_daily_per_contact: 3 # 每天每个联系人最多3条
follow_up_delay_hours: 48 # 跟进消息最少间隔48小时
🔗 与其他技能配合
| 技能 | 配合方式 |
|---|---|
| cold-email-generator | 邮件优先，WhatsApp作为补充/降级渠道 |
| email-sender | 邮件发不了时降级到WhatsApp |
| delivery-queue | 共用分段队列，channel=whatsapp |
| customer-intelligence | 根据ICP评分决定是否用WhatsApp触达 |
| honglong-products | 发送产品PDF文件 |
📊 渠道选择逻辑
客户联系方式？
├─ 有邮箱 + 有WhatsApp → 双通道触达（先邮件，48h后WhatsApp跟进）
├─ 只有邮箱 → 邮件触达
├─ 只有WhatsApp → WhatsApp触达
└─ 都没有 → 跳过，记录到Pipeline
⚠️ 安全铁律
- 禁止群发：每条消息必须个性化，禁止模板群发
- 频率控制：同一联系人每天最多3条，间隔≥2小时
- 静默时段：对方当地时间22:00-08:00不发送
- 内容审核：发之前必须让用户确认
- 号码格式：必须使用国际格式（+国家代码+号码）
- 回复即停：客户回复后停止自动跟进，转人工对话
- 拉黑处理：消息发送失败或被标记为垃圾 → 立即停止该联系人所有触达
历史参考：wacli CLI（v3.0 后已废弃）
v3.0 起改用 holo-desktop 内置的 whatsapp_send 工具。wacli 内容折叠保留：
wacli auth / wacli doctor / wacli send text|file / wacli sync|chats|messages
注意事项：sync/send 不能同时运行、JID 格式 号码@s.whatsapp.net、QR码有效期约20秒、LOCK文件残留问题。
版本: 3.0.0 更新: 2026-05-25 依赖: holo-desktop 内置 whatsapp_send 工具（Baileys WebSocket 协议） 实战验证: 2026-04-06 沙特客户 8/8 批量发送成功（wacli CLI 版本）