WhatsApp API

WhatsApp, from your code, on the official platform

Create a chat for a phone number, send text, media or an approved template, and get every inbound message, delivery and read status back as a signed webhook. Templates, groups and your own customers' onboarding are API too.

Meta Technology Partner ✦ Official Cloud API ✦ Templates, groups, hosted onboarding

send-template.js

            
Run200 · queuedPOST /messaging/send-message
Acme Hotels
Webhooksyourapp.com/hooks/lodgestory

The most guest-obsessed brands trust Lodgestory to power 50M+ conversations a year

Bombay Shaving Company ELIVAAS Lyskraft COYU BBingo Hotels Bloom Hotels
Templates

Approved templates, authored and sent by API

Outside the 24-hour customer-service window a WhatsApp message must be an approved template. Create templates by API, standard, carousel with media cards, or limited-time offer, with positional or named placeholders, submit them to Meta for review, and send them with their parameters once approved. The template.status_updated webhook tells you the moment the status changes.

  • Up to 512 templates per WhatsApp Business Account; header 60, body 1,024, footer 60 characters, up to 10 buttons.
  • Marketing, Utility or Authentication, locked after submission, with Meta's quality score pushed as template.quality_updated.
  • Header media uploaded through the same API.
Templates in the API reference
New templateWhatsApp Official · Acme Hotels
Name · languagebooking_confirmation · en_US
Category · kindUtility · standard
BodyHi {{1}}, your booking for {{2}} in {{3}} is confirmed. Reply here with any question.
StatusDraft
Submit to Meta
Acme Hotels

Why teams build on it

Send on the official platform

Text, media and templates through Meta's Cloud API, with the delivery and read receipts Meta reports.

Create and manage groups

Create a WhatsApp group by API, add and remove members by number, fetch the invite link, approve join requests.

Onboard your customers' numbers

Mint a one-time hosted link; your tenant signs in with Facebook and the connected channel lands in your workspace.

Webhooks

Every message and status, signed, within seconds

Subscribe an endpoint to message.received, message.sent and message.status_updated and your server hears about every inbound message, every send and every delivered, read or failed status, with the full message in the payload. Template events, group creation and channel connection ride the same envelope.

  • The chat_id on message payloads is the channel thread id, for example [email protected].
  • At least once, unordered: deduplicate on the delivery id, sequence on occurred_at.
  • Replay any delivery from the 30-day log.
Webhook event catalogue
POST yourapp.com/hooks/lodgestory

                
X-Webhook-Signature · sha256=…
Delivery logWhatsApp API · 30 days

Ready to build on WhatsApp?

Create an organisation, enable Developer Access and run your first request against your own workspace today.

Questions, answered

What engineering teams ask before they integrate.

Yes, as long as the customer has messaged you within the last 24 hours. Send type "text" or media to their chat. After the window closes, WhatsApp requires an approved template, which you send as type "template" with its name, language and parameters.

The messaging API sends on WhatsApp Official channels through Meta's Cloud API. Templates exist only on Official channels; unofficial numbers connected by QR code send free text and are worked from the inbox.

Subscribe an endpoint to message.status_updated. Each delivery carries the message id, the chat and the new status: sent, delivered, read or failed, as Meta reports it.

Yes. Hosted WhatsApp onboarding mints a one-time link per tenant; they sign in with Facebook on a page that shows your name, pick the number and enter the PIN. You get the channel id back on your redirect URL, from a poll endpoint, and as a channel.connected webhook.

WhatsApp Business API | Lodgestory