Skip to main content
Delivery Reports (DLRs) provide real-time updates about the delivery status of WhatsApp template messages. Instead of polling the API, Beem automatically sends these updates to a callback URL that you configure in the Engage portal under API Setup. See also the Receive template delivery report API reference for the webhook payload schema. Typical delivery events include:
  • Accepted
  • Delivered
  • Read
  • Failed

Real-Time Updates

Receive delivery confirmations automatically as message status changes.

Message Tracking

Monitor campaigns and customer engagement directly within your own systems.

​
How delivery reports work

​
Configure a callback URL

Before receiving delivery reports, you must register a callback URL.
Beem validates your callback URL by sending an HTTP GET request. Your endpoint must return HTTP 200 OK before callbacks are enabled.
1

Sign in

Log in to the Engage Portal.
2

Open API Setup

If your account has WhatsApp Broadcast enabled, navigate to:API Setup
3

Register Callback URL

Paste your callback URL into the provided field.Click Save.Once saved successfully, delivery reports will begin being sent to your application.

​
Callback requirements

Your callback endpoint should:
  • Be publicly accessible
  • Support HTTPS
  • Respond to validation requests with HTTP 200 OK
  • Accept delivery callbacks
  • Return responses quickly
If the callback URL is unreachable or fails validation, delivery reports cannot be delivered.

​
Why use delivery reports?

Delivery Reports allow your application to:
  • Track delivery status in real time
  • Detect failed deliveries
  • Know when messages are read
  • Build delivery dashboards
  • Trigger business workflows automatically
Store the jobId returned by the Send Template endpoint. It can be used to match delivery report callbacks with the original request.