WHATSAPP API

A WhatsApp API built for operational workflows

Connect an existing WhatsApp number, send alerts with structured context and receive replies and delivery events through webhooks.

Send and receive WhatsApp messages without rebuilding your application around a chat platform.

Existing numbers

Pair a normal WhatsApp account through Linked Devices and keep it available on the phone.

Event-driven

Send from your application with one HTTP request and receive replies at your webhook.

Context included

Associate application data with an alert so optional AI replies can stay relevant.

What the API does

ChatRail provides a workspace-scoped HTTP API for sending messages, tracking delivery state and receiving inbound replies. Your application remains the system of record. ChatRail handles the WhatsApp connection and preserves the relationship between an outbound alert, its attached context and later replies.

A minimal send

curl -X POST https://api.chatrail.dev/v1/messages/text \ + -H "Authorization: Bearer $CHATRAIL_API_KEY" \ + -H "Idempotency-Key: order-2048-dispatched" \ + -H "Content-Type: application/json" \ + -d '{"connection":"operations","to":"+14155550142", "body":"Order CR-2048 has shipped.", "context":{"order_id":"CR-2048","status":"dispatched"}}'

Use a server-side API key and a stable idempotency key. Never place credentials in browser code.

Where it fits

Use ChatRail for alerts, status updates, approvals, monitoring and other workflows where a recipient may reply. It is not a replacement for your database, authorization system or customer-support process.

Limits you should understand

ChatRail currently connects through WhatsApp Linked Devices rather than the official Meta Cloud API. Sessions can disconnect, account enforcement remains controlled by WhatsApp, and high-risk or non-consensual messaging can lead to restrictions. Use opted-in recipients, conservative sending patterns and a reconnection procedure.

Frequently asked questions

Is this the official WhatsApp Cloud API?

No. ChatRail uses a linked-device session against a normal WhatsApp account.

Can customers reply?

Yes. Inbound messages and status changes can be delivered to your webhook.

Is AI required?

No. Messaging, webhooks and delivery state work without enabling AI.

BUILD A CONTROLLED TEST

Start with one number and one real workflow.

Validate the connection, delivery state and reply path before increasing traffic.

Gain Access