Webhook

• New Message Webhook (RCS)
• Message Status Webhook

New Message Webhook (RCS)

Webhook Request Method

• POST

Webhook Payload

Parameter	Type	Description
event	string	This is set to "new_message".
message	object	Message data.

Webhook Sample

{
    "event": "new_message",
    "business_phone": "",
    "message": {
        "senderPhoneNumber": "+6281519140000",
        "messageId": "da220bf7-e15b-4b2b-90af-1860eb335872",
        "sendTime": "2026-02-02T08:11:41.193204Z",
        "agentId": "infinity_links_indo_test_promo_tqzwtuox_agent@rbm.goog",
        "suggestionResponse": {
            "postbackData": "shop_url",
            "text": "Buy Now at INCS",
            "type": "ACTION"
        }
    }
}

Message data Samples

1. Text Message

{
    "senderPhoneNumber": "+628XXXXXXXXX",
    "messageId": "5312df2b-54e3-457d-8654-49a4f3ba1a19",
    "sendTime": "2024-04-20T10:11:02.589915Z",
    "text": "Hiii",
    "agentId": "test_vhbgamhn_agent@rbm.goog"
}

2. File Message

{
    "senderPhoneNumber": "+628XXXXXXXXX",
    "messageId": "5312df2b-54e3-457d-8654-49a4f3ba1a19",
    "sendTime": "2024-04-20T10:58:29.951141Z",
    "userFile": {
        "thumbnail": {
            "mimeType": "image/jpeg",
            "fileSizeBytes": 8001,
            "fileUri": "https://rcs-user-content-ap.storage.googleapis.com/baf60d40-f197-497f-83f8-5a52fd081262/54b9a1aae33ff62d14ea58db59f43ff04cf62d2329041b110b724b7447a7"
        },
        "payload": {
            "mimeType": "image/jpeg",
            "fileSizeBytes": 144594,
            "fileName": "1000002217.jpg",
            "fileUri": "https://rcs-user-content-ap.storage.googleapis.com/f7cdd990-83ea-4b8d-ba89-73eacf8d7d8a/d63d8f295248fc67cc1716658c169bba70f98b0513798c3c60f56f52734f"
        }
    },
    "agentId": "test_vhbgamhn_agent@rbm.goog"
}

3. Response to suggestion – REPLY

{
    "senderPhoneNumber": "+628XXXXXXXXX",
    "messageId": "5312df2b-54e3-457d-8654-49a4f3ba1a19",
    "sendTime": "2024-04-05T13:15:40.152413Z",
    "agentId": "test_vhbgamhn_agent@rbm.goog",
    "suggestionResponse": {
        "postbackData": "user_reply_what_is_rcs",
        "text": "what is RCS?",
        "type": "REPLY"
    }
}

4. Response to suggestion – ACTION

{
    "senderPhoneNumber": "+628XXXXXXXXX",
    "messageId": "5312df2b-54e3-457d-8654-49a4f3ba1a19",
    "sendTime": "2024-04-05T13:16:42.183829Z",
    "agentId": "test_vhbgamhn_agent@rbm.goog",
    "suggestionResponse": {
        "postbackData": "user_action_open_url",
        "text": "visit our website",
        "type": "ACTION"
    }
}

5. Location message

{
    "senderPhoneNumber": "+62XXXXXXXXXX",
    "messageId": "b0d0ea18-c809-4206-9ca2-5baf02707fe0",
    "sendTime": "2025-07-29T06:08:36.741050Z",
    "agentId": "test_dev_vhbgamhn_agent@rbm.goog",
    "location": {
        "longitude": 78.3861501,
        "latitude": 17.4370557
    }
}

Message Status Webhook

Webhook Request Method

• POST

Webhook Payload

Parameter	type	Mandatory	Description
event	string	Yes	This is set to "message_status_update"
business_phone	string	No	Business phone number
message_id	string	Yes	Message ID
message_status	string	Yes	Message status, one of "sent", "failed", "delivered", "read"
error	object|null	Yes	Error details，default is set to null.
error.title	string	No	Service provider-defined error title.
error.code	int	No	Service provider-defined error code.
received_at	timestamp	Yes	Webhook received timestamp.

Webhook Sample

{
  "event": "message_status_update",
  "business_phone": "6281519236680",
  "message_id": "wamid.HBgNNjI4OTY1MjQ1NjU0OBUCABEYEkYxNTY4NkNBRUY...",
  "message_status": "failed",
  "error": {
    "code": 131049,
    "title": "This message was not delivered to maintain healthy ecosystem engagement."
  },
  "received_at": 1754466101
},