企业官网建设流程全解析

阿里云 Chat App 最近发布了一个消息发送 Skill，能让用户在 Claude Code、龙虾、Qoderwork 这类 AI Agent 工具里，用自然语言完成 WhatsApp 消息的发送、模板查询和会话管理，不用再频繁切控制台，也不用手写 JSON 调 API。

它把 WhatsApp 的模板查询、消息发送、批量触达封装成了 Agent 可调用的能力：你说一句"用 order_shipped 模板给这批客户发发货通知"，查模板、填变量、发消息、解析失败原因就都交给 Agent。

这篇从环境配置到发出第一条消息，带你完整跑一遍。

一、它能干什么

Skill 当前提供七项核心能力，围绕 WhatsApp 消息的查询和发送：

二、前提条件（不齐后面一定报错）

发消息前，账号侧要备齐这些：

1. 子账号 AccessKey：主账号在 RAM 控制台创建子用户，授予 CAMS 相关权限，拿到 AccessKey ID 和 Secret。
2. 开通 Chat App 消息服务，并完成：
   • 绑定 WhatsApp Business Account（WABA）
   • 注册并审核通过发送方手机号（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）

先查版本：

bash

aliyun version

没装或版本低，一键安装/升级：

bash

# macOS / Linux curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash # 再次验证（需 >= 3.3.3） aliyun version

2. 开启自动插件安装与 AI-Mode

调用任何 CLI 前，先开启这几项：

bash

aliyun 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，否则可能影响后续使用：

bash

aliyun configure ai-mode disable

3. 安装 cams 插件

bash

aliyun plugin install --names aliyun-cli-cams

4. 验证凭证（注意安全规则）

凭证检查只用这一条命令，看输出里有没有有效的 profile：

bash

aliyun configure list

5. 配置 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 pass，Agent 会自动调用。需要看某个模板的变量结构时，再让它查模板详情，它会引导你逐项填参。

发模板消息（可跨 24 小时窗口，适合主动触达）：

用模板 order_shipped（语言 en）给 8613867404376 发订单发货通知， 变量 1=订单号 SO12345，2=物流单号 SF998877

注意：手机号要用纯数字、不带 +（API 只接受纯数字）。模板变量按编号顺序填（1=、2=、3=），数量和格式要和模板对上。

批量发送（给一批客户发个性化模板消息）：

给这批客户发订单发货通知，用模板 order_shipped（语言 en）， 名单在 /Users/xxx/orders.xlsx，每行是手机号+订单号+物流单号

Agent 会解析名单、逐条匹配变量、自动校验号码格式和模板匹配度，完成分批发送，并返回成功数、失败数和失败原因摘要。

发自定义消息（仅 24 小时窗口内，适合客服实时回复）：

给 8613867404376 发一条 text 自定义消息，内容是"您的工单已处理完成"

自定义消息支持 text、image、video、audio、document、interactive、location 七种类型。

会话窗口会自动判断：如果用户已经超出 24 小时窗口，自定义消息会报SessionWindowExpired，Skill 会自动切回模板消息流程，不用你手动判断。

六、必须搞懂的规则：24 小时会话窗口

这是 WhatsApp 最容易踩的点，单独说一下。

WhatsApp 把企业能发的消息分两类，规则不同：

• 模板消息：经过 Meta 审核的固定结构消息，任何时候都能发，用于主动触达（订单通知、营销、验证码）。
• 自定义消息：自由文本/图片等，只能在用户最近一次给你发消息后的 24 小时内发，用于会话中的实时回复。超时就报SessionWindowExpired。

所以客服回访场景里，客户主动来过、还在窗口内，就用自定义消息直接回；超窗了就得用模板消息。Agent 会帮你判断该用哪种，减少人工判断和失败重发。

另外提醒：模板消息仍需提前在控制台完成 Meta 审核，Skill 不会缩短审核周期，它优化的是审核通过之后的调用效率。

七、常见错误码速查

发送失败时对着这张表排查：

操作指南可查看：Chat App 消息发送 Skill 操作手册-Chat App 消息服务(Chat App)-阿里云帮助中心

Skill 地址：阿里云chatapp消息发送skill - alibabacloud-chatapp-message-send - Agent SKILL详情 - 阿里云 Agent Skills 门户