Works with the AI tools you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+22 more

    ChatRail

    2

    A developer-first WhatsApp API to send, schedule, and receive messages using a linked number via REST or MCP.

    Free

    Security scanned
    ChatRail

    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

    ParameterValue
    Status202 Accepted
    Recipient+15550109988
    Connectionsandbox
    Idempotency Keyship-4092-1715856000
    BodyYour 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

    1. Monitor Webhooks: Watch for message.sent or message.delivered events 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

    1. The user creates an account and links a number by scanning a QR code in the ChatRail dashboard.
    2. You generate an API key and provide it to the agent via an environment variable.
    3. The agent sends requests to the REST API using curl or standard HTTP libraries to interact with the linked number.
    4. 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.

    ~30 seconds
    1. 1

      Download the ZIP

      Free skills download straight away. Paid skills unlock right after purchase.

    2. 2

      Unzip into your skills folder

      Every agent reads skills from one folder on your machine. Drop the unzipped folder in there.

    3. 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

    Chatrail

    Listed1 day ago

    What's inside

    Frequently Asked Questions