Quickstart

Send your first alert in five 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://api.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.

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.