What are message receipts, how to configure message receipt modes - Chat App Message Service: Central de Documentação do Alibaba Cloud

Após enviar mensagens usando a API do Chat App Message Service, use o modo de consumo do Simple Message Queue (anteriormente MNS) (SMQ) ou o modo de envio em lote por HTTP para receber atualizações de status de entrega de mensagens e respostas de usuários.

Observações de uso

Problemas de rede, como conectividade ruim ou tempos limite de resposta, podem causar recibos de mensagem duplicados ou impedir sua recuperação.

Modos de recibo de mensagem

Você pode receber recibos de mensagem em dois modos: modo de consumo do SMQ e modo de envio em lote por HTTP. Escolha o modo que melhor atenda às suas necessidades.

Importante

Os recibos de mensagem não garantem idempotência. Você é o responsável por lidar com possíveis duplicatas para garantir a integridade e a consistência dos dados. Recomendamos desenvolver uma lógica de processamento de recibos idempotente.

Modo de consumo do SMQ

No modo de consumo do SMQ, você utiliza uma fila do SMQ para receber recibos de mensagem de uma região específica. Todas as mensagens corporativas podem ser enviadas por meio do SMQ. Ao ativar o SMQ e assinar um tipo de mensagem específico (MessageType) no console do Chat App Message Service, o sistema cria automaticamente uma fila de mensagens dedicado e gera um nome para ela (QueueName). Em seguida, use esse QueueName e o MessageType para chamar o SDK a partir do seu backend e recuperar os recibos da fila.
Modo de envio em lote por HTTP

No modo de envio em lote por HTTP, o sistema envia dados para uma URL especificada por meio de requisições HTTP POST. Depois de configurar uma URL de callback (callback_url) no console do Chat App Message Service, o sistema envia automaticamente os recibos de mensagem, como mensagens MO e relatórios de status, para essa URL.

Tipos de recibo de mensagem

Ao selecionar um modo de recibo, assine os tipos de mensagem correspondentes aos eventos que deseja monitorar. Os tipos de mensagem disponíveis são:

Tipo	Descrição	Modo de consumo do SMQ	Modo de envio em lote por HTTP
ChatAppInbound (mensagem MO)	Recupera mensagens enviadas por usuários finais para o seu número corporativo.	ChatAppInbound	ChatAppInbound
ChatAppStatus (relatório de status de mensagem MT)	Monitora o status de entrega das mensagens enviadas para usuários finais (mensagens MT).	ChatAppStatus	ChatAppStatus
ChatAppAudit (status de revisão de modelo)	Recebe notificações sobre o status de revisão de modelos criados com a API CreateChatappTemplate.	ChatAppAudit	ChatAppAudit

Configurar modos de recibo de mensagem

Configurar relatórios de status e mensagens MO

Para receber recibos de mensagem, primeiro ative-os no console do Chat App Message Service.

Faça login no console do Chat App Message Service.
No painel de navegação à esquerda, escolha Instant Message > WhatsApp e selecione um Sending Account Name.
Na página Data Panel do canal, acesse as configurações de webhook de acordo com o tipo de canal:
1. Para canais do WhatsApp, clique em WABA Management > Configure Webhook.
2. No caso de canais do Viber, clique em Service Number Management > Webhook Settings.
3. Em canais do Messenger, clique em Facebook Homepage > Configure Webhook.
4. Nos canais do Instagram, clique em Professional Account > Configure Webhook.

Configure suas assinaturas de mensagens.
1. Após conectar sua página, conta ou número de serviço, clique em Configure Webhook e selecione os tipos de mensagem que deseja assinar.
  
  Nota
  URL de callback de relatório de status: corresponde a ChatAppStatus (relatório de status de mensagem MT).
  
  URL de callback de mensagem MO: corresponde a ChatAppInbound (mensagem MO).
  
  A caixa de diálogo também contém as opções HTTP Protocol e Message Queue Monitoring, além dos campos Message Receipt Queue e MO Message Queue. Ao concluir a configuração, clique em OK.
Ative o HTTP Protocol e insira as URLs de callback para os relatórios de status e as mensagens MO.

Nota
Melhor prática: use caminhos de URL distintos no seu servidor (por exemplo, https://xxxx.com) para cada tipo de mensagem, a fim de simplificar a diferenciação. Não recomendado: evite direcionar todos os tipos de mensagem para uma única URL e analisar o corpo da requisição posteriormente para identificar o tipo.
1. No campo Status Report Callback URL, insira uma URL, como https://xxxx.com/appstatus.
2. No campo MO Message Callback URL, insira uma URL, como https://xxxx.com/inbound.
Ative o Message Queue Monitoring e clique em OK.
Clique em Configure Webhook novamente. Na caixa de diálogo exibida, copie os nomes da Message Receipt Queue e da MO Message Queue.

Configurar mensagens de status de revisão de modelo

Nota

Atualmente, apenas os canais do WhatsApp oferecem suporte a este recurso.

Faça login no console do Chat App Message Service.
No painel de navegação à esquerda, escolha Instant Message > WhatsApp e selecione um Sending Account Name.
Na página Data Panel do canal, no painel de navegação à esquerda, clique em WABA Management > Channel Webhook Settings.
Ative o HTTP Protocol e insira a URL de callback de notificação.
1. No campo Notification Callback URL, insira uma URL. Por exemplo: https://xxxx.com/appaudit
2. Ative o Message Queue Monitoring e clique em OK.
Ao ativar o Message Queue Monitoring na caixa de diálogo Channel Webhook Settings, o campo Notification Queue é exibido, permitindo que você copie o nome da fila. Se necessário, selecione também uma API version.
Clique em Channel Webhook Settings novamente. Na caixa de diálogo exibida, copie o nome da Notification Queue.

Baixe o SDK do SMQ

Baixe o SDK Java do SMQ para buscar mensagens da sua fila do SMQ.

Baixe o SDK: SMQ Java SDK