全部产品

Chat App 消息服务：ChatAppInbound（消息上行）

更新时间：Apr 17, 2026

您可以通过轻量消息队列（原MNS）接收Chat App 消息服务的上行消息（ChatAppInbound）。

前提条件

您已经注册阿里云账号并生成访问密钥（AccessKey），详情请参见创建AccessKey。
您已仔细阅读回执消息简介与配置流程，了解回执消息模式、类型和配置流程。

说明

配置消息上行操作步骤参见：配置状态报告/消息上行。

消息体格式

名称	类型	是否必选	描述
MessageId	String	是	消息的ID。
CustSpaceId	String	是	通道ID。
WabaId	String	是	WhatsApp商业账户ID。
From	String	是	消息发送方号码。
To	String	是	消息接收方号码。
FromUserId	String	否	BSUID
FromParentUserId	String	否	父级 BSUID（如果有）
FromUserName	String	否	用户账号（如果有）
Timestamp	Long	是	时间戳为Unix timestamp 毫秒。
DisplayName	String	是	号码显示的名称。
Type	String	是	媒体资源类型。取值： TEXT LOCATION DOCUMENT VIDEO AUDIO REPLY IMAGE CONTACTS SYSTEM
Message	String	是	消息的内容。当Type为TEXT时，Message为消息内容。当Type为LOCATION时，Message请参见LOCATION字段说明。当Type为VIDEO时，Message请参见VIDEO字段说明。当Type为AUDIO时，Message请参见AUDIO字段说明。当Type为DOCUMENT时，Message请参见DOCUMENT字段说明。当Type为REPLY时，Message请参见REPLY字段说明。当Type为IMAGE时，Message请参见IMAGE字段说明。当Type为SYSTEM 时，Message请参见SYSTEM 字段。
Name	String	是	终端用户名称。

LOCATION字段

名称	类型	是否必选	描述
address	String	是	地址信息。
latitude	String	是	纬度。
longitude	String	是	经度。
name	String	是	LOCATION的描述。

VIDEO字段

名称	类型	是否必选	描述
name	String	是	VIDEO文件的描述。
id	String	是	VIDEO文件的ID。
mimeType	String	是	固定值：ogg。说明 codecs=opus时，可不关注该参数。
url	String	是	VIDEO的URL地址。说明 URL有效期为7天。

IMAGE字段

名称	类型	是否必选	描述
caption	String	否	图片的描述。
id	String	是	图片的ID。
mimeType	String	是	图片类型。
url	String	是	图片的URL地址。说明 URL有效期为7天。

AUDIO字段

名称	类型	是否可选	描述
name	String	是	AUDIO文件的描述。
id	String	是	AUDIO文件的ID。
mimeType	String	是	固定值：audio。说明 codecs=opus时，可不关注该参数。
url	String	是	AUDIO的URL地址。说明 URL有效期为7天。

DOCUMENT字段

名称	类型	是否可选	描述
name	String	是	DOCUMENT文件的描述。
id	String	是	DOCUMENT文件的ID。
filename	String	是	DOCUMENT的文件名。
mimeType	String	是	固定值：application/pdf。
url	String	是	DOCUMENT的URL地址。说明 URL有效期为7天。

REPLY字段

名称	类型	是否可选	描述
text	String	是	客户点击Button的名称。
payload	String	是	点击Button，返回在消息发送时下发的payload数值。

SYSTEM 字段

名称	类型	是否可选	描述
body	String	是	描述客户身份或电话号码变更。
wa_id	String	是	客户电话号码更新后新的 WhatsApp ID。
type	String	是	系统更新类型，可能是以下之一： customer_changed_number：客户更改了电话号码。 customer_identity_changed：客户更改了个人资料。