如何免费使用 WhatsApp Business API（2026版）

如何免费使用 WhatsApp Business API (2026年版)

WhatsApp Business API 允许你通过编程方式发送和接收消息、自动化客户服务并构建聊天机器人。以前，访问此 API 需要通过昂贵的商业解决方案提供商 (BSP)。但在 2026 年，Meta 的 Cloud API 让免费入门成为可能。本指南将通过实际的代码示例带你完成完整的设置过程。

WhatsApp Business API：免费层级概述

Meta 为 WhatsApp Business Cloud API 提供的免费层级包含以下限制：

功能	免费层级	付费层级
服务对话（用户发起）	每月 1,000 条免费	每条对话 $0.005 - 0.08
营销对话	不包含	每条对话 $0.01 - 0.15
测试电话号码	包含 1 个测试号码	无限制的已验证号码
消息模板	250 个模板	250 个模板
媒体消息	支持	支持
Webhook 通知	支持	支持
速率限制	80 消息/秒	500+ 消息/秒

每月 1,000 条免费服务对话会在每月 1 号重置。服务对话是指由用户发起的对话（他们先给你发消息），每个对话窗口持续 24 小时。

前提条件

在开始之前，你需要：

一个 Meta (Facebook) 账号
一个 Meta 商务管理中心账号 (免费创建)
一个可以接收短信或语音电话以进行验证的 电话号码
REST API 的基础知识

分步设置

第 1 步：创建 Meta 开发者账号

1. 访问 https://developers.facebook.com
2. 点击 "入门" 或 "我的应用"
3. 使用你的 Facebook 账号登录
4. 接受开发者条款
5. 使用电话号码验证你的账号

第 2 步：创建一个新应用

1. 在开发者面板中点击 "创建应用"
2. 选择 "商务" 作为应用类型
3. 输入应用名称（例如 "My WhatsApp Bot"）
4. 选择你的 Meta 商务管理中心账号（或创建一个）
5. 点击 "创建应用"

第 3 步：将 WhatsApp 添加到你的应用

1. 在应用面板中，找到 "添加产品"
2. 在 WhatsApp 卡片上点击 "设置"
3. 这会自动创建一个测试 WhatsApp Business 账号
4. 你将看到一个测试电话号码和临时访问令牌 (Access Token)

第 4 步：获取访问令牌

面板中的临时令牌会在 24 小时后过期。对于生产环境，请生成永久的系统用户令牌：

1. 前往 Meta 商务管理中心 > 设置 > 商务管理中心设置
2. 导航到 "系统用户"
3. 点击 "添加" 创建一个新的系统用户
4. 将角色设置为 "管理员"
5. 点击 "生成令牌"
6. 选择你的 WhatsApp 应用
7. 授予以下权限：
   - whatsapp_business_management
   - whatsapp_business_messaging
8. 复制并安全保存该令牌

第 5 步：添加测试收件人

在发送消息之前，你必须将收件人电话号码添加到测试列表中：

1. 在应用面板的 WhatsApp 栏目中
2. 前往 "API 设置"
3. 在 "发送消息" 下，点击 "管理电话号码列表"
4. 添加你想要发送测试消息的电话号码
5. 每个收件人必须通过回复验证消息来进行确认

发送你的第一条消息

使用 cURL

curl -X POST \
  "https://graph.facebook.com/v21.0/YOUR_PHONE_NUMBER_ID/messages" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "1234567890",
    "type": "text",
    "text": {
      "body": "来自 WhatsApp Business API 的问候！"
    }
  }'

使用 Node.js

const axios = require("axios");

const PHONE_NUMBER_ID = "your_phone_number_id";
const ACCESS_TOKEN = "your_access_token";

async function sendWhatsAppMessage(to, message) {
  try {
    const response = await axios.post(
      `https://graph.facebook.com/v21.0/${PHONE_NUMBER_ID}/messages`,
      {
        messaging_product: "whatsapp",
        to: to,
        type: "text",
        text: { body: message }
      },
      {
        headers: {
          Authorization: `Bearer ${ACCESS_TOKEN}`,
          "Content-Type": "application/json"
        }
      }
    );

    console.log("消息已发送:", response.data);
    return response.data;
  } catch (error) {
    console.error("错误:", error.response?.data || error.message);
    throw error;
  }
}

// 发送消息
sendWhatsAppMessage("1234567890", "来自 Node.js 的问候！");

