Chat App Message Service:Chat App Message Sending Skill

Install from Alibaba Cloud Skill Marketplace (recommended)

Go to Alibaba Cloud Skill Marketplace, search for "ChatApp Message Sending", and install it.

Install from ClawHub

Visit the ClawHub platform and search for "alibabacloud-chatapp-message-send" to view the skill's documentation and install it.

Other installation methods

Aliyun CLI >= 3.3.3

Run aliyun version to check your current version. If Aliyun CLI is not installed or the version is too old:

# For macOS or Linux, install or upgrade to the latest version:
curl -fsSL https://aliyuncli.alicdn.com/setup.sh | bash

# Verify the version (must be >= 3.3.3)
aliyun version

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"

Install the CAMS plug-in

aliyun plugin install --names aliyun-cli-cams

Verify credentials

aliyun configure list

Check the output for a valid profile (AccessKey (AK), Security Token Service (STS), or OAuth). If no valid profile exists, do not proceed. Obtain a credential from the RAM console and configure it outside the session by using aliyun configure or environment variables before proceeding.

RAM permissions

The following RAM actions are required:

Minimum permission policy JSON:

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

International order notifications

Shipment notifications, logistics updates, and payment confirmations are common in cross-border commerce.

Previously, operations staff had to find the right template, fill in variables, and prepare phone numbers before sending messages through a console or script. With this skill, you state your needs to the agent, and it handles template matching, variable population, message sending, and result reporting.

Marketing campaign outreach

In international marketing, WhatsApp is often used for new product announcements, promotional reminders, and re-engaging members.

WhatsApp template messages must be pre-approved, and the skill does not shorten Meta's template review period. However, once a template is approved, the agent can help you use it more efficiently. It can also validate phone number formats and template matches, handle customer lists, match variables, send messages one by one in sequence, and review results.

Customer service follow-up

The 24-hour session window is a critical rule in customer service. After a customer initiates a conversation, a business can send free-form messages within this window. Outside the window, template messages are required.

The skill helps the agent determine whether to use a free-form or template message and recommends the appropriate method. This reduces the cognitive load on customer service staff and helps prevent sending failures.

Which AI agent tools does this skill support?

Currently supports tools that follow the Agent Skills standard, such as Claude Code, Cursor, OpenClaw, Qoderwork, and Wukong. Support for more platforms is in development.

What is the difference between the skill's capabilities and the console's?

The skill supports sending template messages, sending custom messages, querying template lists, and querying template details. Creating templates and other message console features are not yet supported and still require manual operation through the console.

Can I send messages without registering an account?

No. You must register for an Alibaba Cloud account, activate the Chat App Message Service, bind your WABA, and complete the registration and approval for your sender phone number and message templates.

Can individual users use this service?

Individual users can use the service only if they provide valid business qualifications. Using the service with personal qualifications is not supported.

Do template variables need to be filled in a specific format?

Yes. Template variables must be populated in numerical order (for example, 1=value1 2=value2 3=value3). The agent will guide you through confirming each one to prevent mismatches in count or format.

Which templates can be used for sending messages?

You can use any template that has an "Approved" status and a language that matches the target user. You can query for approved templates using the list-chatapp-template --audit-status pass command.

How many messages can I send at once?

Yes. If you have multiple phone numbers, you can send to multiple users. Provide the agent with the list of target phone numbers.

Can custom messages only be sent within 24 hours?

Yes. WhatsApp custom messages can only be sent within 24 hours of the user's last message. After this period, you will receive a SessionWindowExpired error, and the agent will automatically switch to the template message workflow.