Message Event Webhooks

1. Sent Webhook

The Sent event confirms that Netcore has accepted the message and forwarded it to the channel provider. It does not guarantee delivery to the device. This event is used to:

Validate that your API request succeeded
Log outbound messages
Start delivery-tracking workflows

[
  {
    "callbackdata": "7890986",
    "channel": "RCS",
    "event_time": 1704876828,
    "last_channel": "",
    "message_id": "api-337-919999999999-3c9094b5cd72fdcaafbb633502afa672-1704876827",
    "mobile": "919999999999",
    "nc_bot_id": "682",
    "remarks": "",
    "requestid": "f95e99645268169422abc9cd0ae3a8b7",
    "status": "Sent",
    "tags": [
      "12"
    ],
    "type": "Template"
  }
]

2. Delivered Webhook

The Delivered event confirms that the message reached the user’s device. This event is used to:

Track delivery performance
Trigger follow-up automation when delivery is confirmed.

[
  {
    "callbackdata": "7890986",
    "channel": "RCS",
    "event_time": 1704876833,
    "last_channel": "",
    "message_id": "api-337-919999999999-3c9094b5cd72fdcaafbb633502afa672-1704876827",
    "mobile": "919999999999",
    "nc_bot_id": "682",
    "remarks": "",
    "requestid": "f95e99645268169422abc9cd0ae3a8b7",
    "status": "Delivered",
    "tags": ["12"],
    "type": "Template"
  }
]

3. Read Webhook

The Read event indicates the recipient opened the RCS message. Use this event to:

Measure message engagement
Trigger downstream actions

[
  {
    "callbackdata": "7890986",
    "channel": "RCS",
    "event_time": 1704877597,
    "last_channel": "",
    "message_id": "api-337-918989898989-4f3406fc8aede5feef7801bfb75cfb97-1704877442",
    "mobile": "918989898989",
    "nc_bot_id": "682",
    "remarks": "",
    "requestid": "643988d1aee3de27700f105e16b928bf",
    "status": "Read",
    "tags": ["12"],
    "type": "Template"
  }
]

4. Click Events

A Clicked event is triggered when a user taps any interactive suggestion in an RCS message.
The click_data object helps identify what the user interacted with.

//It is triggered when a user clicks a URL suggestion button.

[
   {
        "callbackdata": "7890986",
        "channel": "RCS",
        "click_data": {
            "postbackData": "Thank you for visit",
            "suggestionType": "url_action",
            "text": "Visit Now akash",
            "type": "ACTION"
        },
        "event_time": 1704877756,
        "last_channel": "",
        "message_id": "api-337-918989898989-417c614cf4ae2688c47c4098091f9d04-1704877390",
        "mobile": "918989898989",
        "nc_bot_id": "682",
        "remarks": "",
        "requestid": "54713f490c2e5d4f639f5192961fb2ce",
        "status": "Clicked",
        "tags": [
            "12"
        ],
        "type": "Template"
    }
]

// Triggered when a user taps the “call” suggestion.

[
  {
    "callbackdata": "7890986",
    "channel": "RCS",
    "click_data": {
      "postbackData": "Thank you for calling",
      "suggestionType": "dialer_action",
      "text": "Call Now",
      "type": "ACTION"
    },
    "event_time": 1704877907,
    "last_channel": "",
    "message_id": "api-337-918989898989-417c614cf4ae2688c47c4098091f9d04-1704877390",
    "mobile": "918989898989",
    "nc_bot_id": "682",
    "remarks": "",
    "requestid": "54713f490c2e5d4f639f5192961fb2ce",
    "status": "Clicked",
    "tags": [
      "12"
    ],
    "type": "Template"
  }
]

// Triggered when the user selects a predefined reply button.

[
  {
    "callbackdata": "7890986",
    "channel": "RCS",
    "click_data": {
      "postbackData": "Thank you for clicking",
      "suggestionType": "reply",
      "text": "Thank you",
      "type": "REPLY"
    },
    "event_time": 1704878040,
    "last_channel": "",
    "message_id": "api-337-918989898989-417c614cf4ae2688c47c4098091f9d04-1704877390",
    "mobile": "918989898989",
    "nc_bot_id": "682",
    "remarks": "",
    "requestid": "54713f490c2e5d4f639f5192961fb2ce",
    "status": "Clicked",
    "tags": [
      "12"
    ],
    "type": "Template"
  }
]

//Triggered when a user interacts with a calendar event suggestion.

[
  {
    "callbackdata": "",
    "channel": "RCS",
    "click_data": {
      "postbackData": "calender",
      "suggestionType": "calendar_event",
      "text": "Check calender",
      "type": "ACTION"
    },
    "event_time": 1764590898,
    "last_channel": "",
    "message_id": "virbm-77865-919999999999-de37c73b5-1764590848",
    "mobile": "919999999999",
    "nc_bot_id": "netcoresalesexpbot1",
    "remarks": "",
    "requestid": "1a9f8bbcb5e37548918aca80fee3336b",
    "status": "Clicked",
    "tags": [
      ""
    ],
    "type": "Template"
  }
]

