Log inTry for free
Back to all APIs

Receive delivery reports Webhook

Incoming Reports will be forwarded to this endpoint. Please specify the endpoint’s URL for each message via the webhooks > delivery > url parameter. Alternatively you can provide the endpoint’s URL to Customer Support and they will set it up for you. Contact support@infobip.com if you require help.

Learn more about the Zalo Notification Service channel and its use cases
post
https://{yourDomain}/your/webhook/path
Request Body schema:
application/json
collapse all -
results
required
Array of objects
Array
bulkId
required
string

Unique ID assigned to the request if messaging multiple recipients or sending multiple messages via a single API request.

messageId
required
string

Unique message ID.

to
required
string

Message destination address.

sentAt
string

Indicates whether the message was sent. Has the following format: yyyy-MM-dd'T'HH:mm:ss.SSSZ.

doneAt
string

Indicates whether message processing was finished by Infobip (i.e., delivered to the destination, delivered to the destination network, etc.). Has the following format: yyyy-MM-dd'T'HH:mm:ss.SSSZ.

messageCount
integer <int32>

The number of messages were charged for this message request.

mccMnc
string

Mobile country and network codes.

callbackData
string

Callback data sent through callbackData field in message.

price
object

Message price.

pricePerMessage
number

Price per one message.

currency
string

The currency in which the price is expressed.

status
object

Indicates whether the message is successfully sent, not sent, delivered, not delivered, waiting for delivery, or any other possible status.

groupId
required
integer <int32>

Status group ID.

groupName
required
string

Status group name.

id
required
integer <int32>

Status ID.

name
required
string

Status name.

description
required
string

Status description.

error
object

Indicates whether the error occurred during the query execution.

groupId
required
integer <int32>

Error group ID.

groupName
required
string

Error group name.

id
required
integer <int32>

Error ID.

name
required
string

Error name.

description
required
string

Human-readable description of the error.

permanent
required
boolean

Indicator of whether the error is permanent.

entityId
string

Entity used in request.

applicationId
string

Application used in request.

channel
required
string

The channel used for delivering the message.

Responses

200

Your server returns this code if it accepts the callback.

Request samples

Content type
application/json
Copy
 Collapse all
{
  • "results":
    [
    • {
      • "bulkId": "BULK-ID-123-xyz",
      • "messageId": "45db39c3-7822-4e72-a3ec-c87442c0ffz9",
      • "to": "41793026727",
      • "sentAt": "2019-11-09T16:00:00.000+0000",
      • "doneAt": "2019-11-09T16:00:00.000+0000",
      • "messageCount": 1,
      • "price":
        {
        • "pricePerMessage": 0.01,
        • "currency": "EUR"
        },
      • "status":
        {
        • "groupId": 3,
        • "groupName": "DELIVERED",
        • "id": 5,
        • "name": "DELIVERED_TO_HANDSET",
        • "description": "Message delivered to handset"
        },
      • "error":
        {
        • "groupId": 0,
        • "groupName": "OK",
        • "id": 0,
        • "name": "NO_ERROR",
        • "description": "No Error",
        • "permanent": false
        },
      • "entityId": "my-entity-id",
      • "applicationId": "my-application-id",
      • "channel": "ZALO_NOTIFICATION_SERVICE"
      },
    • {
      • "bulkId": "BULK-ID-123-xyz",
      • "messageId": "12db39c3-7822-4e72-a3ec-c87442c0ffc5",
      • "to": "41793026834",
      • "sentAt": "2019-11-09T17:00:00.000+0000",
      • "doneAt": "2019-11-09T17:00:00.000+0000",
      • "messageCount": 1,
      • "price":
        {
        • "pricePerMessage": 0.01,
        • "currency": "EUR"
        },
      • "status":
        {
        • "groupId": 3,
        • "groupName": "DELIVERED",
        • "id": 5,
        • "name": "DELIVERED_TO_HANDSET",
        • "description": "Message delivered to handset"
        },
      • "error":
        {
        • "groupId": 0,
        • "groupName": "OK",
        • "id": 0,
        • "name": "NO_ERROR",
        • "description": "No Error",
        • "permanent": false
        },
      • "entityId": "my-entity-id",
      • "applicationId": "my-application-id",
      • "channel": "ZALO_NOTIFICATION_SERVICE"
      }
    ]
}

Need assistance

Explore Infobip Tutorials

Encountering issues

Contact our support

What's new? Check out

Release Notes

Unsure about a term? See

Glossary

Research panel

Help shape the future of our products
Learn more
Service status

Copyright @ 2006-2025 Infobip ltd.

Privacy documentsTerms of use