BeeX WhatsApp Business 运营配置说明

flowchart LR
  OPS["运营
Meta Business / WhatsApp Manager"]:::ops
  META["Meta Cloud API
graph.facebook.com/v25.0"]:::meta
  subgraph TEST["BeeX ID 测试环境 id-test"]
    WABA_TEST["登录/OTP 号 · WABA 2010663139854304
Phone Number ID 1158162724037776
+62 851-7842-6342"]:::wa
    SUP_TEST["客服号 · WABA 3232775950444594
Phone Number ID 1227019117161727
+62 851-6815-5850"]:::sup
    API_TEST["api-id-test.beexofficial.com
/webhooks/whatsapp"]:::api
  end
  subgraph PROD["BeeX ID 正式环境 id"]
    WABA_PROD["登录/OTP 号 · WABA 2722826034801282
Phone Number ID 1204657329390185
+62 851-6815-5794"]:::wa
    SUP_PROD["客服号 · WABA 2443026896208114
Phone Number ID 1189780530883484
+62 851-9966-4342"]:::sup
    API_PROD["api-id.beexofficial.com
/webhooks/whatsapp"]:::api
  end

  OPS --> META
  META --> WABA_TEST
  META --> SUP_TEST
  META --> WABA_PROD
  META --> SUP_PROD
  WABA_TEST -->|"回调覆盖 → 测试 URL"| API_TEST
  SUP_TEST -->|"回调覆盖 → 测试 URL"| API_TEST
  WABA_PROD -->|"回调覆盖 → 正式 URL"| API_PROD
  SUP_PROD -->|"回调覆盖 → 正式 URL"| API_PROD

  classDef ops fill:#fff7ed,stroke:#fb923c,color:#9a3412;
  classDef api fill:#eff6ff,stroke:#3b82f6,color:#1d4ed8;
  classDef wa fill:#fef3c7,stroke:#e07c00,color:#7a4f24,stroke-width:2px;
  classDef sup fill:#ecfeff,stroke:#0891b2,color:#155e75,stroke-width:2px;
  classDef meta fill:#f5f3ff,stroke:#8b5cf6,color:#5b21b6;
  classDef user fill:#f0fdf4,stroke:#15803d,color:#166534;

sequenceDiagram
  autonumber
  participant O as 运营 Meta 后台
  participant M as Meta Webhook Verify
  participant B as BeeX API
  participant D as BeeX DB
  O->>M: 填 Callback URL + Verify Token
  M->>B: GET /webhooks/whatsapp?hub.challenge=...
  B-->>M: 返回 hub.challenge
  O->>M: 订阅 messages 等字段
  participant U as 用户 WhatsApp
  U->>M: 给 BeeX 官方号发消息
  M->>B: POST /webhooks/whatsapp
  B->>D: wa_inbound_messages 幂等落库
  B->>B: 识别登录 / 邀请 / 商品链接 / 命令
  B-->>M: 200 OK
  B->>M: sendText / sendTemplate
  M-->>U: BeeX 自动回复

flowchart TD
  OPS["运营创建模板
Meta WhatsApp Manager"]:::ops --> LANG{"语言是否为 id？"}:::decision
  LANG -->|"否"| FIX_LANG["补充印尼语 id 版本"]:::warn
  LANG -->|"是"| APPROVE{"状态 Approved？"}:::decision
  APPROVE -->|"否"| WAIT["等待审核 / 修改模板"]:::warn
  APPROVE -->|"是"| TECH["技术用当前环境 WABA 测试发送"]:::api
  TECH -->|"返回 wamid"| OK["模板可用"]:::ok
  TECH -->|"132001"| MISS["当前 WABA 下模板不可见
检查模板名 / 语言 / WABA / 审核状态"]:::warn

  classDef ops fill:#fff7ed,stroke:#fb923c,color:#9a3412;
  classDef decision fill:#fef3c7,stroke:#e07c00,color:#7a4f24,stroke-width:2px;
  classDef api fill:#eff6ff,stroke:#3b82f6,color:#1d4ed8;
  classDef ok fill:#f0fdf4,stroke:#15803d,color:#166534;
  classDef warn fill:#fff5f5,stroke:#dc2626,color:#991b1b;