// Triggered when a user taps a lat-long map location button.

[
  {
    "callbackdata": "",
    "channel": "RCS",
    "click_data": {
      "postbackData": "Location",
      "suggestionType": "view_location_latlong",
      "text": "VIew location lat/long",
      "type": "ACTION"
    },
    "event_time": 1764591795,
    "last_channel": "",
    "message_id": "virbm-77865-918983190458-ff1d0442a-1764591765",
    "mobile": "918983190458",
    "nc_bot_id": "netcoresalesexpbot1",
    "remarks": "",
    "requestid": "9fe16abbea9190cd1ce9bdf7150b3e5b",
    "status": "Clicked",
    "tags": [
      ""
    ],
    "type": "Template"
  }
]

// Triggered when the user clicks a location search query link.

[
  {
    "callbackdata": "",
    "channel": "RCS",
    "click_data": {
      "postbackData": "location",
      "suggestionType": "view_location_query",
      "text": "VIew location Query",
      "type": "ACTION"
    },
    "event_time": 1764592001,
    "last_channel": "",
    "message_id": "virbm-77865-918983190458-e5d26b5d0-1764591991",
    "mobile": "918983190458",
    "nc_bot_id": "netcoresalesexpbot1",
    "remarks": "",
    "requestid": "a2c1bc89be34f5bfa395728414ea7a7e",
    "status": "Clicked",
    "tags": [
      ""
    ],
    "type": "Template"
  }
]

// Triggered when the user taps the option to share their location.

[
  {
    "callbackdata": "",
    "channel": "RCS",
    "click_data": {
      "postbackData": "Location",
      "suggestionType": "share_location",
      "text": "Share location",
      "type": "ACTION"
    },
    "event_time": 1764592035,
    "last_channel": "",
    "message_id": "virbm-77865-918983190458-e5d26b5d0-1764591991",
    "mobile": "918983190458",
    "nc_bot_id": "netcoresalesexpbot1",
    "remarks": "",
    "requestid": "a2c1bc89be34f5bfa395728414ea7a7e",
    "status": "Clicked",
    "tags": [
      ""
    ],
    "type": "Template"
  }
]

5. Failed Webhook

The Failed event indicates the message could not be delivered due to provider or device issues. Use this event to:

Diagnose errors
Retry when applicable
Identify invalid or restricted numbers

[
  {
    "callbackdata": "7890986",
    "channel": "RCS",
    "event_time": 1704880344,
    "last_channel": "",
    "message_id": "api-337-918989898989-665675abd0b371c718eb66b27292746c-1704880344",
    "mobile": "918989898989",
    "nc_bot_id": "682",
    "remarks": "429 TOO_MANY_REQUESTS - You have reached the allowed traffic limit for this agent on the user, your message will not be delivered.",
    "requestid": "90608b68d90a4f2767f2b2a03e2fa663",
    "status": "Failed",
    "tags": [
      "12"
    ],
    "type": "Template"
  }
]

Common Failure Reasons (Remarks Field)

Insufficient custom params
Number is RCS disabled
429 Too Many Requests
TTL expiration
Agent suspended
Template not approved
URL invalid (RFC 3986)
Internal server error
User opted out

6. Not Sent Webhook

Triggered when the message could not be attempted due to pre-validation errors. Use this event to:

Detect non-reachable or unsupported numbers
Avoid unnecessary retries

[
  {
    "callbackdata": "7890986",
    "channel": "RCS",
    "event_time": 1704880362,
    "last_channel": "",
    "message_id": "api-337-918989898989-65e6ef48297d7c71df4bfd912b092c77-1704880362",
    "mobile": "918989898989",
    "nc_bot_id": "682",
    "remarks": "RCS not enabled numbers",
    "requestid": "ba8e2ef03e00524e629e10219676d3a4",
    "status": "Not Sent",
    "tags": [
      "TEST"
    ],
    "type": "Template"
  }
]

7. Batch Webhook

Batch operations may return mixed outcomes (Sent + Failed) for different recipients.

[
  {
    "callbackdata": "7890986",
    "channel": "RCS",
    "event_time": 1762494359,
    "last_channel": "",
    "message_id": "virbm-337-4b285fb81844-8cff3df6d-1762494359",
    "mobile": "919999999999",
    "nc_bot_id": "682",
    "remarks": "Template code with bot doesn't exist.",
    "requestid": "bc23705a4cc2e5e5275751b30ac5682b",
    "status": "Failed",
    "tags": [
      "12"
    ],
    "type": "Template"
  },
  {
    "callbackdata": "7890986",
    "channel": "RCS",
    "event_time": 1762494359,
    "last_channel": "",
    "message_id": "virbm-337-4b285fb81844-8cff3df6d-1762494359",
    "mobile": "919999999999",
    "nc_bot_id": "682",
    "remarks": "",
    "requestid": "bc23705a4cc2e5e5275751b30ac5682b",
    "status": "Sent",
    "tags": [
      "12"
    ],
    "type": "Template"
  }
]