Todos os produtos
Search
Central de documentação

Chat App Message Service:ChatAppStatus

Última atualização: Oct 28, 2026

Receba os comprovantes de entrega de mensagens MT (ChatAppStatus) por meio do Simple Message Queue (anteriormente MNS).

Pré-requisitos

Nota

Para configurar mensagens MO, consulte Message receipts and configuration.

Formato do corpo da mensagem

Parâmetro

Tipo

Obrigatório

Descrição

MessageId

String

Sim

Identificador exclusivo da mensagem.

From

String

Sim

Número de telefone do remetente.

To

String

Sim

Número de telefone do destinatário.

UserId

String

Não

BSUID

ParentUserId

String

Não

BSUID pai (se houver)

UserName

String

Não

Conta de usuário (se houver)

Timestamp

Long

Sim

Timestamp Unix do envio da mensagem, em milissegundos.

Status

String

Sim

Status de entrega da mensagem. Valores válidos:

  • Sent: Mensagem enviada.

  • Delivered: Mensagem entregue ao dispositivo do destinatário.

  • Read: Mensagem lida pelo destinatário.

  • Failed: Falha na entrega da mensagem.

  • Deleted: Mensagem excluída.

    Nota

    Indisponível. O WhatsApp não envia o status Deleted ao Chat App Message Service.

  • unsubscribe: O usuário bloqueou a conta empresarial.

  • subscribe: O usuário desbloqueou a conta empresarial.

    Nota

    Aplica-se apenas aos canais do Viber.

StatusDescription

String

Sim

Descrição do status.

ErrorCode

String

Não

Código de erro para falha na entrega.

ErrorDescription

String

Não

Descrição do código de erro. Para mais detalhes, consulte API error codes.

ConversationType

String

Não

Tipo de conversa. Valores válidos:

  • service: Conversa iniciada pelo usuário.

  • utility: Mensagem transacional.

  • marketing: Mensagem de marketing.

  • authentication: Mensagem de autenticação.

ConversationId

String

Não

Identificador exclusivo da conversa.

ConversationExpirationTime (deprecated)

Long

Não

Tempo de expiração da conversa.

Nota

Obsoleto. Não tem efeito no modelo de faturamento por mensagem.

MsgFrameType

String

Sim

Tipo de mensagem. Valores válidos:

  • message: Mensagem de formato livre. Pode ser enviada apenas em até 24 horas após a última mensagem do usuário.

  • template: Modelo de mensagem pré-aprovado no console. Pode ser enviado a qualquer momento.

Type

String

Não

Tipo de mídia do conteúdo da mensagem. Valores válidos:

  • image

  • video

  • document

  • audio

  • none: Texto simples

TaskId

String

Não

ID de tarefa personalizado.

Nota

O padrão é MessageId se TaskId não for especificado.

OriginPhoneNumber

String

Não

Número de telefone do remetente original.

TemplateCode

String

Não

Código do modelo de mensagem.

Nota

Disponível apenas quando MsgFrameType é template .