RCS Message Skill
Send and receive SMS / RCS via the mobile SMS interface.Use when the user asks to send a text message, check text messages, use SMS, text message, RCS, or needs to forward or mass send received text messages.
Overview
This skill provides message sending capabilities through channel-based delivery with template support, fallback handling, and natural language command parsing.
Requirements
- Python 3.6 or higher
- requests library
- python-dotenv library (optional)
- Valid API credentials (APP_ID, APP_SECRET)
Configuration
API Endpoint
| Item | Value |
|---|---|
| API Server | https://5g.fontdo.com (pre-configured) |
| Endpoint | /messenger/api/v1/group/send |
| Method | POST |
Environment Variables
Set environment variables:
export FIVE_G_APP_ID="your-app-id"
export FIVE_G_APP_SECRET="your-app-secret"
Or create a .env file in the project root:
FIVE_G_APP_ID=your-app-id
FIVE_G_APP_SECRET=your-app-secret
Quick Reference
| Action | Command |
|---|---|
| Send text message | python3 send.py -n "+8613700000001" -m "Hello" |
| Send template | python3 send.py --type RCS --template-id "ID" -n "+8613700000001" |
| Validate only | python3 send.py -n "+8613700000001" --dry-run |
Usage
Natural Language Commands
Use simple commands in Moltbot:
Send a message to 13700000001 with hello world
Send a template message using RCS template 269000000000000000 to 13700000001
Command Line
Basic message sending:
python3 send.py -n "+8613700000001" -m "Hello"
Template message:
python3 send.py --type RCS --template-id "TEMPLATE_ID" -n "+8613700000001" --params "name:John,code:12345"
With fallback channels:
python3 send.py --type RCS --template-id "TEMPLATE_ID" -n "+8613700000001" --fallback-aim "FALLBACK_ID" --fallback-sms "SMS Content"
Parameters
| Parameter | Description |
|---|---|
| -n, --numbers | Recipient number(s), comma separated |
| -m, --message | Message content for TEXT type |
| -t, --type | Message type: TEXT, RCS, AIM, MMS, SMS |
| --template-id | Template ID for non-TEXT types |
| --params | Template parameters as key:value pairs |
| --fallback-aim | Fallback template ID for AIM channel |
| --fallback-sms | Fallback content for SMS channel |
| --dry-run | Validate parameters without sending |
Message Types
| Type | Description |
|---|---|
| TEXT | Direct text content delivery |
| RCS | Rich Communication Services messaging |
| AIM | Advanced Interactive Messaging |
| MMS | Multimedia Messaging Service |
| SMS | Short Message Service fallback |
Validation Rules
| Rule | Limit |
|---|---|
| Maximum recipients | 100 per request |
| Maximum message length | 1000 characters |
| Minimum interval | 60 seconds between requests |
| Number format | International format supported |
Troubleshooting
| Problem | Solution |
|---|---|
| Authentication Error (403) | Verify APP_ID and APP_SECRET are correct. Confirm application is active. |
| Rate Limit Error | Wait 60 seconds before retry. Adjust MIN_INTERVAL_SECONDS in config. |
| Format Error | Use international format (+8613700000001) or domestic format (13700000001). |
Enable debug mode for detailed output:
python3 send.py -n "+8613700000001" -m "Test" --debug
Project Structure
rcs-message/
├── send.py # Core sending module
├── main.py # Entry point
├── handle_user_input.py # Command parser
├── check_config.py # Config validator
├── config.example.json # Config template
└── USAGE_EXAMPLES.md # Additional examples
Limitations
- API credentials required for authentication
- Rate limiting applies to prevent abuse
- Session management handled per deployment
Security
- Credentials stored in environment variables
- No hardcoded sensitive values
- Input validation on all parameters
Version
1.0.0