Receive seen reports Webhook

For each message that you send out, we can send you a seen report. For this to work you need to have an endpoint to forward the reports to. Please provide the endpoint’s URL to Customer Support and they will set it up for you. Once the setup is complete, we will be able to deliver the reports to you in real time. Alternatively you can specify the endpoint per each message via the notifyURL parameter. Contact support@infobip.com if you require help. Use one URL for all report types.

post
https://{yourDomain}/your/webhook/path
Request Body schema:
application/json
collapse all -
results
Array of objects

Collection of reports, one per every message.

Array
messageId
string

The ID of the sent message.

from
string

Number which sent the message.

to
string

Registered WhatsApp business number.

sentAt
string <date-time>

Tells when the message was sent.

seenAt
string <date-time>

Tells when the message was seen.

applicationId
string

Application id that the message is linked to.

entityId
string

Entity id that the message is linked to.

Responses

200

Your server returns this code if it accepts the callback

Request samples

Content type
application/json
Copy
Collapse all
{
  • "results":
    [
    • {
      • "messageId": "1215f543ab19-345f-adbd-12ad31451ed25f35",
      • "from": "385919998888",
      • "to": "41793026731",
      • "sentAt": "2018-12-12T11:21:57.793+0000",
      • "seenAt": "2018-12-12T11:21:58.251+0000",
      • "applicationId": "example-application-id",
      • "entityId": "example-entity-id"
      }
    ]
}

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.