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
},