用途:通过 uxc + OpenAPI 调用 WhatsApp Business Platform Cloud API,复用 uxc 的执行、认证与错误处理机制。
主要能力:覆盖电话号码列表、电话号码元数据读取、商务资料读取与更新、外发消息发送。不包含入站 webhook 接收运行时、模板生命周期管理、嵌入式注册、媒体上传下载等完整平台面。固定 Graph API v25.0,基础地址 https://graph.facebook.com/v25.0。
认证:使用 Authorization: Bearer <access_token>。需配置 bearer 凭据并绑定到版本化基础路径,例如 uxc auth credential set whatsapp-cloud --auth-type bearer --secret-env WHATSAPP_CLOUD_ACCESS_TOKEN,以及 uxc auth binding add --id whatsapp-cloud --host graph.facebook.com --path-prefix /v25.0 --scheme https --credential whatsapp-cloud --priority 100;可用 uxc auth binding match 验证映射。
使用方式:前置条件为已安装 uxc、可访问 graph.facebook.com、可访问精选 OpenAPI 模式 URL,并拥有 Meta 应用与具备 Cloud API 权限的 WhatsApp Business 账号及有效令牌、至少一个 phone_number_id(列号码时需 waba_id)。默认使用固定链接命令 whatsapp-openapi-cli,缺失时用 uxc link 创建,再通过 -h 查看操作模式;执行时可用键值或位置 JSON。操作组包括 get:/{waba_id}/phone_numbers、get:/{phone_number_id}、get:/{phone_number_id}/whatsapp_business_profile、post:/{phone_number_id}/whatsapp_business_profile、post:/{phone_number_id}/messages。
限制与护栏:自动化应保留 JSON 输出信封,不使用 --text,优先解析 ok、kind、protocol、data、error。post:/{phone_number_id}/messages 属高风险写入,执行前须显式用户确认。消息投递仍受 WhatsApp 会话规则、模板审批、接收方同意及账号策略状态约束,认证成功不代表发送被允许。v1 不管理媒体上传,发送图片或文档需使用已托管 URL 或现有资源引用。webhook 订阅与校验仅有文档说明,不配置接收运行时;商务资料更新为部分字段,只发送拟修改字段。