用途:通过 AWS End User Messaging Social 管理 WhatsApp 消息,包括模板管理、发送、媒体处理、事件目标与投递排障。推荐配合 AWS MCP 服务器获得沙箱执行、审计日志与企业管控;也可用于任何具备 AWS CLI 访问权限的智能体,命令均使用标准 AWS CLI 语法。
主要能力: 模板:创建、更新、删除,浏览 Meta 模板库并用库模板创建;查询模板详情需 --id(WABA)与 --meta-template-id;删除需 --template-name(非 --meta-template-name)并始终带 --delete-all-languages;列表响应字段为 templateStatus 和 templateCategory;带 {{N}} 参数的模板必须包含 "parameter_format": "positional" 与 "example"(AUTHENTICATION 例外)。 发送:模板消息无 24 小时限制,用于事务更新、促销、验证码;自由格式消息需在客户最后一条入站消息后 24 小时内,支持文本、图片、文档、视频、音频。--message 为 blob 类型,必须 base64 编码 JSON;messaging_product 必须为 whatsapp。 媒体:上传(返回可复用媒体 ID)、为模板头部上传、按 ID 获取元数据/URL、删除。 事件目标:设置投递跟踪、模板状态通知与重新分类告警;一个 WABA 只能有一个事件目标。 排障:按 WABA 状态 → 电话号码 → 模板 → 事件目标 → 配额顺序排查。
必要用法:需安装并配置 AWS CLI 与凭据,建议使用临时凭据的 IAM 角色;若 aws socialmessaging 子命令不被识别需升级 AWS CLI。所需 IAM 权限按操作划分(模板、发送、媒体、事件、诊断及 sns:ListSubscriptionsByTopic、iam:PassRole),应限定到具体 WABA 与电话号码 ARN。执行前校验参数格式:电话号码 ID 匹配 phone-number-id-,WABA ID 匹配 waba-,收件人用 E.164 带 + 或 BSUID 填入 "recipient",模板名仅小写字母数字下划线,语言用 en_US、pt_BR 等,--meta-api-version 为 v{Major}.{Minor}。
限制:模板需 Meta 审核(数分钟至 24 小时),PENDING/REJECTED 不得发送;分类选错会触发重新分类(如 UTILITY 转 MARKETING)并改变定价;媒体 URL 必须为公开可访问 HTTPS 并保持 30 天可用,敏感内容应上传后用媒体 ID;无 API 查询 24 小时窗口状态;成功 messageId 仅表示排队而非送达。安全上应遵循最小权限、临时凭据、密钥存于 Secrets Manager 或 Parameter Store、启用 CloudTrail 与 KMS 加密,并为 SNS 加条件键。更多细节见资料所列 AWS 文档。