Developer webhooks
your server, WAPing’s events
Stop polling the API for every change. Subscribe an HTTPS endpoint and let WAPing POST structured events when conversations and devices move—built for queues, idempotent workers, and CRM sync.
Pain point
Polling hides outages and burns rate limits
If your integration only pulls message logs on a timer, you add latency, race with 429s, and still miss fast failures. Webhooks flip the direction: WAPing calls you when state changes, so workers react in near real time.
Why it matters
Event-driven design matches how support and commerce actually behave: spikes are bursty, and your stack should enqueue work instead of hammering list endpoints.
One clear capability
Configurable HTTPS subscriptions that deliver workspace events to your infrastructure, with retry semantics documented on docs.waping.app.
How it works
- Register a public HTTPS URL in developer settings (exact UI labels may vary).
- Complete verification when prompted—challenge flows are versioned in the canonical docs.
- Return
2xxquickly; offload parsing to a queue worker. - Dedupe using the event identifier in the payload; expect occasional duplicates on retries.
Practical examples
- Ticket creation — on inbound message, enqueue a job that creates or updates a row in your helpdesk.
- Session guardrails — on disconnect events, pause campaigns and notify operators via notifications.
- Warehouse sync — append events to an outbox table for downstream ETL without exposing database credentials to WAPing.
Caveats
- Payloads differ from Meta Cloud API—plan an adapter if you multi-home providers.
- Your endpoint must be reliable; repeated failures trigger backoff and may pause delivery until healthy.
- Signature or shared-secret validation is documented per product version—do not skip verification on production URLs.
Wire your first handler
Confirm plan access, then follow the canonical webhook tutorial.
Where this fits
HTTPS callbacks replace polling when conversations and devices change. Typical flows: support automation, order-driven messaging. Technical entry points: Webhooks guide, Full API reference. Plans and API access are on pricing.
FAQ
Straight answers—same facts as our pricing and security pages.