Centro de documentos

Todos los productos

Centro de documentos

Chat App Message Service:ChatAppInbound

Última actualización: Oct 12, 2026

Reciba mensajes originados en dispositivos móviles (MO) mediante Simple Message Queue (anteriormente MNS).

Requisitos previos

Debe contar con una cuenta de Alibaba Cloud y un par de AccessKey. Para obtener más información, consulte Create an AccessKey.
Revise la descripción general and configuración of message receipts para comprender sus modos, tipos y proceso de configuración. Después, configure los acuses de recibo de los mensajes según corresponda.

Nota

Para conocer el procedimiento de configuración de mensajes MO, consulte Message receipts and configuración.

Formato del cuerpo del mensaje

Parámetro	Tipo	Obligatorio	Descripción
MessageId	String	Sí	Identificador único del mensaje.
CustSpaceId	String	Sí	Identificador del canal.
WabaId	String	Sí	Identificador de la cuenta de WhatsApp Business (WABA).
From	String	Sí	Número de teléfono del remitente.
To	String	Sí	Número de teléfono del destinatario.
FromUserId	String	No	BSUID
FromParentUserId	String	No	BSUID principal, si existe.
FromUserName	String	No	Cuenta de usuario, si existe.
Timestamp	Long	Sí	Marca de tiempo Unix del mensaje, en milisegundos.
DisplayName	String	Sí	Nombre para mostrar del remitente.
Type	String	Sí	Tipo de mensaje. Valores válidos: `TEXT` `LOCATION` `DOCUMENT` `VIDEO` `AUDIO` `REPLY` `IMAGE` `CONTACTS` `SYSTEM` `STICKER` `REVOKE`
Message	Object	Sí	Contenido del mensaje. Si Type es TEXT, este campo contiene el contenido del mensaje. Si Type es LOCATION, consulte LOCATION object. Si Type es VIDEO, consulte VIDEO object. Si Type es AUDIO, consulte AUDIO object. Si Type es DOCUMENT, consulte DOCUMENT object. Si Type es REPLY, consulte REPLY object. Si Type es IMAGE, consulte IMAGE object. Si Type es SYSTEM, consulte SYSTEM object. Si Type es STICKER, consulte STICKER object. Si Type es REVOKE, consulte REVOKE object.
Name	String	Sí	Nombre de usuario.

Objeto LOCATION

Parámetro	Tipo	Obligatorio	Descripción
address	String	Sí	Información de la dirección.
latitude	String	Sí	Latitud.
longitude	String	Sí	Longitud.
name	String	Sí	Descripción de la ubicación.

Objeto VIDEO

Parámetro	Tipo	Obligatorio	Descripción
name	String	Sí	Descripción del archivo de video.
id	String	Sí	Identificador del archivo de video.
mimeType	String	Sí	Valor fijo: `ogg` . Nota Puede omitir este parámetro si `codecs=opus`.
url	String	Sí	URL del archivo de video. Nota La URL tiene una validez de 7 días.

Objeto IMAGE

Parámetro	Tipo	Obligatorio	Descripción
caption	String	No	Descripción de la imagen.
id	String	Sí	Identificador de la imagen.
mimeType	String	Sí	Tipo MIME de la imagen.
url	String	Sí	URL de la imagen. Nota La URL tiene una validez de 7 días.

Objeto AUDIO

Parámetro	Tipo	Obligatorio	Descripción
name	String	Sí	Descripción del archivo de audio.
id	String	Sí	Identificador del archivo de audio.
mimeType	String	Sí	Valor fijo: `audio` . Nota Puede omitir este parámetro si `codecs=opus`.
url	String	Sí	URL del archivo de audio. Nota La URL tiene una validez de 7 días.

Objeto DOCUMENT

Parámetro	Tipo	Obligatorio	Descripción
name	String	Sí	Descripción del documento.
id	String	Sí	Identificador del documento.
filename	String	Sí	Nombre del archivo del documento.
mimeType	String	Sí	Valor fijo: `application/pdf` .
url	String	Sí	URL del documento. Nota La URL tiene una validez de 7 días.

Objeto REPLY

Parámetro	Tipo	Obligatorio	Descripción
text	String	Sí	Etiqueta de texto del botón en el que se hizo clic.
payload	String	Sí	Carga útil devuelta cuando el usuario hace clic en el botón. Coincide con la carga útil definida en el mensaje enviado.

Objeto SYSTEM

Parámetro	Tipo	Obligatorio	Descripción
body	String	Sí	Cambio en la identidad o el número de teléfono del usuario.
wa_id	String	Sí	Nuevo identificador de WhatsApp del usuario después de un cambio de número de teléfono.
type	String	Sí	Tipo de actualización del sistema. Valores válidos: `customer_changed_number` : El usuario cambió su número de teléfono. `customer_identity_changed` : El usuario modificó su perfil.

Objeto STICKER

Parámetro	Tipo	Obligatorio	Descripción
filename	String	Sí	Nombre del recurso multimedia.
animated	String	Sí	Indica si la calcomanía está animada (`true` significa animada, `false` significa no animada).
id	String	Sí	Identificador del recurso multimedia.
mimeType	String	Sí	Tipo MIME del recurso multimedia.
url	String	Sí	URL del recurso multimedia.

Objeto REVOKE

Parámetro	Tipo	Obligatorio	Descripción
revokeMessageId	String	Sí	Identificador del mensaje enviado previamente que se va a revocar o eliminar.