Chat App Message Service：Chat App 訊息發送 Skill 操作手冊

阿里雲技能市場安裝（推薦）

訪問阿里雲技能市場，搜尋 “ChatApp 訊息發送”進行安裝。

ClawHub 安裝

訪問 ClawHub 平台，搜尋“alibabacloud-chatapp-message-send”查看 Skill 說明和安裝。

其他安裝方式

1. Aliyun CLI >= 3.3.3

運行 aliyun version 校正版本。若未安裝或版本過低：

# macOS / Linux 一鍵安裝或升級到最新版
curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash

# 驗證版本（需 >= 3.3.3）
aliyun version

重要：在調用任何 CLI 前，啟用自動外掛程式安裝與 AI-Mode：

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"

退出時必須關閉：會話結束/任務完成/異常退出，任何退出路徑都需執行 aliyun configure ai-mode disable。

2. 安裝 cams 外掛程式

aliyun plugin install --names aliyun-cli-cams

3. 憑證驗證

安全規則：

• NEVER 讀取、回顯、列印 AK/SK 值

• NEVER 在對話或命令列中要求使用者直接輸入 AK/SK

• NEVER 使用 aliyun configure set 配合明文憑證

• ONLY 使用 aliyun configure list 檢查憑證狀態

aliyun configure list

檢查輸出中是否存在有效 profile（AK / STS / OAuth）。若無有效 profile，請停在此處，從 RAM控制台擷取憑證後，在會話外通過 aliyun configure 或環境變數完成配置，再返回繼續。

4. RAM 許可權

本 Skill 需要以下 RAM Action：

最小權限原則 JSON：

{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "cams:SendChatappMessage",
        "cams:SendChatappMassMessage",
        "cams:ListChatappTemplate",
        "cams:GetChatappTemplateDetail",
        "cams:ListChatappMessage"
      ],
      "Resource": "*"
    }
  ]
}

核心功能

• 支援對話式查詢範本列表和詳情，擷取可用的模板和變數結構。

• 支援自動發送模板訊息和自訂訊息，可跨 24 小時會話視窗觸達使用者。

• 支援會話視窗檢測：逾時自動切回模板訊息流程。

• 支援多語言模板（如 en / zh_CN / zh_HK 等）。

• 支援 ISV 多租戶情境：--cust-space-id。

海外訂單通知

訂單發貨、物流更新、支付確認，是海外業務中常見的訊息觸達情境。

過去，營運人員需要查模板、填變數、準備號碼，再通過控制台或指令碼完成發送。使用 Skill 後，使用者可以直接向 Agent 提出需求，由 Agent 協助完成模板匹配、變數填寫、訊息發送和結果返回。

營銷活動觸達

海外營銷活動中，WhatsApp 常用於新品通知、促銷提醒、會員喚醒等情境。

需要注意的是，WhatsApp 模板訊息仍需提前完成審核，Skill 不會縮短 Meta 的模板審核周期。但在模板審核通過後，Agent 可以協助使用者更高效地調用模板，還能自動驗證號碼格式和模板匹配度，完成客戶名單處理、變數匹配、分批發送和結果複盤。

客服回訪跟進

客服回訪中，24 小時會話視窗是一個重要規則。客戶主動發起會話後，企業可在視窗內發送自由體訊息；視窗外則需要使用模板訊息。

通過 Skill，Agent 可以協助判斷應使用自由體訊息還是模板訊息，並推薦合適的發送方式，協助客服人員減少規則理解和人工判斷成本，避免失敗重發。

這個 skill 支援哪些 AI agent 工具？

目前支援 Claude Code、Cursor、OpenClaw、Qoderwork、悟空等遵循 Agent Skills 標準的工具。更多平台持續接入中。

skill 和控制台的能力有什麼區別？

skill 當前支援發送模板訊息、發送自訂訊息、查詢範本列表、查詢範本詳情。建立模板，訊息控制台功能暫不支援，仍需通過控制台操作。

沒註冊帳號，可以發訊息嗎？

不可以。您需要註冊阿里雲帳號，並開通 Chat App Message Service，完成 WABA 綁定、發送方手機號註冊和模板審核。

個人使用者可以使用嗎？

WhatsApp Business API 需要企業資質。個人使用者如果有公司資訊，可使用企業資質；不支援個人資質發送訊息。

模板變數必須嚴格按格式填寫嗎？

是的。模板變數需要按編號順序填寫（如 1=value1 2=value2 3=value3），Agent 會引導您逐項確認，避免數量或格式錯配。

什麼樣的模板可以用來發訊息？

模板審核狀態為"通過"且語言與目標使用者匹配，即可使用該模板發送訊息。可通過 list-chatapp-template --audit-status pass 查詢已審核模板。

一次可以發多少條訊息？

可以，如果有多個手機號，可以發給多個使用者，只需要告知 Agent 目標手機號列表即可。

自訂訊息只能在 24 小時內發送嗎？

是的。WhatsApp 自訂訊息只能在使用者最近一次訊息後 24 小時內發送，逾時將報 SessionWindowExpired，此時 Agent 會自動切換至模板訊息流程程。