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
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:- Estimate it.
POST /whatsapp/campaigns/estimatereturns the number of recipients, opt-outs, the total cost and whether your wallet covers it. It sends nothing. - Create it.
POST /whatsapp/campaignstakes contact lists, tags, or your own upload of up to 10,000 recipients, plus avariableMapthat says where each template variable’s value comes from. AddscheduledAtto send later. - Follow it.
GET /whatsapp/campaigns/{id}gives counts by status, the amount spent and the latest failures.
failed. Top up, then resume it with PATCH /whatsapp/campaigns/{id} {"action":"resume"}. Nobody is messaged or charged twice.