用途：实现与 Meta 官方 WhatsApp Business Cloud API 的专业集成，覆盖消息发送、接收、模板与客服自动化，提供 Node.js/TypeScript 和 Python 两种技术栈的样板代码（boilerplate）。适用触发场景包括用户提到 whatsapp、whatsapp business、api whatsapp、chatbot whatsapp、mensagem whatsapp、template whatsapp 等；与 WhatsApp Cloud API 无关、或可用更简单专用工具处理、或只需通用协助时不宜使用。
主要能力：基于 Graph API v21.0，基址 https://graph.facebook.com/v21.0/{phone-number-id}/messages，使用 Bearer Token（生产环境建议 System User Token）认证。支持文本、模板、图片、文档、视频、音频、交互按钮、交互列表、位置、联系人、表情回应等消息类型，并给出各类型长度或体积上限。支持通过 GET 完成 webhook 验证、通过 POST 接收消息与状态，且要求以 HMAC-SHA256（X-Hub-Signature-256）校验签名，使用 timingSafeEqual 或 compare_digest 防时序攻击。还涵盖 24 小时会话窗口、state machine 客服流程、AI 集成、WhatsApp Flows、购物目录、模板管理 API、Channels、Click-to-WhatsApp 广告、状态追踪、Quality Rating 与 Tier 限额体系、合规清单与常见故障排查。
使用方式：需具备 Meta Business Suite 账号、Meta for Developers 应用（含 WhatsApp 产品）、已验证电话号码和 System User Token。可用脚本创建项目：python scripts/setup_project.py --language nodejs --path ./meu-projeto（或 --language python）。需要配置环境变量 WHATSAPP_TOKEN、PHONE_NUMBER_ID、WABA_ID、APP_SECRET、VERIFY_TOKEN。可用 python scripts/send_test_message.py --to 5511999999999 --message "Teste de integracao" 验证发送，用 python scripts/validate_config.py 校验配置。webhook 需 HTTPS 且 5 秒内返回 200，开发可用 ngrok。
限制：需先获得显式 opt-in 并提供退订机制；模板须先审批；客服回复仅在 24 小时窗口内免费，窗口外只能发模板并计费；有质量评级和按 Business Portfolio 的层级限额。定价、限额等具体数字以资料所述 2026 年信息为准，实际以 Meta 官方为准。输出不替代针对具体环境的验证、测试或专家评审。