Skip to main content
Messaly is built on Meta’s official WhatsApp Cloud API.

Which number sends

GET /whatsapp/numbers tells you which number your messages go out from, and your price per template category:
  • own: your business number, connected in the dashboard under WhatsApp → Settings.
  • shared: the Messaly shared number, used when you haven’t connected one (if it’s available to you). On the shared number you can only send templates you created there, and new templates are reviewed by Messaly before they go to Meta.

Before you start

1

Connect a number

Connect your WhatsApp Business number under WhatsApp → Settings, or use the shared number.
2

Get a template approved

Create one with POST /whatsapp/templates or in the dashboard. Only approved templates can be sent. Approval usually takes minutes.
3

Create an API key with the whatsapp:send scope

Under Settings → API keys.
4

Top up your wallet

Each template message is charged when it’s sent, at its category’s price.

Send a template

Keep the wamid: delivery and read receipts refer to it.
The API only sends templates. WhatsApp lets a business start a conversation only with an approved template. Within 24 hours of a customer’s last message you can reply freely from the WhatsApp inbox in the dashboard.

Campaigns

Send one template to many people, personalised for each:
  1. Estimate it. POST /whatsapp/campaigns/estimate returns the number of recipients, opt-outs, the total cost and whether your wallet covers it. It sends nothing.
  2. Create it. POST /whatsapp/campaigns takes contact lists, tags, or your own upload of up to 10,000 recipients, plus a variableMap that says where each template variable’s value comes from. Add scheduledAt to send later.
  3. Follow it. GET /whatsapp/campaigns/{id} gives counts by status, the amount spent and the latest failures.
If the wallet runs out partway through, the campaign stops with status failed. Top up, then resume it with PATCH /whatsapp/campaigns/{id} {"action":"resume"}. Nobody is messaged or charged twice.

Replies and receipts

Subscribe a webhook to: