Usar atributo de mensagem Time to Live (TTL) do Amazon SNS para notificações por push para dispositivos móveis - Amazon Simple Notification Service

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Usar atributo de mensagem Time to Live (TTL) do Amazon SNS para notificações por push para dispositivos móveis

O Amazon Simple Notification Service (Amazon SNS) oferece suporte para configurar um atributo de mensagem Time to Live (TTL) para mensagens de notificação por push para dispositivos móveis. Isso se soma à capacidade existente de definir TTL no corpo da mensagem do Amazon SNS para os serviços móveis de notificação push que oferecem suporte a isso, como Amazon Device Messaging (ADM) e Firebase Cloud Messaging (FCM) ao enviar para Android.

O atributo de mensagem do TTL é usado para especificar os metadados de expiração sobre uma mensagem. Isso permite que você especifique a quantidade de tempo que o serviço de notificações por push, como o Apple Push Notification Service (APNs) ou o FCM, tem para entregar a mensagem ao endpoint. Se por algum motivo (por exemplo, se o dispositivo móvel foi desativado) a mensagem não for entregue no material do TTL especificado, ela será descartada e não serão feitas mais tentativas de entrega. Para especificar o TTL nos atributos da mensagem, você pode usar os AWS Management Console kits de desenvolvimento de AWS software (SDKs) ou a API de consulta.

Atributos da mensagem do TTL para serviços de notificação por push

Veja a seguir uma lista dos atributos de mensagem TTL para serviços de notificação push que você pode usar para definir ao usar os AWS SDKs ou a API de consulta:

Serviço de notificação por push Atributo de mensagem do TTL
Amazon Device Messaging (ADM) AWS.SNS.MOBILE.ADM.TTL
Apple Push Notification Service (APNs) AWS.SNS.MOBILE.APNS.TTL
Apple Push Notification Service Sandbox (APNs_SANDBOX) AWS.SNS.MOBILE.APNS_SANDBOX.TTL
Baidu Cloud Push (Baidu) AWS.SNS.MOBILE.BAIDU.TTL
Firebase Cloud Messaging (FCM ao enviar para Android) AWS.SNS.MOBILE.FCM.TTL
Windows Push Notification Services (WNS) AWS.SNS.MOBILE.WNS.TTL

Cada um dos serviços de notificação por push processa o TTL de maneira diferente. Com o Amazon SNS você tem uma visão abstrata do TTL em todos os serviços de notificação por push, o que facilita especificar o TTL. Ao usar o AWS Management Console para especificar o TTL (em segundos), você só precisa inserir o valor do TTL uma vez e o Amazon SNS calculará o TTL para cada um dos serviços de notificação push selecionados ao publicar a mensagem.

O TTL é relativo ao momento da publicação. Antes de enviar uma mensagem de notificação por push para um serviço de notificações por push específico, o Amazon SNS calcula o tempo de permanência (o tempo entre o carimbo de data e hora da publicação e antes do envio para um serviço de notificações por push) para as notificações por push e passa o TTL restante para o serviço de notificações por push específico. Se o TTL for menor do que o tempo de permanência, o Amazon SNS não tentará publicar.

Se você especificar um TTL para uma mensagem de notificação por push, o valor do TTL deverá ser um número inteiro positivo, a menos que o valor de 0 tenha um significado específico para o serviço de notificação por push, como com APNs e FCM (ao enviar para Android). Se o valor do TTL for definido como 0 e o serviço de notificação por push não tiver um significado específico para 0, o Amazon SNS descartará a mensagem. Para obter mais informações sobre o parâmetro TTL definido como 0 ao usar o APNs, consulte Table A-3 Item identifiers for remote notifications (Tabela A-3 Identificadores de itens para notificações remotas”) na documentação da API Binary Provider.

Ordem de precedência para determinar o TTL

A precedência que o Amazon SNS usa para determinar o TTL para uma mensagem de notificação por push é baseada na seguinte ordem, em que o número mais baixo tem prioridade mais alta:

  1. TTL do atributo de mensagem

  2. TTL do corpo da mensagem

  3. TTL do serviço de notificação por push padrão (varia por serviço)

  4. TTL padrão do Amazon SNS (4 semanas)

Se você definir valores diferentes de TTL (um em atributos de mensagem e outro no corpo da mensagem) para a mesma mensagem, o Amazon SNS modificará o TTL no corpo da mensagem de acordo com o TTL especificado no atributo de mensagem.

Especificando TTL usando o AWS Management Console

  1. Faça login no console do Amazon SNS.

  2. No painel de navegação, escolha Mobile (Dispositivos móveis), Push notifications (Notificações por push).

  3. Na página Mobile push notifications (Notificações por push para dispositivos móveis), na seção Platform applications (Aplicativos de plataforma), selecione um aplicativo.

  4. Na MyApplicationpágina, na seção Endpoints, escolha um endpoint do aplicativo e escolha Publicar mensagem.

  5. Na seção Message details Detalhes da mensagem), insira o TTL (o número de segundos que o serviço de notificação por push tem para entregar a mensagem ao endpoint).

  6. Selecione Publish message (Publicar mensagem).