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:
+ **Falha imediata do RCS**: o dispositivo ou a operadora do destinatário não oferece suporte ao RCS ou o canal RCS rejeita a mensagem.
+ **Expiração de TTL**: você define um `TimeToLive` valor e a mensagem não é entregue antes que o cronômetro expire. Para obter mais informações sobre a expiração da mensagem, consulte[Configurando a expiração da mensagem RCS](rcs-message-expiration.md).
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. [Substituição de RCS para SMS usando grupos telefônicos](rcs-sms-fallback.md)
**Comparação dos mecanismos de fallback**
| Recurso | Pool-based recuar () `SendTextMessage` | Per-message recuar () `SendRcsMessage` |
| --- | --- | --- |
| Configuração | Automático quando um pool contém um agente RCS e identidades SMS | Explícito: você inclui FallbackConfiguration em cada solicitação |
| Canal alternativo | SMS (selecionado pela piscina) | SMS ou MMS (você escolhe comChannel) |
| Conteúdo alternativo | Mesmo corpo da mensagem | Você fornece conteúdo separado, personalizado para SMS ou MMS |
| Seleção de identidade | Pool seleciona a identidade de origem | Você especifica um número de telefone ou ID do remetente |
| Trigger | RCS não suportado (baseado em tempo limite) | Falha imediata do RCS ou expiração do TTL |
## 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.
**FallbackConfiguration campos**
| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| Channel | String | Sim | O canal alternativo. Valores válidos: SMS ou MMS. |
| MessageBody | String | Condicional | O corpo do texto da mensagem alternativa. Máximo de 1.600 caracteres. Exigido quando Channel éSMS. ParaMMS, pelo menos, um dos MessageBody ou MediaUrls deve ser fornecido. |
| MediaUrls | Lista de strings | Condicional | Um ou mais URLs de mídia para um substituto de MMS. ParaMMS, pelo menos, um dos MessageBody ou MediaUrls deve ser fornecido. |
| OriginationIdentity | String | Condicional | A identidade de origem da mensagem alternativa. Aceita um número de telefone ou ID de remetente (por valor, ID ou ARN); você não pode especificar um pool ou um agente RCS. Se você omitir esse campo e a mensagem original for enviada por meio de um pool, o serviço selecionará um número adequado desse pool. |
**Importante**
O `MessageBody` limite de fallback é de 1.600 caracteres. Isso é menor do que o limite de 3.072 caracteres para o corpo do RCS. `TextMessage` Crie seu conteúdo alternativo de acordo com as restrições de caracteres de SMS ou MMS.
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 um`MessageBody`. 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, consulte[Configurando a expiração da mensagem RCS](rcs-message-expiration.md).
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
+ **Escreva conteúdo alternativo separadamente.** O conteúdo rico em RCS (chips de sugestões, cartões avançados, carrosséis) não é traduzido diretamente para SMS ou MMS. Escreva uma mensagem alternativa concisa e independente em vez de reutilizar o corpo do RCS literalmente.
+ **Inclua URLs como texto simples no substituto de SMS.** Substitua os chips de sugestão interativos (como `OpenUrl` ações) por URLs embutidos no. `MessageBody`
+ **Use o substituto de MMS para conteúdo visual.** Se sua mensagem RCS apresentar um rich card ou carrossel com imagens, o MMS fallback preservará o contexto visual para destinatários sem suporte a RCS.
+ **Defina um TTL razoável.** Ao combinar o fallback com`TimeToLive`, escolha um TTL que equilibre as tentativas de entrega com a pontualidade. Para mensagens urgentes, um TTL de 30 a 60 segundos fornece uma breve janela de entrega do RCS antes de retornar. Para mensagens gerais, uma janela mais longa (minutos a horas) dá ao canal RCS mais oportunidades de sucesso.
+ **Verifique sua identidade de origem.** `OriginationIdentity`Na configuração alternativa, deve ser um número de telefone ou ID do remetente registrado em sua conta de mensagens de usuário AWS final e capaz de enviar SMS ou MMS para o país de destino.
## Recursos relacionados
+ [Substituição de RCS para SMS usando grupos telefônicos](rcs-sms-fallback.md)para obter informações sobre o fallback automático baseado em pool com. `SendTextMessage`
+ [Configurando a expiração da mensagem RCS](rcs-message-expiration.md)para obter informações sobre como configurar o TTL e o comportamento de expiração.
+ [Enviando mensagens ricas de RCS](rcs-rich-messaging.md)para obter uma visão geral dos tipos de mensagens ricas em RCS e da `SendRcsMessage` API.