Short Message Service skill

Capabilities

Advantages

• Conversational message sending: Instead of frequently accessing the console, you can query signatures, templates, and send messages using natural language directly within agent tools like Claude Code, Qoderwork, Wukong, and OpenClaw.

• Simplified file preparation: Traditional batch sending requires strict formatting for phone number files and variables, where incorrect formats can cause task failures. With the skill, you only need to provide the path to a local file. The agent can parse Excel, TXT, and CSV files and assist with variable matching.

• Automatic summary of sending results: After sending, the skill returns the success count, failure count, and a breakdown of failure reasons. It also lets you query delivery records and statistics by dimensions such as time, signature, and template.

• Flexible data analysis: Unlike the console's fixed filtering dimensions, the skill allows you to specify statistical criteria using natural language, such as "summarize sending volume by signature for the last three days," "compare last week's sending to this week's," or "show this month's success rate trend."

Install from the marketplace (recommended)

Qoderwork

1. Open Qoderwork and go to the Capability Marketplace.

2. Search for "Short Message Service" and click Install.

3. After installation, verify that the skill is enabled.

Install by manual upload

If the Short Message Service skill is not available in the marketplace or you need to install it offline, follow these steps to install it manually.

General Steps

1. Download the Short Message Service skill package alibabacloud-sms-send.zip from the Alibaba Cloud Skills Platform.

2. In your AI tool's skill center, upload the skill package.

3. Verify that the skill's status is enabled.

The following sections provide specific instructions for each tool.

Install the runtime environment

The AI tool automatically installs the required environment the first time you select the skill and ask a question.

Configure your Alibaba Cloud AccessKey

After the runtime environment is installed, configure your AccessKey to authorize the skill to access the Short Message Service API.

1. Obtain your AccessKey ID and AccessKey Secret.

   Log in to the RAM console. On the details page for your RAM user, create or view the AccessKey. For more information, see Create an AccessKey.

2. Open a terminal and run the following command to open the configuration file:

   open ~/.aliyun/config.json

3. Add your AccessKey to the configuration file, as shown in the following example:

   {
     "current": "default",
     "profiles": [
       {
         "name": "default",
         "mode": "AK",
         "access_key_id": "<your_access_key_id>",
         "access_key_secret": "<your_access_key_secret>",
         "region_id": "cn-hangzhou",
         "output_format": "json",
         "language": "en",
         "site": "china",
         "auto_plugin_install": true
       }
     ],
     "meta_path": ""
   }

   Replace <your_access_key_id> and <your_access_key_secret> with your actual AccessKey ID and AccessKey Secret.

4. Save the configuration file.

Verify the configuration

After configuration, send a prompt like "list my signatures" to the Short Message Service skill in your agent tool. If it returns your signature data, the configuration is successful. If an authentication error occurs, check that your AccessKey is correct and that the RAM user has been granted the AliyunDysmsFullAccess and AliyunDysmsReadOnlyAccess permissions.

Supported operations

• Conversationally query qualification, signature, and template details to find available options.

• Automatically send single or bulk messages by reading phone numbers and variables from local files.

• Query delivery details and parse failure reasons.

• Analyze up to three years of sending data from multiple dimensions.

Common use cases

Supported AI agent tools

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

Skill vs. console capabilities

The skill currently supports sending messages, querying qualifications, signatures, templates, delivery records, and statistics. Features such as billing inquiries, plan management, and expedited review requests are not yet supported. Use the console for these tasks.

Sending without an account

No. You must register an Alibaba Cloud account, activate Short Message Service, and have an approved qualification, signature, and template before you can send messages.

Individual user support

Message sending requires an enterprise qualification. Individual users with enterprise information can create a qualification for enterprise use. Qualifications for individual use are not supported for sending messages.

Phone number file format

No. You can use local files in Excel, TXT, or CSV format. As long as the file contains phone numbers and the necessary variables, the agent can parse and match the data.

Requirements for signatures and templates

To send messages, you need an approved signature and an approved template. The signature's state must also be either "Available-Abnormal" or "Available-Normal."

Batch sending limit

You can send up to 100 messages per batch. If you need to send more than 100, split them into multiple batches.