使用 Python

import requests

PHONE_NUMBER_ID = "your_phone_number_id"
ACCESS_TOKEN = "your_access_token"

def send_whatsapp_message(to: str, message: str):
    url = f"https://graph.facebook.com/v21.0/{PHONE_NUMBER_ID}/messages"

    headers = {
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json"
    }

    payload = {
        "messaging_product": "whatsapp",
        "to": to,
        "type": "text",
        "text": {"body": message}
    }

    response = requests.post(url, json=payload, headers=headers)
    response.raise_for_status()
    print("消息已发送:", response.json())
    return response.json()

# 发送消息
send_whatsapp_message("1234567890", "来自 Python 的问候！")

发送富媒体消息

图片消息

def send_image(to: str, image_url: str, caption: str = ""):
    payload = {
        "messaging_product": "whatsapp",
        "to": to,
        "type": "image",
        "image": {
            "link": image_url,
            "caption": caption
        }
    }

    response = requests.post(
        f"https://graph.facebook.com/v21.0/{PHONE_NUMBER_ID}/messages",
        json=payload,
        headers={"Authorization": f"Bearer {ACCESS_TOKEN}"}
    )
    return response.json()

交互式按钮消息

def send_buttons(to: str, body_text: str, buttons: list):
    payload = {
        "messaging_product": "whatsapp",
        "to": to,
        "type": "interactive",
        "interactive": {
            "type": "button",
            "body": {"text": body_text},
            "action": {
                "buttons": [
                    {
                        "type": "reply",
                        "reply": {"id": btn["id"], "title": btn["title"]}
                    }
                    for btn in buttons
                ]
            }
        }
    }

    response = requests.post(
        f"https://graph.facebook.com/v21.0/{PHONE_NUMBER_ID}/messages",
        json=payload,
        headers={"Authorization": f"Bearer {ACCESS_TOKEN}"}
    )
    return response.json()

# 发送带有按钮的消息
send_buttons(
    "1234567890",
    "今天我们可以为您提供什么帮助？",
    [
        {"id": "support", "title": "获取支持"},
        {"id": "pricing", "title": "查看价格"},
        {"id": "demo", "title": "预约演示"}
    ]
)

模板消息（用于主动通知）

要首先给用户发消息（在 24 小时窗口期外），你必须使用审核通过的模板：

def send_template(to: str, template_name: str, language: str = "en_US"):
    payload = {
        "messaging_product": "whatsapp",
        "to": to,
        "type": "template",
        "template": {
            "name": template_name,
            "language": {"code": language},
            "components": [
                {
                    "type": "body",
                    "parameters": [
                        {"type": "text", "text": "John"},
                        {"type": "text", "text": "您的订单 #12345"}
                    ]
                }
            ]
        }
    }

    response = requests.post(
        f"https://graph.facebook.com/v21.0/{PHONE_NUMBER_ID}/messages",
        json=payload,
        headers={"Authorization": f"Bearer {ACCESS_TOKEN}"}
    )
    return response.json()

设置 Webhook

要接收传入的消息，你需要配置一个 Webhook 端点。

Express.js Webhook 服务器

const express = require("express");
const app = express();
app.use(express.json());

const VERIFY_TOKEN = "your_custom_verify_token";

// Webhook 验证 (GET)
app.get("/webhook", (req, res) => {
  const mode = req.query["hub.mode"];
  const token = req.query["hub.verify_token"];
  const challenge = req.query["hub.challenge"];

  if (mode === "subscribe" && token === VERIFY_TOKEN) {
    console.log("Webhook 已验证");
    res.status(200).send(challenge);
  } else {
    res.sendStatus(403);
  }
});

// 接收消息 (POST)
app.post("/webhook", (req, res) => {
  const body = req.body;

  if (body.object === "whatsapp_business_account") {
    body.entry?.forEach((entry) => {
      entry.changes?.forEach((change) => {
        const messages = change.value?.messages;
        if (messages) {
          messages.forEach((message) => {
            console.log("来自:", message.from);
            console.log("类型:", message.type);
            if (message.type === "text") {
              console.log("内容:", message.text.body);
            }
          });
        }
      });
    });

    res.sendStatus(200);
  } else {
    res.sendStatus(404);
  }
});

app.listen(3000, () => {
  console.log("Webhook 服务器运行在端口 3000");
});

公开你的本地服务器

