- Home
- Skills
- APIs & Backend
- ChatRail
Works with the AI tools you already use
ChatRail
A developer-first WhatsApp API to send, schedule, and receive messages using a linked number via REST or MCP.
Free
ChatRail
Example session with this skill installed
I need to send a shipping update for order #4092 to +15550109988 using the ChatRail sandbox connection. Include an idempotency key.
- Read your context and instructions
- Compiled the chatrail
I have queued the shipping update for order #4092. The message was sent to the ChatRail API using the sandbox connection with a unique idempotency key to prevent duplicate delivery.
Message Dispatch Details
| Parameter | Value |
|---|---|
| Status | 202 Accepted |
| Recipient | +15550109988 |
| Connection | sandbox |
| Idempotency Key | ship-4092-1715856000 |
| Body | Your order #4092 has been shipped and is on its way! |
# The raw request sent to the API
curl -X POST https://www.chatrail.dev/v1/messages/text \
-H "Authorization: Bearer $CHATRAIL_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: ship-4092-1715856000" \
-d '{
"connection": "sandbox",
"to": "15550109988",
"body": "Your order #4092 has been shipped and is on its way!",
"context": {"order_id": "4092"}
}'
Next steps
- Monitor Webhooks: Watch for
message.sentormessage.deliveredevents to confirm receipt.
Verify Delivery: Use GET /v1/messages/{id} if you need to manually check the current status of this specific ID.
3. Check Connection: Ensure the sandbox connection status remains connected in your dashboard.
Connects securely to your tools. The creator never sees your data.
About this skill
Setting up WhatsApp alerts often requires jumping through Meta's app review hoops and template approvals. This skill bypasses that friction by using a linked-device API, allowing you to send and receive messages from a standard number you already own.
What it does
- Message dispatch sends text and media via HTTP POST requests using a linked WhatsApp session.
- Scheduling defers message delivery to a specific ISO timestamp for reminders or follow-ups.
- Webhook handling receives inbound replies and delivery status updates through signed HMAC-SHA256 events.
- Reliability management uses idempotency keys to prevent duplicate sends and tracks delivery states from queued to read.
- Session monitoring tracks connection health to ensure the linked device remains active and authorized.
How it works
- The user creates an account and links a number by scanning a QR code in the ChatRail dashboard.
- You generate an API key and provide it to the agent via an environment variable.
- The agent sends requests to the REST API using
curlor standard HTTP libraries to interact with the linked number. - You configure a webhook URL to handle incoming messages and status changes asynchronously.
Frameworks & tools
This skill works with any stack capable of making REST calls and receiving HTTPS webhooks. It includes specific setup instructions for Claude Code via an MCP server and provides an OpenAPI specification for automated client generation.
Why this beats prompting it yourself
Writing reliable WhatsApp integrations requires complex logic for idempotency, signature verification, and handling specific HTTP error states like rate limits or revoked sessions. This skill provides the exact implementation patterns for the ChatRail API, ensuring you do not accidentally trigger bans or double-send messages.
Use cases
- Send automated order updates or shipping notifications to customers.
- Build a custom monitoring bot that sends server alerts to a private group.
- Create a simple support desk that routes WhatsApp replies to a shared inbox.
- Schedule recurring reminders for appointments or subscription renewals.
Known limitations
Does not support Meta official Cloud API features like the green checkmark or business profiles. Linked sessions can lapse if the phone is disconnected, requiring a manual QR scan to reconnect.
How to install
Works the same in every agent - Claude, Cursor, Codex, Copilot and 20+ more.
- 1
Download the ZIP
Free skills download straight away. Paid skills unlock right after purchase.
- 2
Unzip into your skills folder
Every agent reads skills from one folder on your machine. Drop the unzipped folder in there.
- 3
Ask your agent to use it
Restart the agent if it was already running. It picks the skill up automatically - no config needed.
Skills folder by agent
Click the path to copy it. Create the folder if it does not exist yet.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill passes our trust checks below.
Security scanned
Passed our 8-point scan before listing
Fresh listing
Recently published to Agensi
Free forever
No account required to browse
Trust & safety
Security scanned
Verified clean 1 day ago
- Free to download with an account
Needs access to