WhatsApp文本API

whatsapp2025-10-11 01:11:4019

WhatsApp Business API 全面指南：从核心概念到实际应用

下面我将为您全面解析 WhatsApp Business API，涵盖其核心概念、使用方法、消息格式、费用结构以及重要限制事项。

核心概念：理解 WhatsApp Business API

WhatsApp Business API 是 Meta 公司为企业提供的官方编程接口，使企业能够将 WhatsApp 集成到自有系统中，包括客户关系管理(CRM)、客服平台和企业资源规划(ERP)系统，从而实现与客户的大规模高效沟通。

关键特性解析：

企业专用平台：该 API 不适用于个人通讯场景，专为促进企业与客户之间的正式对话而设计。
严格审核机制：企业资质和所有消息模板都必须通过 Meta 的官方审核流程。
会话基础架构：消息分为两大类型——用户主动发起的会话和企业主动发起的会话（受24小时窗口限制）。
透明收费模式：基于"会话"数量计费，而非API调用次数。

如何使用 WhatsApp Business API？

个人开发者或企业无法直接向 Meta 申请使用此 API，必须通过官方授权的商务解决方案提供商(Business Solution Providers, BSP)。

实施步骤详解：

选择合适的 BSP
- 国际知名提供商：
  - Twilio
  - MessageBird
  - Vonage (原Nexmo)
  - Zendesk
  - 360dialog (Meta官方推荐合作伙伴)
- 国内云服务商：
  - 腾讯云
  - 阿里云
注册商业账户 在选定的 BSP 平台创建账户，并配置 WhatsApp Business 账户，通常需要提供企业名称、官方网站、实体地址等详细信息。
获取API凭证 从 BSP 处获得 API 访问凭证，如 Twilio 的 Account SID 和 Auth Token，或其他提供商的 API Key。
配置Webhook 设置用于接收消息和送达状态的回调 URL，当用户回复消息或消息状态（发送中、已送达、已阅读）发生变化时，Meta 服务器将通过此 Webhook 实时通知您的服务器。

发送文本消息：核心API调用实践

虽然不同 BSP 的 API 端点略有差异，但其核心架构和逻辑基本一致，以下以 Twilio 的 API 为例进行说明，因其接口设计直观易懂。

前提条件：您需要拥有一个已通过审核的消息模板，用于在24小时窗口外主动发起对话。

API 请求示例 (使用 cURL)：

curl -X POST 'https://api.twilio.com/2010-04-01/Accounts/YOUR_TWILIO_ACCOUNT_SID/Messages.json' \
--data-urlencode 'To=whatsapp:+14155552671' \
--data-urlencode 'From=whatsapp:+14155551234' \
--data-urlencode 'Body=您好，这是来自 WhatsApp Business API 的测试消息！' \
-u YOUR_TWILIO_ACCOUNT_SID:YOUR_TWILIO_AUTH_TOKEN

参数详细说明：

WhatsApp文本API

To：接收方的 WhatsApp 号码，格式必须为 whatsapp:+[国家区号][手机号]
From：您的 WhatsApp Business 号码，由 BSP 提供，格式同上
Body：要发送的纯文本内容
-u：用于 HTTP 基本认证的 Twilio 账户 SID 和 Auth Token

其他 BSP (如 Vonage) 的调用示例：

curl -X POST https://messages-sandbox.nexmo.com/v0.1/messages \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -u 'API_KEY:API_SECRET' \
  -d '{
    "from": { "type": "whatsapp", "number": "WHATSAPP_BUSINESS_NUMBER" },
    "to": { "type": "whatsapp", "number": "RECIPIENT_NUMBER" },
    "message": {
      "content": {
        "type": "text",
        "text": "来自 Vonage WhatsApp API 的问候！"
      }
    }
  }'

接收文本消息：Webhook 配置与处理

当用户回复您的消息时,BSP/Meta 会向您预设的 Webhook URL 发送 POST 请求。

简化的 Webhook 请求体示例 (Twilio 格式)：

{
  "SmsMessageSid": "...",
  "NumMedia": "0",
  "ProfileName": "张三",
  "MessageType": "text",
  "SmsStatus": "received",
  "To": "whatsapp:+14155551234",
  "NumSegments": "1",
  "ReferralNumMedia": "0",
  "MessageSid": "...",
  "AccountSid": "...",
  "From": "whatsapp:+14155552671",
  "ApiVersion": "2010-04-01",
  "Body": "您好，我想了解更多关于你们产品的信息。"
}

服务器端处理流程：