Read

The Read status confirms that a WhatsApp group message has been read by the group participants. This indicates that the message has been opened and viewed by the intended recipients.

Prerequisites

  1. An active WhatsApp for Business API plan on Kaleyra platform includes:
    1. A WhatsApp business number.
    2. An associated profile with the business number.
    3. A WhatsApp verified and approved profile.
    4. A WABA ID onboarded on Kaleyra WhatsApp API V2.
  2. You must have the callback registered in the WhatsApp channel for the phone numbers. Refer WhatsApp Configuration for Callback.

Sample Webhook

The following is the sample webhook.

{
  "status": "read",
  "message_id": "3ea73d3c-2e95-4db1-be1f-743XXXXafd1a",
  "meta_object": {
    "field": "messages",
    "value": {
      "messaging_product": "whatsapp",
      "metadata": {
        "display_phone_number": "91XXXXXXXXXX",
        "phone_number_id": "2865XXXX5905271"
      },
      "statuses": [
        {
          "conversation": {
            "id": "7f70fcc1b8b50e5XXXXX0395d037e445",
            "origin": {
              "type": "group_marketing"
            }
          },
          "id": "wamid.HBgSMTIwMzYzNDIyOTQ0MTU5OTMwFQgAERgSMjlERUQzMzFXXXXXEODJDQzIzM==",
          "pricing": {
            "billable": true,
            "category": "group_marketing",
            "pricing_model": "PMP",
            "type": "regular"
          },
          "recipient_id": "Y2FwaV9ncm91cDo5MTc5NjE3MzI4MDY6MTIwMzXXXXXYzTQ0MTU5OTMw",
          "recipient_participant_id": "91XXXXXXXXXX",
          "recipient_type": "group",
          "status": "read",
          "timestamp": "1771841482"
        }
      ]
    }
  },
  "extra_info": {
    "enable_url_tracking_body": false,
    "enable_url_tracking_button": false,
    "message_id": "3ea73d3c-2e95-4db1-be1f-74XXXXX3fd1a",
    "ref": "customer1",
    "ref1": "marketing",
    "ref2": "dictionary",
    "trace_id": "9ff7c960-e0ea-4e30-b4a0-1f5XXXXX8729",
    "waba_id": "29XXXXXXXX54406"
  }
}

Did this page help you?



© 2026 Kaleyra Inc. All rights reserved.
Trademarks, logos and service marks displayed on this site are registered and unregistered trademarks of Kaleyra Inc.