WhatsApp Cloud API for developers
A WhatsApp commerce API packaged for developers: clean REST, predictable contracts, and real-time webhooks.
Where to start
OverviewA WhatsApp commerce API packaged for developers: clean REST, predictable contracts, and real-time webhooks.QuickstartSend your first WhatsApp message via the Public API in a few lines.AuthenticationAuthenticate every Public API request with an nxk_live bearer token.Send TextSend a plain text message within the 24-hour service window.Send MediaSend images, documents, audio, or video.Send TemplateStart conversations outside the 24-hour window with approved templates.Receive MessagesReceive inbound messages and receipts via webhooks.Webhooks OverviewHow webhooks, retries, and auto-disable work.Verifying SignaturesValidate webhook payload authenticity with HMAC.Event CatalogThe list of webhook events Wacommerce sends.API ReferenceCore Public API endpoints with Meta-style routing.ErrorsConsistent error format and status codes.Rate LimitsUnderstand rate limits and how to handle them.IdempotencyAvoid duplicate messages with idempotency keys.PaginationIterate large lists with cursors.REST API vs MCP for AgentsWhen to use the Public REST API versus MCP for AI agents.Set up Hermes AgentConnect the Hermes Agent to the Wacommerce MCP Server.Set up OpenClawConnect OpenClaw to the Wacommerce MCP Server over HTTP.MCP tools referenceTools available on the Wacommerce MCP Server.Agent scopes and safetyLimit what an agent can do with scopes and audit.Create Order & Payment MethodsCreate an order via the Public API and choose a payment method with the payment.method field (qris, virtual_account, manual_transfer, cod, snap/payment_link).Order Operations: Status, Payment & ResiAdvance fulfillment status, mark an order paid (manual methods only), and enter a manual resi from the order detail drawer.Campaign Attribution & Greeting TemplatesTrack campaign/source/greeting per WhatsApp conversation via CRM, not Labels.ChangelogRecent changes to the Public API and MCP.TroubleshootingDiagnose common sending, webhook, and API key problems.FAQShort answers to common questions.