View a markdown version of this page

Configurando a expiração da mensagem RCS - AWS SMS de mensagens para o usuário final
Como funciona a expiração da mensagemTimeToLive referência de parâmetrosExpiração e retornoValores de TTL recomendadosPráticas recomendadas

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á.

Configurando a expiração da mensagem RCS

Time-sensitive mensagens, como senhas de uso único (OTPs), anúncios de venda rápida e lembretes de compromissos, perdem valor se forem entregues após o término da janela relevante. Quando você inclui o TimeToLive parâmetro em uma SendRcsMessage solicitação, o AWS End User Messaging remove a mensagem se ela não tiver sido entregue dentro do número especificado de segundos. O destinatário nunca vê uma mensagem expirada.

Você pode combinar TimeToLive com o fallback por mensagem para que um fallback de SMS ou MMS seja enviado automaticamente quando a mensagem RCS expirar. Para obter detalhes sobre como configurar o fallback, consulte. Configurando o fallback de SMS ou MMS por mensagem

Como funciona a expiração da mensagem

A contagem regressiva do TTL começa quando o AWS End User Messaging aceita a SendRcsMessage solicitação. Os seguintes resultados são possíveis:

  • Entregue antes que o TTL expire: a mensagem chega ao destinatário e o AWS End User Messaging emite um evento de entrega. Para ter mais informações sobre eventos do , consulte Eventos de mensagem RCS.

  • O TTL expira antes da entrega (com fallback): se você definir um FallbackConfiguration na solicitação, o AWS End User Messaging enviará a mensagem alternativa SMS ou MMS para o destinatário. A mensagem RCS original é removida e o destinatário nunca a vê.

  • O TTL expira antes da entrega (sem retorno): a mensagem falha. AWSO End User Messaging remove a mensagem RCS e emite um evento de expiração de TTL. O destinatário nunca vê a mensagem.

TimeToLive referência de parâmetros

Você define a expiração da mensagem incluindo o TimeToLive parâmetro em sua SendRcsMessage solicitação.

TimeToLive detalhes do parâmetro
Propriedade Valor
Nome do parâmetro TimeToLive
Tipo Inteiro
Unidade Segundos
Valor mínimo 1
Valor máximo 172800 (48 horas)
Comportamento padrão do Se você omitirTimeToLive, o AWS End User Messaging não aplicará uma janela de expiração. A mensagem permanece pendente até que a entrega seja bem-sucedida ou a transportadora a remova.
Importante

TimeToLiveDefina para pelo menos 10 segundos. Valores abaixo de 10 aumentam o risco de a mensagem expirar antes que a transportadora possa tentar a entrega. Um valor de 0 ou um número negativo retorna ValidationException a.

Expiração e retorno

Quando você inclui ambos TimeToLive e FallbackConfiguration na mesma SendRcsMessage solicitação, o AWS End User Messaging usa a seguinte lógica:

  1. AWSAs mensagens do usuário final tentam a entrega do RCS.

  2. Se a mensagem não for entregue antes de decorridos TimeToLive alguns segundos, o AWS End User Messaging removerá a mensagem RCS pendente.

  3. AWSO End User Messaging envia a mensagem alternativa no canal que você especificou em FallbackConfiguration.Channel (SMSouMMS).

Se você definir TimeToLive sem aFallbackConfiguration, a mensagem falhará ao expirar e nenhum retorno será enviado. Monitore os eventos de expiração para detectar esses casos. Para obter mais informações, consulte Eventos de mensagem RCS.

Para obter detalhes completos da configuração alternativa, incluindo a FallbackConfiguration estrutura, consulteConfigurando o fallback de SMS ou MMS por mensagem.

Valores de TTL recomendados

Escolha um TimeToLive valor que corresponda à janela de relevância do conteúdo que você está enviando.

Valores de TTL recomendados por caso de uso
Caso de uso TTL recomendado Lógica
One-time senhas (OTPs) 30 a 120 segundos Os códigos OTP têm janelas de validade curtas. Entregar após o vencimento confunde os destinatários.
Alertas de fraude ou segurança 60 a 300 segundos Time-critical as notificações de segurança devem chegar rapidamente ou acionar um canal alternativo.
Lembretes de compromissos 3600 a 7200 segundos (1 a 2 horas) Útil somente antes da hora marcada.
Vendas instantâneas Combine a duração da venda Uma mensagem de pós-venda entregue cria uma experiência negativa para o cliente.
Promoções diárias 43200 a 86400 segundos (12 a 24 horas) Relevante somente para o dia atual.
Notificações de entrega 1800 a 3600 segundos (30 a 60 minutos) O status do pacote muda rapidamente; uma atualização obsoleta é enganosa.

Para conteúdo geral sem restrição de tempo específica, omita TimeToLive e permita que o AWS End User Messaging tente ser entregue indefinidamente.

Práticas recomendadas

  • Sempre configurado TimeToLive para conteúdo urgente, como OTPs, alertas de segurança e lembretes de compromissos.

  • Use pelo menos 10 segundos para dar tempo à transportadora para tentar a entrega.

  • Combine TimeToLive com um FallbackConfiguration para mensagens críticas. Isso garante que o destinatário receba o conteúdo em um canal alternativo se a janela de entrega do RCS fechar.

  • Monitore os eventos de expiração do TTL para rastrear as taxas de sucesso da entrega e ajustar seus valores de TTL ao longo do tempo. Para obter mais informações sobre os tipos de evento, consulte Eventos de mensagem RCS.

  • Para mensagens de mídia avançada (rich cards e carrosséis), considere um TTL mais longo para contabilizar o tempo de download da mídia. Para obter informações sobre mensagens avançadas, consulteEnviando mensagens ricas de RCS.