如何使用Python通过WhatsApp API自动发送消息

使用Python通过WhatsApp API自动发送消息，需要借助Meta提供的WhatsApp Business Platform接口，结合requests库完成HTTP请求发送，实现文本、模板消息等内容的自动推送。

前期准备工作

在开始编码前，需要完成以下基础配置：

• 拥有Meta开发者账号，并创建WhatsApp Business应用
• 获取应用的访问令牌（Access Token）和电话号码ID（Phone Number ID）
• 确保接收消息的号码已经通过验证，或者处于测试模式允许的号码列表中
• 本地安装Python环境，以及requests第三方库，可通过pip install requests命令安装

核心实现步骤

1. 构造基础请求参数

WhatsApp API的消息发送接口需要携带认证信息、目标号码、消息内容等参数，首先定义基础配置变量：

import requests

# 基础配置，替换为自己的实际凭证
ACCESS_TOKEN = "你的WhatsApp应用访问令牌"
PHONE_NUMBER_ID = "你的电话号码ID"
API_VERSION = "v18.0"  # API版本，根据官方最新版本调整
BASE_URL = f"https://graph.facebook.com/{API_VERSION}/{PHONE_NUMBER_ID}/messages"

2. 发送文本消息实现

文本消息是最基础的消息类型，需要指定接收方号码和消息正文，构造请求头和请求体后发送POST请求：

def send_text_message(to_number, message_content):
    # 请求头，携带认证信息
    headers = {
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json"
    }
    # 请求体，符合WhatsApp API格式要求
    payload = {
        "messaging_product": "whatsapp",
        "to": to_number,
        "type": "text",
        "text": {
            "body": message_content
        }
    }
    # 发送请求
    response = requests.post(BASE_URL, headers=headers, json=payload)
    # 返回响应结果
    return response.status_code, response.json()

# 测试发送，替换为实际接收号码
status_code, result = send_text_message("接收方号码带国际区号", "这是Python自动发送的测试消息")
print(f"发送状态：{status_code}")
print(f"返回结果：{result}")

3. 发送模板消息实现

如果是向未主动联系过你的用户发送消息，需要使用预先审核通过的模板消息，实现方式如下：

def send_template_message(to_number, template_name, language_code="zh_CN"):
    headers = {
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json"
    }
    payload = {
        "messaging_product": "whatsapp",
        "to": to_number,
        "type": "template",
        "template": {
            "name": template_name,
            "language": {
                "code": language_code
            }
        }
    }
    response = requests.post(BASE_URL, headers=headers, json=payload)
    return response.status_code, response.json()

常见问题排查

注意事项

使用WhatsApp API发送消息需要遵守Meta的平台规则，避免发送垃圾消息，否则可能导致应用被封禁。同时访问令牌属于敏感信息，不要硬编码在公开代码中，建议通过环境变量等方式存储。如果需要批量发送消息，建议添加请求间隔，避免触发接口限流规则。

PythonWhatsApp_API自动发送消息requests库修改时间：2026-06-28 10:12:25