Quickstart

Send your first alert in about 10 minutes.

Pair a number, make one HTTP request and receive the reply at your webhook.

01 · Pair a number

Open the dashboard, create a connection and scan the QR code from WhatsApp → Linked devices.

02 · Add your key

Set your API key in the request’s Authorization header. Keep it server-side and never expose it in browser code.

03 · Send an alert
curl -X POST https://www.chatrail.dev/v1/messages/text \
  -H 'Authorization: Bearer $CHATRAIL_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"connection":"sandbox","to":"15551234567","body":"A 2-bed just came up.","context":{"listing_id":"HF-2048"}}'
04 · Handle the webhook

Verify the signature, store the event id for idempotency, then use message.received to continue the conversation. A reply can carry a file — see receiving media.

Using an AI agent?

Give it this line: Read https://www.chatrail.dev/SKILL.md and follow it to set up ChatRail. The ChatRail skill tells it when to use ChatRail, what a person has to set up, and how to send and receive safely.

STRAIGHT ANSWERS

Questions before you build?

Start with the documentation or review the practical answers below.

Is ChatRail the official Meta Cloud API?

No. ChatRail uses a WhatsApp Linked Devices session. Review the transport trade-offs before production use.

Can I use it without AI?

Yes. Sending, delivery tracking and webhooks work without enabling AI.

Where should I start?

Use the Quickstart for your first request, then choose a workflow tutorial.