Todos los productos
Search
Centro de documentos

Chat App Message Service:ChatAppStatus

Última actualización: Sep 21, 2026

Reciba los acuses de recibo de entrega de mensajes MT (ChatAppStatus) mediante Simple Message Queue (anteriormente MNS).

Requisitos previos

Nota

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

Formato del cuerpo del mensaje

Parámetro

Tipo

Obligatorio

Descripción

MessageId

String

Sí

Identificador único del mensaje.

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 en milisegundos que indica cuándo se envió el mensaje.

Status

String

Sí

Estado de entrega del mensaje. Valores válidos:

  • Sent: mensaje enviado.

  • Delivered: mensaje entregado al dispositivo del destinatario.

  • Read: mensaje leído por el destinatario.

  • Failed: error en la entrega del mensaje.

  • Deleted: mensaje eliminado.

    Nota

    No disponible. WhatsApp no envía el estado Deleted a Chat App Message Service.

  • unsubscribe: el usuario bloqueó la cuenta comercial.

  • subscribe: el usuario desbloqueó la cuenta comercial.

    Nota

    Aplica únicamente a los canales de Viber.

StatusDescription

String

Sí

Descripción del estado.

ErrorCode

String

No

Código de error cuando falla la entrega.

ErrorDescription

String

No

Descripción del código de error. Para más detalles, consulte API error codes.

ConversationType

String

No

Tipo de conversación. Valores válidos:

  • service: conversación iniciada por el usuario.

  • utility: mensaje transaccional.

  • marketing: mensaje de marketing.

  • authentication: mensaje de autenticación.

ConversationId

String

No

Identificador único de la conversación.

ConversationExpirationTime (obsoleto)

Long

No

Hora de expiración de la conversación.

Nota

Obsoleto. No tiene efecto bajo el modelo de facturación por mensaje.

MsgFrameType

String

Sí

Tipo de mensaje. Valores válidos:

  • message: mensaje de formato libre. Solo se puede enviar dentro de las 24 horas posteriores al último mensaje del usuario.

  • template: plantilla de mensaje preaprobada desde la consola. Se puede enviar en cualquier momento.

Type

String

No

Tipo de medio del contenido del mensaje. Valores válidos:

  • image

  • video

  • document

  • audio

  • none: texto sin formato

TaskId

String

No

ID de tarea personalizado.

Nota

Toma el valor de MessageId si no se especifica TaskId .

OriginPhoneNumber

String

No

Número de teléfono original del remitente.

TemplateCode

String

No

Código de la plantilla de mensaje.

Nota

Disponible solo cuando MsgFrameType es template .