View a markdown version of this page

Enviando mensagens ricas de RCS a partir do console - AWSSMS de mensagens para o usuário final
Pré-requisitosEnviando uma mensagem RCS avançadaValidação de entradaRecursos relacionados

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 a partir do console

O console AWS End User Messaging fornece um compositor visual de mensagens que você pode usar para criar e enviar mensagens RCS avançadas sem escrever código. O compositor mapeia diretamente para a SendRcsMessage API e oferece suporte a todos os tipos de conteúdo: mensagens de texto, mensagens de arquivo, rich cards e carrosséis. Você pode anexar sugestões interativas a qualquer tipo de mensagem, definir as configurações de tempo de vida (TTL) e configurar o fallback de SMS ou MMS para destinatários cujos dispositivos não suportam RCS.

Você compõe e envia mensagens avançadas na guia Mensagens de teste de saída da interface de teste do RCS. As mensagens são enviadas aos testadores RBM verificados para que você possa validar a renderização e a entrega antes de integrar a API ao SendRcsMessage seu aplicativo.

Conforme você configura a mensagem, uma visualização prévia do telefone em tempo real mostra como a mensagem é renderizada no dispositivo do destinatário. Você também pode copiar a carga útil JSON equivalente ou o comando AWS CLI para usar a mesma estrutura de mensagens no código do aplicativo.

Para obter mais informações sobre os tipos de mensagens e sua estrutura de API, consulteEnviando mensagens ricas de RCS. Para obter detalhes sobre os tipos de sugestões e o comportamento, consulteConfigurando sugestões de RCS.

Pré-requisitos

Antes de enviar mensagens RCS avançadas do console, confirme o seguinte:

  • Seu agente RCS está no estado de teste ou ativo.

  • Você tem pelo menos um número de telefone verificado do RBM tester associado ao seu agente. Consulte Testando mensagens RCS para obter instruções de configuração.

  • Se você planeja enviar arquivos de mídia do Amazon S3, o bucket do S3 deve ter uma política de bucket que sms-voice.amazonaws.com conceda acesso de leitura. Para obter detalhes, consulte Enviando mensagens de arquivo RCS.

Enviando uma mensagem RCS avançada

