阿里云 Chat App 最近发布了一个消息发送 Skill能让用户在 Claude Code、龙虾、Qoderwork 这类 AI Agent 工具里用自然语言完成 WhatsApp 消息的发送、模板查询和会话管理不用再频繁切控制台也不用手写 JSON 调 API。它把 WhatsApp 的模板查询、消息发送、批量触达封装成了 Agent 可调用的能力你说一句用 order_shipped 模板给这批客户发发货通知查模板、填变量、发消息、解析失败原因就都交给 Agent。这篇从环境配置到发出第一条消息带你完整跑一遍。一、它能干什么Skill 当前提供七项核心能力围绕 WhatsApp 消息的查询和发送二、前提条件不齐后面一定报错发消息前账号侧要备齐这些子账号 AccessKey主账号在 RAM 控制台创建子用户授予 CAMS 相关权限拿到 AccessKey ID 和 Secret。开通 Chat App 消息服务并完成绑定 WhatsApp Business AccountWABA注册并审核通过发送方手机号From创建并审核通过消息模板发模板消息时必须补充一句WhatsApp Business API 需要完成企业认证。三、安装 Skill按你用的工具选一种。阿里云技能市场推荐访问阿里云技能市场搜索ChatApp 消息发送安装。ClawHub访问 ClawHub 平台搜索alibabacloud-chatapp-message-send查看说明并安装。Claude Code把下载的技能压缩包解压后移进技能目录bash# 全局生效所有项目 ~/.claude/skills/ # 仅当前项目生效 项目根路径/.claude/skills/移好后重启 Claude Code 生效。参考 Claude Code 技能文档OpenClaw解压后复制技能目录路径在 OpenClaw 里输入路径直接对话帮我安装一下这个目录下的技能四、环境配置核心按顺序来1. 安装 Aliyun CLI需 ≥ 3.3.3先查版本bashaliyun version没装或版本低一键安装/升级bash# macOS / Linux curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash # 再次验证需 3.3.3 aliyun version2. 开启自动插件安装与 AI-Mode调用任何 CLI 前先开启这几项bashaliyun configure set --auto-plugin-install true aliyun plugin update aliyun configure ai-mode enable aliyun configure ai-mode set-user-agent \ --user-agent AlibabaCloud-Agent-Skills/alibabacloud-chatapp-message-send⚠️ 这一步很重要会话结束、任务完成或异常退出任何退出路径都要关掉 AI-Mode否则可能影响后续使用bashaliyun configure ai-mode disable3. 安装 cams 插件bashaliyun plugin install --names aliyun-cli-cams4. 验证凭证注意安全规则凭证检查只用这一条命令看输出里有没有有效的 profilebashaliyun configure list5. 配置 RAM 权限Skill 需要这几个 Action发送消息、批量发送、查模板列表、查模板详情、查消息列表。最小权限策略json{ Version: 1, Statement: [ { Effect: Allow, Action: [ cams:SendChatappMessage, cams:SendChatappMassMessage, cams:ListChatappTemplate, cams:GetChatappTemplateDetail, cams:ListChatappMessage ], Resource: * } ] }五、实操发出第一条 WhatsApp 消息环境通了就能用了全程自然语言。先查可用模板查询我已审核通过的 WhatsApp 模板列表对应底层命令是list-chatapp-template --audit-status passAgent 会自动调用。需要看某个模板的变量结构时再让它查模板详情它会引导你逐项填参。发模板消息可跨 24 小时窗口适合主动触达用模板 order_shipped语言 en给 8613867404376 发订单发货通知 变量 1订单号 SO123452物流单号 SF998877注意手机号要用纯数字、不带 API 只接受纯数字。模板变量按编号顺序填1、2、3数量和格式要和模板对上。批量发送给一批客户发个性化模板消息给这批客户发订单发货通知用模板 order_shipped语言 en 名单在 /Users/xxx/orders.xlsx每行是手机号订单号物流单号Agent 会解析名单、逐条匹配变量、自动校验号码格式和模板匹配度完成分批发送并返回成功数、失败数和失败原因摘要。发自定义消息仅 24 小时窗口内适合客服实时回复给 8613867404376 发一条 text 自定义消息内容是您的工单已处理完成自定义消息支持 text、image、video、audio、document、interactive、location 七种类型。会话窗口会自动判断如果用户已经超出 24 小时窗口自定义消息会报SessionWindowExpiredSkill 会自动切回模板消息流程不用你手动判断。六、必须搞懂的规则24 小时会话窗口这是 WhatsApp 最容易踩的点单独说一下。WhatsApp 把企业能发的消息分两类规则不同模板消息经过 Meta 审核的固定结构消息任何时候都能发用于主动触达订单通知、营销、验证码。自定义消息自由文本/图片等只能在用户最近一次给你发消息后的 24 小时内发用于会话中的实时回复。超时就报SessionWindowExpired。所以客服回访场景里客户主动来过、还在窗口内就用自定义消息直接回超窗了就得用模板消息。Agent 会帮你判断该用哪种减少人工判断和失败重发。另外提醒模板消息仍需提前在控制台完成 Meta 审核Skill 不会缩短审核周期它优化的是审核通过之后的调用效率。七、常见错误码速查发送失败时对着这张表排查错误码含义解决InvalidParameter.FromOnlyNumeric手机号带了 去掉 用纯数字如 8613867404376TemplateNotFound模板不存在核对 template-code 和 biz-languageTemplateParamInvalid模板变量错误检查变量数量和格式是否和模板匹配SessionWindowExpired24h 会话窗口超时切换到模板消息流程PhoneNumberNotRegistered发送方未注册在控制台完成手机号注册和审核Forbidden.RAMRAM 权限不足按第四步补齐 RAM 权限InvalidAccessKeyId.NotFoundAccessKey ID 错误检查 AK IDSignatureDoesNotMatchAccessKey Secret 错误检查 AK Secret操作指南可查看Chat App 消息发送 Skill 操作手册-Chat App 消息服务(Chat App)-阿里云帮助中心Skill 地址阿里云chatapp消息发送skill - alibabacloud-chatapp-message-send - Agent SKILL详情 - 阿里云 Agent Skills 门户