在开发阶段，使用隧道服务公开你的本地 Webhook：

# 使用 ngrok
ngrok http 3000

# 使用 Cloudflare Tunnel
cloudflared tunnel --url http://localhost:3000

然后在 Meta 应用面板的 WhatsApp > 配置 > Webhook URL 中注册该公开 URL。

免费替代方案和补充

如果免费层级的限制过于严格，可以考虑以下选项：

选项	免费消息	备注
Meta Cloud API (官方)	每月 1,000 条服务对话	最适合小型项目
Twilio WhatsApp Sandbox	开发期间免费	需要 Twilio 账号；生产环境付费
WhatsApp Business App (手动)	无限制	无 API 访问权限；仅限手动发送
WATI 免费试用	14 天试用	提供面板和机器人构建器的 BSP

常见错误及解决方案

错误代码	消息内容	解决方案
131030	"收件人手机号不在允许列表中"	将该号码添加到测试收件人列表中
131047	"重新互动消息"	使用审核通过的模板进行首次联系
100	"参数无效"	检查电话号码格式（需包含国家代码，不含 + 或空格）
190	"访问令牌已过期"	生成新的系统用户令牌
368	"因政策原因暂时锁定"	查看 Meta 的商业和消息政策

结论

通过 Meta 的 Cloud API，你可以免费访问 WhatsApp Business API，每月享受 1,000 条免费服务对话。这对于小型企业、原型设计和个人项目来说已经足够了。通过 Meta 开发者门户设置大约需要 30 分钟，之后你就可以通过编程方式发送文本、媒体和交互式消息。

对于希望通过 AI 生成的视频内容来增强 WhatsApp 沟通的企业——例如个性化的产品演示视频或 AI 数字人问候——Hypereal AI 提供了价格合理的视频生成和数字人创建 API，能很好地与 WhatsApp 富媒体消息结合使用。

如何免费使用 WhatsApp Business API (2026年版)

WhatsApp Business API：免费层级概述

Meta 为 WhatsApp Business Cloud API 提供的免费层级包含以下限制：

功能	免费层级	付费层级
服务对话（用户发起）	每月 1,000 条免费	每条对话 $0.005 - 0.08
营销对话	不包含	每条对话 $0.01 - 0.15
测试电话号码	包含 1 个测试号码	无限制的已验证号码
消息模板	250 个模板	250 个模板
媒体消息	支持	支持
Webhook 通知	支持	支持
速率限制	80 消息/秒	500+ 消息/秒

每月 1,000 条免费服务对话会在每月 1 号重置。服务对话是指由用户发起的对话（他们先给你发消息），每个对话窗口持续 24 小时。

前提条件

在开始之前，你需要：

一个 Meta (Facebook) 账号
一个 Meta 商务管理中心账号 (免费创建)
一个可以接收短信或语音电话以进行验证的 电话号码
REST API 的基础知识

分步设置

第 1 步：创建 Meta 开发者账号

1. 访问 https://developers.facebook.com
2. 点击 "入门" 或 "我的应用"
3. 使用你的 Facebook 账号登录
4. 接受开发者条款
5. 使用电话号码验证你的账号

第 2 步：创建一个新应用

1. 在开发者面板中点击 "创建应用"
2. 选择 "商务" 作为应用类型
3. 输入应用名称（例如 "My WhatsApp Bot"）
4. 选择你的 Meta 商务管理中心账号（或创建一个）
5. 点击 "创建应用"

第 3 步：将 WhatsApp 添加到你的应用

1. 在应用面板中，找到 "添加产品"
2. 在 WhatsApp 卡片上点击 "设置"
3. 这会自动创建一个测试 WhatsApp Business 账号
4. 你将看到一个测试电话号码和临时访问令牌 (Access Token)

第 4 步：获取访问令牌

面板中的临时令牌会在 24 小时后过期。对于生产环境，请生成永久的系统用户令牌：

1. 前往 Meta 商务管理中心 > 设置 > 商务管理中心设置
2. 导航到 "系统用户"
3. 点击 "添加" 创建一个新的系统用户
4. 将角色设置为 "管理员"
5. 点击 "生成令牌"
6. 选择你的 WhatsApp 应用
7. 授予以下权限：
   - whatsapp_business_management
   - whatsapp_business_messaging
8. 复制并安全保存该令牌

第 5 步：添加测试收件人

在发送消息之前，你必须将收件人电话号码添加到测试列表中：

