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 o fallback de SMS ou MMS por mensagem

Quando você envia uma mensagem RCS, o dispositivo do destinatário pode não suportar RCS ou a mensagem pode expirar antes da entrega. Com o fallback por mensagem, você pode especificar conteúdo alternativo de SMS ou MMS que o AWS End User Messaging entrega automaticamente quando a mensagem RCS não consegue chegar ao destinatário. Você configura o fallback em cada SendRcsMessage solicitação incluindo o FallbackConfiguration parâmetro.

Quando o fallback é acionado

AWSO End User Messaging aciona a mensagem alternativa em duas situações:

Se você não incluir FallbackConfiguration na solicitação e a mensagem RCS falhar ou expirar, nenhuma mensagem alternativa será enviada.

Per-message fallback comparado ao fallback baseado em pool

Per-message o fallback on SendRcsMessage difere do fallback automático baseado em pool disponível com. SendTextMessage Para obter detalhes sobre o fallback baseado em pool, consulte. Fallback de RCS para SMS usando pools telefônicos

FallbackConfiguration estrutura

O FallbackConfiguration parâmetro é um único objeto na SendRcsMessage solicitação. Você define o Channel campo para indicar se o fallback é SMS ou MMS e, em seguida, fornece os campos de conteúdo correspondentes.

O JSON a seguir mostra a estrutura de um FallbackConfiguration objeto para um substituto de SMS:

{
    "Channel": "SMS",
    "MessageBody": "Your order has shipped. Track at https://example.com/track/12345",
    "OriginationIdentity": "+18005550199"
}

O JSON a seguir mostra a estrutura de um fallback de MMS:

{
    "Channel": "MMS",
    "MessageBody": "Your order has shipped.",
    "MediaUrls": ["https://cdn.example.com/shipping-confirmation.jpg"],
    "OriginationIdentity": "+18005550199"
}

Configurando o fallback de SMS

Para voltar ao SMS, Channel defina SMS e forneça umMessageBody. Como o SMS não suporta chips de sugestão ou rich cards, inclua quaisquer URLs importantes como texto simples no corpo da mensagem.

Configurando o fallback do MMS

Para voltar ao MMS, Channel defina MMS e forneça um ou mais URLs de mídia. MediaUrls Use o MMS fallback quando sua mensagem RCS contiver conteúdo visual (como um rich card com uma imagem) e você quiser preservar a experiência visual para destinatários que não oferecem suporte ao RCS.

Combinando o fallback com a expiração da mensagem

Quando você define ambas TimeToLive e FallbackConfiguration em uma solicitação, o AWS End User Messaging tenta a entrega do RCS durante o TTL. Se a mensagem não for entregue antes que o cronômetro expire, o serviço enviará a mensagem alternativa. Esse padrão é útil para conteúdo urgente, como senhas de uso único ou lembretes de compromissos.

Para obter mais informações sobre como configurar a expiração de mensagens, consulteConfigurando a expiração da mensagem RCS.

O exemplo a seguir define um TTL de 60 segundos com retorno de SMS:

{
    "DestinationPhoneNumber": "+12065550100",
    "OriginationIdentity": "rcs-agent-1234567890",
    "RcsMessageContent": "{\"Content\":{\"TextMessage\":{\"Body\":\"Your verification code is 483291.\"}}}",
    "TimeToLive": 60,
    "FallbackConfiguration": {
        "Channel": "SMS",
        "MessageBody": "Your verification code is 483291.",
        "OriginationIdentity": "+18005550199"
    }
}

Práticas recomendadas

Recursos relacionados