← 返回文档导航

🟢 场景七 · WhatsApp 机器人

流程图(Mermaid)· 一张图看完命令分发:用户发什么 → 机器人按命令类型扇出回什么
用户在 WhatsApp 给 BeeX 官号发消息,机器人解析命令类型后自动回。所有回复都是真发(接 Meta WhatsApp Cloud API),支持英 / 印尼 / 马来 / 中 4 语言。 匹配命中即停:先去重、拦非文本,再依次试 LOGIN / JOIN / 商品链接 / 不支持链接 / 文字命令,最后兜底帮助菜单。

一、主流程图(消息进来 → 命令分发扇出)

flowchart TD
  S1([用户给 BeeX 官号发消息]):::trunk --> S2[Meta Cloud API Webhook 收到]:::trunk
  S2 --> DUP{"已处理过?
(去重)"}:::decision DUP -->|是| STOP([丢弃 · 不重复回]):::trunk DUP -->|否| ACC["任何消息先尝试建账号
未注册的 WA 号一发消息即自动建号"]:::key ACC --> TXT{"是文本消息吗?"}:::decision TXT -->|否(图片/语音/位置)| R9["回:BeeX 暂时只读文字消息。
请发商品链接、你的 JOIN 码,或输入 HELP。"]:::b TXT -->|是| D{"解析命令类型?
(命中即停,按顺序)"}:::decision D -->|"LOGIN 登录码
例:LOGIN SX-ABC123"| C1["校验登录码(5 分钟内)→ 没账号则建 → 签发 token"]:::key C1 --> R1["回:✅ BeeX 登录成功!
点此返回 App:beex.id/auth...
(App 已打开的话回去自动完成)"]:::a D -->|"JOIN 邀请码
例:JOIN BXAB12CD34"| C2["建账号 → 解析码绑定邀请人
🔑 永久锁定 / 防自邀"]:::key C2 --> R2["回:🎉 欢迎加入 BeeX!
你被 BXAB12CD34 邀请。
下载 App 开始赚返佣 👉 beex.id/dl"]:::a D -->|"商品链接
仅 TikTok Shop / Shopee"| R3["回:BeeX 返佣链接已生成 ✅
平台:Shopee · 链接:beex.id/s/x9k2
发 ORDERS 查订单,WALLET 查佣金
(生成失败有友好兜底)"]:::done D -->|"不支持的链接
例:amazon.com/..."| R4["回:BeeX 只支持 TikTok Shop 和 Shopee 商品链接,请发支持的链接。"]:::done D -->|"ORDERS / 订单 / pesanan"| R5["回:BeeX 订单
总数 12 / 待结算 3 / 完成 8 / 取消 1
你的返现:Rp 86,400
最近:Shopee ...3456 / 完成 / Rp 7,200"]:::done D -->|"WALLET / 钱包 / saldo"| R6["回:BeeX 钱包
可用 Rp 120,000 / 待结算 Rp 45,000
冻结 Rp 0 / 累计赚 Rp 380,000"]:::done D -->|"ACCOUNT / 账户 / akun"| R7["回:BeeX 账户
WhatsApp:+62 812... · BeeX ID:usr_198001
推荐码:BXAB12CD34 · 状态:正常"]:::done D -->|"WITHDRAW / 提现"| R8["回:提现暂未在 WhatsApp 支持,请去 App 操作。"]:::done D -->|"HELP / hi / 菜单 / 空 / 乱发(兜底)"| R10["回:BeeX WhatsApp 菜单
1️⃣ 发商品链接拿返佣链接
2️⃣ 发 ORDERS 看订单
3️⃣ 发 WALLET 看佣金
4️⃣ 发 ACCOUNT 看账户"]:::done R1 --> E([机器人回复发出 · 24h 内免费文本]):::trunk R2 --> E R3 --> E R4 --> E R5 --> E R6 --> E R7 --> E R8 --> E R9 --> E R10 --> E classDef trunk fill:#ffffff,stroke:#e8d9b8,color:#1a1410; classDef key fill:#fff5f5,stroke:#dc2626,color:#991b1b,stroke-width:2px; classDef decision fill:#fef3c7,stroke:#e07c00,color:#7a4f24,stroke-width:2px; classDef a fill:#f5f3ff,stroke:#8b5cf6,color:#5b21b6; classDef b fill:#fff7e6,stroke:#f59e0b,color:#b45309; classDef done fill:#f0fdf4,stroke:#15803d,color:#15803d;
主干(收发) 决策点(去重/解析) 关键时刻(建号/绑定/登录) 登录 / 邀请码(🆕 / 关键) 非文本拦截 查询 / 兜底回复
🔑 命令分发的两个底线:① 匹配命中即停、顺序固定——去重 → 非文本拦截 → LOGIN → JOIN → 商品链接 → 不支持链接 → 文字命令 → 兜底帮助菜单; ② JOIN 绑定邀请人永久锁定、防自邀,且任何消息都会先尝试建账号(没注册的 WA 号一发消息就自动建号)。
📌 主动触达说明:用户先发消息后 24 小时内,BeeX 可免费回普通文本。
超 24 小时主动找用户(召回 / 通知)需要用模板消息(已做发送能力 🆕,模板需 Meta 后台预审批)。
✅=已上线:登录、商品链接、不支持链接、ORDERS、WALLET、ACCOUNT、WITHDRAW、兜底帮助;🆕=本期新做:JOIN 邀请码裂变、非文本拦截。

⚙️ 本场景可配参数

运营在管理后台可调的参数 · 当前初始值 · 配置位置 · 说明(数值以线上 / 后台配置为准)

参数当前初始值配置位置说明状态
官号 Phone Number ID / Token配置项properties(whatsapp.*)Cloud API 凭证🟡 配置文件
Graph API 版本v25.0propertiesMeta Graph API 版本🟡 配置文件
机器人总开关待核实properties启停机器人🟡 待核实
LOGIN / JOIN 命令内置代码 dispatcher指令路由(登录 / 邀请码)⛔ 逻辑
不支持链接是否回复 + 文案待核实i18n / config非商品链接的回复策略🟡 待核实
模板消息(超 24h 触达)Meta 模板Meta 后台审核主动触达用户🟡 外部
回复文案(多语言)内置i18n机器人话术🟡
状态:✅ 可配 后台实时改(DB 配置表) · 🟡 待核实 配置文件 / 外部 / 待核实 · ❌ 未接 设计了代码还没接 · ⛔ 写死 故意写死(合规 / 逻辑底线)