Document Center

All Products

Document Center

Chat App Message Service:ChatAppInbound

Last Updated:Jun 03, 2026

Receive mobile-originated (MO) messages via Simple Message Queue (formerly MNS).

Prerequisites

You have an Alibaba Cloud account and an AccessKey pair. For more information, see Create an AccessKey.
You have reviewed the overview and configuration of message receipts and understand their modes, types, and configuration process. Then, configure the message receipts accordingly.

Note

For the procedure of configuring MO messages, see Configure message receipts.

Message body format

Parameter	Type	Required	Description
MessageId	String	Yes	Unique message identifier.
CustSpaceId	String	Yes	The channel ID.
WabaId	String	Yes	The ID of the WhatsApp Business Account (WABA).
From	String	Yes	The sender's phone number.
To	String	Yes	The recipient's phone number.
FromUserId	String	No	BSUID
FromParentUserId	String	No	Parent BSUID (if any)
FromUserName	String	No	User account (if any)
Timestamp	Long	Yes	Unix timestamp of the message, in milliseconds.
DisplayName	String	Yes	The sender's display name.
Type	String	Yes	Message type. Valid values: `TEXT` `LOCATION` `DOCUMENT` `VIDEO` `AUDIO` `REPLY` `IMAGE` `CONTACTS` `SYSTEM`
Message	Object	Yes	Message content. If Type is TEXT, this field contains the message content. If Type is LOCATION, see LOCATION object. If Type is VIDEO, see VIDEO object. If Type is AUDIO, see AUDIO object. If Type is DOCUMENT, see DOCUMENT object. If Type is REPLY, see REPLY object. If Type is IMAGE, IMAGE object. If Type is SYSTEM, see SYSTEM object.
Name	String	Yes	User name.

LOCATION object

Parameter	Type	Required	Description
address	String	Yes	Address information.
latitude	String	Yes	The latitude.
longitude	String	Yes	The longitude.
name	String	Yes	Location description.

VIDEO object

Parameter	Type	Required	Description
name	String	Yes	Video file description.
id	String	Yes	The ID of the video file.
mimeType	String	Yes	Fixed value: `ogg` . Note This parameter can be ignored if `codecs=opus`.
url	String	Yes	The URL of the video file. Note The URL is valid for 7 days.

IMAGE object

Parameter	Type	Required	Description
caption	String	No	Image description.
id	String	Yes	The ID of the image.
mimeType	String	Yes	The MIME type of the image.
url	String	Yes	The URL of the image. Note The URL is valid for 7 days.

AUDIO object

Parameter	Type	Required	Description
name	String	Yes	Audio file description.
id	String	Yes	The ID of the audio file.
mimeType	String	Yes	Fixed value: `audio` . Note This parameter can be ignored if `codecs=opus`.
url	String	Yes	The URL of the audio file. Note The URL is valid for 7 days.

DOCUMENT object

Parameter	Type	Required	Description
name	String	Yes	Document description.
id	String	Yes	The ID of the document.
filename	String	Yes	Document file name.
mimeType	String	Yes	Fixed value: `application/pdf` .
url	String	Yes	The URL of the document. Note The URL is valid for 7 days.

REPLY object

Parameter	Type	Required	Description
text	String	Yes	Text label of the clicked button.
payload	String	Yes	Payload returned when the user clicks the button. Matches the payload defined in the sent message.

SYSTEM object

Parameter	Type	Required	Description
body	String	Yes	A change to the user's identity or phone number.
wa_id	String	Yes	The user's new WhatsApp ID after a phone number change.
type	String	Yes	System update type. Valid values: `customer_changed_number` : The user changed their phone number. `customer_identity_changed` : The user changed their profile.