WhatsApp Business API 接入指南：打造企业级消息助手

前言

WhatsApp 作为全球用户量最大的即时通讯应用，拥有超过 20 亿活跃用户。通过 OpenClaw 接入 WhatsApp Business API，你可以构建企业级的客服机器人、通知系统和自动化工作流。本文将详细介绍完整的接入流程。

一、WhatsApp Business API 概述

WhatsApp Business API 是 WhatsApp 官方为企业提供的商业通讯接口，具有以下特点：

• 官方认证：企业账号带有绿色认证标识
• 模板消息：支持预审核的消息模板发送
• 多客服协作：多人同时管理同一账号
• 数据分析：完整的消息送达和阅读统计

二、接入前的准备工作

2.1 注册 Facebook Business Manager

WhatsApp 隶属于 Meta，因此需要先注册 Facebook Business Manager：

1. 访问 business.facebook.com
2. 创建企业账户并完成验证
3. 添加 WhatsApp 产品到你的业务账户

2.2 申请 WhatsApp Business API

有两种申请方式：

方式一：直接向 Meta 申请

1. 进入 Business Settings
2. 点击 Accounts → WhatsApp Accounts
3. 添加新的 WhatsApp 账号
4. 完成企业验证流程

方式二：通过 BSP (Business Solution Provider)

推荐 BSP：

• Twilio
• MessageBird
• WATI

三、OpenClaw 配置步骤

3.1 获取凭证

申请成功后，你将获得：

• Phone Number ID
• Permanent Access Token
• WhatsApp Business Account ID

3.2 配置 OpenClaw

编辑 config.json，添加 WhatsApp 插件：

{
  "plugins": {
    "entries": [
      {
        "name": "whatsapp",
        "enabled": true,
        "config": {
          "phoneNumberId": "YOUR_PHONE_NUMBER_ID",
          "accessToken": "YOUR_ACCESS_TOKEN",
          "webhookVerifyToken": "YOUR_VERIFY_TOKEN"
        }
      }
    ]
  }
}

3.3 配置 Webhook

WhatsApp 需要一个公网可访问的 Webhook 地址接收消息：

Webhook URL: https://your-domain.com/webhooks/whatsapp
Verify Token: 自定义验证字符串

在 Facebook Developer Console 中完成 Webhook 验证。

四、发送消息示例

4.1 发送文本消息

向 OpenClaw 发送指令：

用 WhatsApp 发消息给 +8613800138000：
您好，您的订单已发货，预计明天送达。

4.2 发送模板消息

WhatsApp 要求首次联系用户必须使用模板消息：

{
  "messaging_product": "whatsapp",
  "to": "8613800138000",
  "type": "template",
  "template": {
    "name": "order_confirmation",
    "language": { "code": "zh_CN" },
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "订单号 #12345" }
        ]
      }
    ]
  }
}

五、高级功能

5.1 自动回复

配置 OpenClaw 的自动回复规则：

{
  "autoReply": {
    "enabled": true,
    "greeting": "您好！我是智能客服，请问有什么可以帮您？",
    "keywords": {
      "订单": "请提供您的订单号，我帮您查询物流信息",
      "退货": "退货申请已提交，客服将在24小时内联系您"
    }
  }
}

5.2 工作时间路由

{
  "businessHours": {
    "timezone": "Asia/Shanghai",
    "schedule": {
      "monday": { "start": "09:00", "end": "18:00" },
      "friday": { "start": "09:00", "end": "18:00" }
    },
    "afterHours": "感谢您的咨询，我们的工作时间是周一至周五 9:00-18:00，您的消息已收到，我们将在工作时间内回复。"
  }
}

六、费用说明

WhatsApp Business API 采用会话计费模式：

• 用户发起会话：免费（24小时内回复）
• 企业发起会话：按消息类型收费
• 模板消息：约 .005-0.09/条（因地区而异）

七、注意事项

1. 首次联系用户必须在用户同意前提下进行
2. 24小时会话窗口外只能发送模板消息
3. 避免发送营销垃圾信息，可能导致账号被封
4. 定期检查消息质量评分

结语

通过 OpenClaw 接入 WhatsApp Business API，你可以轻松构建专业的企业通讯解决方案。从客服机器人到订单通知，WhatsApp 的全球覆盖能力将为你的业务带来巨大价值。立即开始你的 WhatsApp 自动化之旅吧！