1. 在应用面板的 WhatsApp 栏目中
2. 前往 "API 设置"
3. 在 "发送消息" 下，点击 "管理电话号码列表"
4. 添加你想要发送测试消息的电话号码
5. 每个收件人必须通过回复验证消息来进行确认

发送你的第一条消息

使用 cURL

curl -X POST \
  "https://graph.facebook.com/v21.0/YOUR_PHONE_NUMBER_ID/messages" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "1234567890",
    "type": "text",
    "text": {
      "body": "来自 WhatsApp Business API 的问候！"
    }
  }'

使用 Node.js

const axios = require("axios");

const PHONE_NUMBER_ID = "your_phone_number_id";
const ACCESS_TOKEN = "your_access_token";

async function sendWhatsAppMessage(to, message) {
  try {
    const response = await axios.post(
      `https://graph.facebook.com/v21.0/${PHONE_NUMBER_ID}/messages`,
      {
        messaging_product: "whatsapp",
        to: to,
        type: "text",
        text: { body: message }
      },
      {
        headers: {
          Authorization: `Bearer ${ACCESS_TOKEN}`,
          "Content-Type": "application/json"
        }
      }
    );

    console.log("消息已发送:", response.data);
    return response.data;
  } catch (error) {
    console.error("错误:", error.response?.data || error.message);
    throw error;
  }
}

// 发送消息
sendWhatsAppMessage("1234567890", "来自 Node.js 的问候！");

使用 Python

import requests

PHONE_NUMBER_ID = "your_phone_number_id"
ACCESS_TOKEN = "your_access_token"

def send_whatsapp_message(to: str, message: str):
    url = f"https://graph.facebook.com/v21.0/{PHONE_NUMBER_ID}/messages"

    headers = {
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json"
    }

    payload = {
        "messaging_product": "whatsapp",
        "to": to,
        "type": "text",
        "text": {"body": message}
    }

    response = requests.post(url, json=payload, headers=headers)
    response.raise_for_status()
    print("消息已发送:", response.json())
    return response.json()

# 发送消息
send_whatsapp_message("1234567890", "来自 Python 的问候！")

发送富媒体消息

图片消息

def send_image(to: str, image_url: str, caption: str = ""):
    payload = {
        "messaging_product": "whatsapp",
        "to": to,
        "type": "image",
        "image": {
            "link": image_url,
            "caption": caption
        }
    }

    response = requests.post(
        f"https://graph.facebook.com/v21.0/{PHONE_NUMBER_ID}/messages",
        json=payload,
        headers={"Authorization": f"Bearer {ACCESS_TOKEN}"}
    )
    return response.json()

交互式按钮消息

def send_buttons(to: str, body_text: str, buttons: list):
    payload = {
        "messaging_product": "whatsapp",
        "to": to,
        "type": "interactive",
        "interactive": {
            "type": "button",
            "body": {"text": body_text},
            "action": {
                "buttons": [
                    {
                        "type": "reply",
                        "reply": {"id": btn["id"], "title": btn["title"]}
                    }
                    for btn in buttons
                ]
            }
        }
    }

    response = requests.post(
        f"https://graph.facebook.com/v21.0/{PHONE_NUMBER_ID}/messages",
        json=payload,
        headers={"Authorization": f"Bearer {ACCESS_TOKEN}"}
    )
    return response.json()

# 发送带有按钮的消息
send_buttons(
    "1234567890",
    "今天我们可以为您提供什么帮助？",
    [
        {"id": "support", "title": "获取支持"},
        {"id": "pricing", "title": "查看价格"},
        {"id": "demo", "title": "预约演示"}
    ]
)

模板消息（用于主动通知）

要首先给用户发消息（在 24 小时窗口期外），你必须使用审核通过的模板：

def send_template(to: str, template_name: str, language: str = "en_US"):
    payload = {
        "messaging_product": "whatsapp",
        "to": to,
        "type": "template",
        "template": {
            "name": template_name,
            "language": {"code": language},
            "components": [
                {
                    "type": "body",
                    "parameters": [
                        {"type": "text", "text": "John"},
                        {"type": "text", "text": "您的订单 #12345"}
                    ]
                }
            ]
        }
    }

    response = requests.post(
        f"https://graph.facebook.com/v21.0/{PHONE_NUMBER_ID}/messages",
        json=payload,
        headers={"Authorization": f"Bearer {ACCESS_TOKEN}"}
    )
    return response.json()