Use o procedimento a seguir para redigir e enviar uma mensagem RCS avançada do console AWS End User Messaging.

  1. Abra o console de mensagens do usuário AWS final emhttps://console.aws.amazon.com/sms-voice/.

  2. No painel de navegação, em Configurações, escolha Agentes RCS.

  3. Escolha o agente que você deseja usar como identidade de origem. O status do agente deve ser Testando ou Ativo.

  4. Escolha a guia Teste.

  5. Na interface de teste do RCS, escolha a guia Mensagens de teste de saída.

  6. Na seção Enviar mensagem RCS de teste, em Selecionar testador RBM, escolha um número de telefone verificado do testador RBM.

  7. (Opcional) Em Conjunto de configurações, escolha um conjunto de configurações para rastrear eventos de mensagens.

  8. Em Selecionar API, escolha SendRcsMessage.

  9. Em Selecionar formato de mensagem, escolha o tipo de mensagem que você deseja enviar:

    • Texto: insira o corpo da mensagem (até 3.072 caracteres).

    • Arquivo: para a fonte de mídia, escolha bucket do S3 ou URL pública e, em seguida, insira o URI do S3 (ou URL HTTPS) do arquivo a ser enviado. Escolha Procurar no S3 para selecionar um arquivo de um bucket ou Exibir para abrir o arquivo referenciado em uma nova guia do navegador. O tamanho máximo do arquivo é de 100 MB. Opcionalmente, forneça um URL em miniatura para arquivos de vídeo ou PDF.

    • Rich card: configure os seguintes campos do cartão. É necessário pelo menos um título, descrição ou mídia.

      • Orientação do cartão: Escolha VERTICAL ouHORIZONTAL.

      • Título do cartão: insira um título (até 200 caracteres).

      • Descrição do cartão: insira uma descrição (até 2.000 caracteres).

      • URL de mídia: para a fonte de mídia, escolha bucket do S3 ou URL pública e, em seguida, insira o URI do S3 (ou URL HTTPS). Escolha Procurar no S3 para selecionar um arquivo ou Exibir para abri-lo em uma nova guia do navegador. O tamanho máximo do arquivo é de 100 MB.

      • (Opcional) URL da miniatura da mídia: uma imagem de visualização mostrada antes do carregamento completo da mídia.

      • (Somente orientação HORIZONTAL) Alinhamento da miniatura: escolha LEFT ou posicione RIGHT a imagem em miniatura.

      • Sugestões de cartão: adicione até 4 sugestões que são renderizadas como botões dentro do limite do cartão. Para tipos de sugestão, consulteConfigurando sugestões de RCS.

    • Carrossel: configure o seguinte:

      • Largura do cartão: escolha SMALL ouMEDIUM.

      • Altura da mídia (todos os cartões): escolha SHORT ouMEDIUM. Todos os cartões em um carrossel usam a mesma altura de mídia.

      • Cartões: Adicione entre 2 e 10 cartões. Cada cartão inclui um título, uma descrição do cartão, um URL de mídia (bucket do S3 ou URL público, máximo de 100 MB) e até 4 sugestões de cartão. É necessário pelo menos um título, descrição ou mídia para cada cartão.

    • JSON: cole diretamente uma carga RcsMessageContent JSON bruta. Escolha Formatar JSON para formatar a carga. O console valida a estrutura e atualiza a pré-visualização do telefone em tempo real.

  10. (Opcional) Configure arquivos de mídia usando o navegador S3:

    1. Selecione Navegar no S3.

    2. Selecione um bucket na lista suspensa.

    3. Navegue pelos prefixos (pastas) para localizar seu arquivo.

    4. Selecione o arquivo . O campo URL é preenchido automaticamente.

    nota

    O bucket do S3 deve ter uma política de bucket que conceda acesso de sms-voice.amazonaws.com leitura aos objetos. Para obter a política necessária, consulteEnviando mensagens de arquivo RCS.

  11. (Opcional) Adicione sugestões em nível de mensagem. Na seção Sugestões:

    1. Escolha Adicionar sugestão.

    2. Para o tipo de sugestão, escolha entre Responder, Abrir URL, Discar telefone, Mostrar localização, Solicitar localização ou Evento do calendário.

    3. Insira os campos obrigatórios para o tipo selecionado. Todos os tipos de sugestão exigem um Text valor (até 25 caracteres) e PostbackData (até 2.048 caracteres).

    4. Repita o procedimento para adicionar até 11 sugestões em nível de mensagem.

    Message-level as sugestões são renderizadas como uma lista de chips abaixo da mensagem inteira. Você pode anexar sugestões em nível de mensagem a qualquer tipo de conteúdo (texto, arquivo, rich card ou carrossel). Para obter detalhes, consulte Configurando sugestões de RCS.

  12. (Opcional) Defina a configuração de tempo de vida (TTL). Expanda Opções avançadas e insira um valor no campo Tempo de vida (segundos). Os valores válidos variam de 1 a 172.800 segundos (48 horas). Um valor mínimo de 10 segundos é recomendado.

    Se a mensagem não for entregue antes da expiração do TTL, o serviço acionará um evento de expiração do TTL. Se você configurou o fallback, a mensagem de fallback será enviada nesse momento.

    A seção de opções avançadas também contém preço máximo (USD), tiragem seca, feedback de mensagens, configuração de proteção e contexto (metadados opcionais de valor-chave).

  13. (Opcional) Configure o fallback de SMS ou MMS. Expanda a seção de configuração do Fallback:

    1. Para o canal Fallback, escolha SMS ou MMS.

    2. Em Corpo da mensagem de fallback, insira o texto da mensagem (até 1.600 caracteres). É necessário um corpo de mensagem quando um canal alternativo é selecionado.

    3. Para MMS, você também pode fornecer um ou mais URLs de mídia.

    4. Em Identidade de origem, insira o número de telefone ou ID do remetente a ser usado para a mensagem SMS ou MMS alternativa. Isso é necessário ao enviar de um agente RCS.

    O fallback é acionado quando a mensagem não pode ser entregue pelo RCS (por exemplo, quando o dispositivo do destinatário não oferece suporte ao RCS ou quando o TTL expira). Para obter mais informações, consulte Enviando mensagens ricas de RCS.

  14. (Opcional) Nas opções avançadas, ative a execução a seco para validar a estrutura da mensagem sem enviar. Isso não gera cobranças e não entrega a mensagem ao destinatário.

  15. Revise a pré-visualização do telefone no lado direito do compositor. A prévia é atualizada em tempo real e mostra:

    • Renderização de conteúdo (texto, mídia, layout do cartão, rolagem do carrossel)

    • Chips de sugestão abaixo da mensagem

    • Card-level botões dentro dos cartões

    nota

    A pré-visualização aproxima a renderização do Android. A exibição no iOS ou em outros clientes RCS pode ser diferente. A visualização prévia não simula o comportamento de seleção de sugestões.

  16. Escolha Enviar mensagem de teste para enviar a mensagem ao testador RBM selecionado ou use uma das seguintes opções:

    • Copiar JSON: copia a mensagem JSON para sua área de transferência. Escolha RcsMessageContentcopiar somente a parte do conteúdo ou a solicitação de API completa para copiar o corpo completo da SendRcsMessage solicitação.

    • Copiar comando CLI: copia o comando equivalenteaws pinpoint-sms-voice-v2 send-rcs-message.

Validação de entrada

O console executa a validação em tempo real à medida que você configura a mensagem. Os erros de validação são exibidos em linha ao lado do campo afetado. A tabela a seguir resume as regras de validação.

Regras de validação do console
Campo Regra
Número de telefone Deve ser E.164 formatado
URL de mídia Deve começar com https:// ou s3://
Tamanho do arquivo de mídia Máximo de 100 MB
Texto de sugestão Máximo de 25 caracteres
Dados de postback Máximo de 2.048 caracteres
Título do cartão Máximo de 200 caracteres
Descrição do cartão Máximo de 2.000 caracteres
Cartões de carrossel Mínimo 2, máximo 10
Card-level sugestões Máximo de 4 por cartão
Message-level sugestões Máximo 11
Corpo da mensagem de texto Máximo de 3.072 caracteres
TTL 1 a 172.800 segundos
Corpo da mensagem alternativa Máximo de 1.600 caracteres