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á.
# Enviando mensagens ricas de RCS
Com a ação da `SendRcsMessage` API no AWS End User Messaging, você pode enviar conteúdo rico e interativo aos destinatários via RCS (Rich Communication Services). As mensagens RCS avançadas vão além do texto simples e incluem rich cards, carrosséis, arquivos de mídia e sugestões que os destinatários escolhem para realizar. Esses elementos interativos transformam notificações unidirecionais em experiências de conversação bidirecionais, como permitir que um destinatário confirme um compromisso, navegue por um catálogo de produtos ou compartilhe sua localização sem sair da conversa.
Use `SendRcsMessage` quando precisar fornecer conteúdo interativo e visualmente rico, como cartões de produtos com imagens e botões de ação, confirmações de compromissos com uma sugestão de calendário, anexos de arquivos ou carrosséis de vários itens pelos quais os destinatários percorrem. Cada `SendRcsMessage` solicitação inclui um corpo de texto separado para qualquer conteúdo de texto e pode incluir um substituto opcional de SMS ou MMS para destinatários cujos dispositivos não suportam RCS.
Para mensagens de texto sem formatação que não exigem formatação avançada, use a ação da `SendTextMessage` API em vez disso. `SendTextMessage`aceita somente conteúdo de texto, o que simplifica a solicitação, e funciona com grupos de mensagens que selecionam automaticamente entre RCS e SMS com base na capacidade do destinatário. Para obter detalhes, consulte [Enviar mensagens RCS](rcs-send-message.md).
**Importante**
Você pode usar mensagens RCS `SendRcsMessage` em todos os países onde o RCS é suportado. Para ver a lista atual, consulte[Países com suporte para RCS](rcs-supported-countries.md).
**Topics**
+ [Pré-requisitos](#rcs-rich-messaging-prerequisites)
+ [Escolhendo entre SendTextMessage e SendRcsMessage](#rcs-rich-messaging-choosing)
+ [Tipos de conteúdo](#rcs-rich-messaging-content-types)
+ [Sugestões](#rcs-rich-messaging-suggestions)
+ [SendRcsMessage visão geral da solicitação](#rcs-rich-messaging-api)
+ [Limites de tamanho e contagem de mensagens](#rcs-rich-messaging-limits)
+ [Eventos de entrega e ações do destinatário](#rcs-rich-messaging-events)
+ [Práticas recomendadas](#rcs-rich-messaging-best-practices)
+ [Mensagens de texto](rcs-text-messages.md)
+ [Mensagens de arquivo](rcs-file-messages.md)
+ [Cartas ricas](rcs-rich-cards.md)
+ [Carrosséis](rcs-carousels.md)
+ [Sugestões](rcs-suggestions.md)
+ [Expiração da mensagem](rcs-message-expiration.md)
+ [Per-message recuar](rcs-fallback-per-message.md)
+ [Evento de mensagem](rcs-events.md)
+ [Mídia de entrada](rcs-inbound-media.md)
+ [Práticas recomendadas](rcs-best-practices.md)
+ [Mensagens ricas em console](rcs-console-rich-messaging.md)
## Pré-requisitos
Antes de enviar mensagens ricas de RCS, conclua as etapas de configuração do RCS em. [Conceitos básicos do RCS](rcs-getting-started.md) Além de um agente AWS RCS registrado no estado **Ativo**, confirme o seguinte:
+ Para validar o conteúdo avançado antes de enviá-lo aos destinatários da produção, adicione um dispositivo de teste registrado ao seu agente de teste e envie mensagens de teste para ele. Para obter detalhes, consulte [Testando mensagens RCS](rcs-testing.md).
+ Configure um destino de evento (um tópico do Amazon SNS ou um stream de entrega do Amazon Data Firehose) para receber eventos de status de entrega. Um destino de evento é necessário se suas mensagens incluírem elementos interativos, como sugestões, porque as seleções de destinatários são entregues ao seu aplicativo como eventos de postback. Para obter detalhes, consulte [Destinos de eventos em SMS de mensagens de usuário AWS final](configuration-sets-event-destinations.md).
+ Se você configurar um fallback de SMS ou MMS e enviar para destinos com risco de bombeamento de SMS, associe uma configuração de proteção para aplicar regras de exclusão e de país à mensagem alternativa. Para obter detalhes, consulte [Proteção contra fraudes em AWS SMS de mensagens para o usuário final](protect.md).
## Escolhendo entre SendTextMessage e SendRcsMessage
Ambas as ações da API podem entregar mensagens pelo RCS, mas têm propósitos diferentes. `SendTextMessage`assume que cada mensagem pode ser entregue como SMS e também pode entregá-la por RCS, o que proporciona um contrato de solicitação mais simples. `SendRcsMessage`pressupõe conteúdo RCS rico e adiciona recursos que `SendTextMessage` não existem, incluindo tipos de conteúdo estruturado e de mídia, expiração de mensagens com tempo de vida útil (TTL) e retorno de SMS ou MMS por mensagem.
**SendTextMessage comparado com SendRcsMessage**
| Recurso | SendTextMessage | SendRcsMessage |
| --- | --- | --- |
| Conteúdo da mensagem | Somente texto sem formatação | Texto, arquivos, rich cards e carrosséis, cada um com sugestões opcionais |
| Canais de entrega | RCS ou SMS | RCS, com recurso opcional de SMS ou MMS |
| Seleção de canais | O pool seleciona RCS ou SMS automaticamente de acordo com a capacidade do destinatário | Primeiro o RCS, depois o fallback configurado de SMS ou MMS |
| Fallback (Recuar) | Automático, baseado em piscina | Explícito, por mensagem |
| Identidades de origem | Pool, número de telefone, ID do remetente ou AWS RCS Agent | Pool ou AWS RCS Agent |
| Expiração da mensagem (TTL) | Não | Sim |
| Solicitar contrato | Mais simples. Mesma API do envio de SMS e MMS | API RCS dedicada com corpo de texto e tipos de conteúdo separados |
Escolha `SendTextMessage` notificações em texto sem formatação, quando quiser uma seleção automática de canais baseada em pool ou quando estiver migrando fluxos de trabalho de SMS existentes com o mínimo de alterações de código. Escolha `SendRcsMessage` quando você precisa de rich cards, carrosséis, arquivos de mídia ou sugestões, quando deseja um substituto definido por mensagem ou quando precisa TTL-based expirar para conteúdo urgente.
## Tipos de conteúdo
O `RcsMessageContent` parâmetro contém um `Content` objeto com exatamente um tipo de conteúdo e uma lista opcional em nível de mensagem`Suggestions`. Você não pode combinar vários tipos de conteúdo em uma única solicitação.
**Tipos de conteúdo RCS**
| Tipo de conteúdo | Description | Mais informações |
| --- | --- | --- |
| TextMessage | Corpo de texto de até 3.072 caracteres, com sugestões opcionais. Ao contrário de uma mensagem SMS, uma mensagem de texto RCS pode incluir sugestões e é entregue como uma única mensagem, em vez de ser dividida em segmentos. | [Enviando mensagens de texto RCS](rcs-text-messages.md) |
| FileMessage | Um único arquivo de mídia (imagem, vídeo, áudio ou PDF) referenciado por um URL HTTPS ou Amazon S3. | [Enviando mensagens de arquivo RCS](rcs-file-messages.md) |
| RichCard | Um cartão estruturado com mídia opcional, um título, uma descrição e até 4 sugestões. | [Enviando cartões ricos em RCS](rcs-rich-cards.md) |
| Carrossel | Um conjunto rolável de 2 a 10 cartões, cada um com sua própria mídia, texto e sugestões. | [Enviando carrosséis RCS](rcs-carousels.md) |
## Sugestões
As sugestões são chips interativos que os destinatários escolhem para realizar uma ação. Você pode adicionar sugestões a qualquer tipo de conteúdo: as sugestões no nível da mensagem se aplicam à mensagem inteira (até 11) e as sugestões no nível do cartão se aplicam a um rich card individual ou cartão de carrossel (até 4). AWSO End User Messaging suporta seis tipos de sugestões, incluindo respostas, links e ações, como discar um número de telefone ou compartilhar um local. Para ver a lista completa dos tipos de sugestão, seus parâmetros e como receber toques de sugestão, consulte[Configurando sugestões de RCS](rcs-suggestions.md).
## SendRcsMessage visão geral da solicitação
A `SendRcsMessage` solicitação usa os seguintes parâmetros-chave.
**SendRcsMessage Parâmetros-chave**
| Parâmetro | Obrigatório | Descrição |
| --- | --- | --- |
| DestinationPhoneNumber | Sim | O número de telefone do destinatário em E.164 formato, por exemplo\+12065550100. |
| OriginationIdentity | Sim | O ID ou ARN de um pool ou de um agente do AWS RCS do qual enviar. O agente deve estar no estado Ativo. |
| RcsMessageContent | Não | O conteúdo da mensagem. Contém um Content objeto com exatamente um dosTextMessage,FileMessage, RichCardCarousel, ou e uma Suggestions lista opcional de nível superior. |
| FallbackConfiguration | Não | A mensagem SMS ou MMS a ser enviada se a entrega do RCS não for bem-sucedida. Inclui um obrigatório Channel (SMSouMMS)MessageBody, um opcional MediaUrls para MMS e um OriginationIdentity que é um número de telefone ou ID do remetente. |
| TimeToLive | Não | O tempo em segundos antes que a mensagem expire se ela não for entregue. O mínimo é de 1 segundo e o máximo é de 172.800 segundos (48 horas). Um valor de 10 segundos ou mais é recomendado. |
| MessageFeedbackEnabled | Não | Defina true como para ativar o feedback da mensagem. Quando o destinatário receber a mensagem, atualize o status da mensagem chamando a PutMessageFeedback operação. |
Uma resposta bem-sucedida retorna uma `MessageId` que você usa para correlacionar eventos de status de entrega.
**nota**
O Fallback for `SendRcsMessage` é configurado por `FallbackConfiguration` mensagem enviada. Para ver o comportamento de fallback completo, consulte[Configurando o fallback de SMS ou MMS por mensagem](rcs-fallback-per-message.md).
## Limites de tamanho e contagem de mensagens
**Limites de mensagens RCS**
| Limite | Valor |
| --- | --- |
| Corpo da mensagem de texto | 3.072 caracteres |
| Título do Rich Card | 200 caracteres |
| Descrição rica do cartão | 2.000 caracteres |
| Tamanho do arquivo de mídia | 100 MB |
| Tamanho do URL da mídia | 2.000 caracteres |
| Sugestões por mensagem | 11 |
| Sugestões por cartão | 4 |
| Texto de exibição da sugestão | 25 caracteres |
| Dados de postback | 2,048 caracteres |
| Cartões de carrossel | 2 a 10 cartas |
| Time-to-live | 1 segundo a 172.800 segundos (48 horas) |
Para ver os limites e restrições do RCS em todos os tipos de conteúdo, consulte[Limites e restrições de mensagens](sms-limitations.md).
## Eventos de entrega e ações do destinatário
AWSO End User Messaging gera eventos que relatam o status de entrega da mensagem e as ações do destinatário, incluindo eventos entregues, lidos, com falha, expirados e postback. Um evento de postback é gerado quando um destinatário escolhe uma sugestão e inclui o `PostbackData` valor. Direcione esses eventos para um tópico do Amazon SNS, um stream de entrega do Amazon Data Firehose ou Amazon Logs. CloudWatch Para obter detalhes, consulte [Eventos de mensagem RCS](rcs-events.md).
## Práticas recomendadas
Crie mensagens RCS ricas como experiências conversacionais e interativas. Defina um `TimeToLive` para conteúdo urgente, como senhas de uso único, configure um substituto de SMS ou MMS para mensagens que devem chegar ao destinatário mesmo quando o dispositivo não suporta RCS, mantenha os rótulos de sugestão curtos (o limite é de 25 caracteres) e inclua identificadores estruturados para que seu aplicativo `PostbackData` possa rotear respostas sem pesquisas adicionais. Para obter orientação detalhada, consulte[Melhores práticas de RCS](rcs-best-practices.md).