设置 Webhook

要接收传入的消息，你需要配置一个 Webhook 端点。

Express.js Webhook 服务器

const express = require("express");
const app = express();
app.use(express.json());

const VERIFY_TOKEN = "your_custom_verify_token";

// Webhook 验证 (GET)
app.get("/webhook", (req, res) => {
  const mode = req.query["hub.mode"];
  const token = req.query["hub.verify_token"];
  const challenge = req.query["hub.challenge"];

  if (mode === "subscribe" && token === VERIFY_TOKEN) {
    console.log("Webhook 已验证");
    res.status(200).send(challenge);
  } else {
    res.sendStatus(403);
  }
});

// 接收消息 (POST)
app.post("/webhook", (req, res) => {
  const body = req.body;

  if (body.object === "whatsapp_business_account") {
    body.entry?.forEach((entry) => {
      entry.changes?.forEach((change) => {
        const messages = change.value?.messages;
        if (messages) {
          messages.forEach((message) => {
            console.log("来自:", message.from);
            console.log("类型:", message.type);
            if (message.type === "text") {
              console.log("内容:", message.text.body);
            }
          });
        }
      });
    });

    res.sendStatus(200);
  } else {
    res.sendStatus(404);
  }
});

app.listen(3000, () => {
  console.log("Webhook 服务器运行在端口 3000");
});

公开你的本地服务器

在开发阶段，使用隧道服务公开你的本地 Webhook：

# 使用 ngrok
ngrok http 3000

# 使用 Cloudflare Tunnel
cloudflared tunnel --url http://localhost:3000

然后在 Meta 应用面板的 WhatsApp > 配置 > Webhook URL 中注册该公开 URL。

免费替代方案和补充

如果免费层级的限制过于严格，可以考虑以下选项：

选项	免费消息	备注
Meta Cloud API (官方)	每月 1,000 条服务对话	最适合小型项目
Twilio WhatsApp Sandbox	开发期间免费	需要 Twilio 账号；生产环境付费
WhatsApp Business App (手动)	无限制	无 API 访问权限；仅限手动发送
WATI 免费试用	14 天试用	提供面板和机器人构建器的 BSP

常见错误及解决方案

错误代码	消息内容	解决方案
131030	"收件人手机号不在允许列表中"	将该号码添加到测试收件人列表中
131047	"重新互动消息"	使用审核通过的模板进行首次联系
100	"参数无效"	检查电话号码格式（需包含国家代码，不含 + 或空格）
190	"访问令牌已过期"	生成新的系统用户令牌
368	"因政策原因暂时锁定"	查看 Meta 的商业和消息政策

开始使用 Hypereal 构建

如何免费使用 WhatsApp Business API (2026年版)

WhatsApp Business API：免费层级概述

前提条件

分步设置

第 1 步：创建 Meta 开发者账号

第 2 步：创建一个新应用

第 3 步：将 WhatsApp 添加到你的应用

第 4 步：获取访问令牌

第 5 步：添加测试收件人

发送你的第一条消息

使用 cURL

使用 Node.js

使用 Python

发送富媒体消息

图片消息

交互式按钮消息

模板消息（用于主动通知）

设置 Webhook

Express.js Webhook 服务器

公开你的本地服务器

免费替代方案和补充

常见错误及解决方案

结论

相关文章

如何在 2026 年获取免费的 ChatGPT API Key

面向开发者的 10 大免费 Movie API (2026)

2026年最佳免费开源 LLM API

立即开始构建

开始使用 Hypereal 构建

如何免费使用 WhatsApp Business API (2026年版)

WhatsApp Business API：免费层级概述

前提条件

分步设置

第 1 步：创建 Meta 开发者账号

第 2 步：创建一个新应用

第 3 步：将 WhatsApp 添加到你的应用

第 4 步：获取访问令牌

第 5 步：添加测试收件人

发送你的第一条消息

使用 cURL

使用 Node.js

使用 Python

发送富媒体消息

图片消息

交互式按钮消息

模板消息（用于主动通知）

设置 Webhook

Express.js Webhook 服务器

公开你的本地服务器

免费替代方案和补充

常见错误及解决方案

结论

相关文章

如何在 2026 年获取免费的 ChatGPT API Key

面向开发者的 10 大免费 Movie API (2026)

2026年最佳免费开源 LLM API

立即开始构建