INCS 消息回调

回调说明

• INCS 定义的消息格式
• 使用INCS工作台接收和回复消息时，可以设置该回调

回调请求方式

• POST

回调内容

• 回调分为 消息创建 和 消息状态更新 回调

1. 消息创建（message_created）

参数说明

参数名	类型	必传	描述
event	string	是	此处为 "message_created"，发送和接收消息时触发该回调
message	object	是	INCS 定义的消息格式

message 结构说明

参数名	类型	必传	描述
id	bigint	是	INCS 消息id
auth_id	int	是	INCS 消息通道id
conversation_id	int	是	INCS 会话id
session_type	int	是	INCS 会话类型：1单聊，2群聊
send_id	string	是	INCS 发信人id
recv_id	string	是	INCS 收信人id
type	int	是	INCS 定义的消息类型，见下述
custom_type	int	是	INCS 定义的自定义消息类型，type为110时有值
custom_id	bigint	是	INCS 定义的自定义消息关联id
channel_msg_id	string	是	消息通道回传的id
channel_status	int	是	发出去的消息状态：1 sent, 2 failed, 3 delivered, 4 read
content	string	是	信息体json
error	string	是	错误信息
source	int	是	消息发送方式：0 INCS，1 API
created_at	datetime string	是	消息创建时间，ISO 8601 格式
updated_at	datetime string	是	消息更新时间，ISO 8601 格式

消息类型（type）

枚举值	描述
101	文本消息
101	文本消息
101	文本消息

message 内容示例

1. Text Message

{
    "event": "message_created",
    "message": {
        "id": 260400000076,
        "auth_id": 30058,
        "conversation_id": 979,
        "session_type": 1,
        "send_id": "30058_6281519140327",
        "recv_id": "staff_1001",
        "type": 101,
        "custom_type": 0,
        "custom_id": 0,
        "channel_msg_id": "wamid.HBgNNjI4MTUxOTE0MDMyNxUCABIYIEFDQTgwMEZCMUFERjZDQzhDNUVDQzM0Qzg2Qjg0QkI0AA==",
        "channel_status": 0,
        "content": {
            "content": "Hi"
        },
        "error": "",
        "source": 0,
        "created_at": "2026-04-07T12:02:55.000000Z",
        "updated_at": "2026-04-07T12:02:55.000000Z"
    }
}

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?",
        "trackdata": {
            "suggestionType": "reply",
            "msgType": "richcard",
            "cardIndex": 0,
            "suggestionIndex": 1,
            "msgId": "019cc232-229a-7353-b860-87709fa4d7d4",
            "msgDate": "2026-03-06T08:09:51.895Z",
            "template": "2217703609111640005"
        },
        "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",
        "trackdata": {
            "suggestionType": "url_action",
            "msgType": "richcard",
            "cardIndex": 0,
            "suggestionIndex": 0,
            "msgId": "019cc232-229a-7353-b860-87709fa4d7d4",
            "msgDate": "2026-03-06T08:09:51.895Z",
            "template": "2217703609111640005"
        },
        "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
    }
}