View a markdown version of this page

Enviando mensagens de texto RCS - AWS SMS de mensagens para o usuário final
Como as mensagens de texto RCS diferem do SMSRcsMessageContent estrutura para mensagens de textoEnviando uma mensagem de textoRecuo de SMS ou MMSLimites de mensagens de textoQuando usar mensagens de texto

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 de texto RCS

A TextMessage é o tipo de conteúdo mais simples que você pode enviar com a SendRcsMessage API. Ele consiste em um corpo de texto simples (até 3.072 caracteres) com chips de sugestão opcionais que aparecem como botões interativos abaixo da mensagem.

Como as mensagens de texto RCS diferem do SMS

As mensagens de texto enviadas SendRcsMessage diferem das enviadas por SendTextMessage (SMS) de duas maneiras:

  • Chips de sugestão: você pode anexar até 11 chips de sugestão a uma mensagem de texto RCS. Com esses chips, os destinatários podem responder, abrir um URL, discar um número de telefone, compartilhar um local ou criar um evento na agenda em uma única etapa. O SMS não suporta sugestões.

  • Single-message entrega: uma mensagem de texto RCS chega como uma única mensagem, independentemente do tamanho (até 3.072 caracteres). As operadoras dividem as mensagens SMS com mais de 160 caracteres em vários segmentos, que podem chegar fora de ordem ou com atrasos entre os segmentos.

Para obter detalhes sobre todos os tipos de sugestão disponíveis e seus parâmetros, consulteConfigurando sugestões de RCS.

RcsMessageContent estrutura para mensagens de texto

Ao ligarSendRcsMessage, você passa a carga útil da mensagem como RcsMessageContent parâmetro. Para uma mensagem de texto, defina o Content campo como um TextMessage objeto contendo uma Body string. Para incluir chips de sugestão, adicione uma Suggestions matriz como irmã de nível superior de. Content

O trecho JSON a seguir mostra a estrutura de uma mensagem RcsMessageContent de texto com sugestões:

{
  "Content": {
    "TextMessage": {
      "Body": "What would you like to do?"
    }
  },
  "Suggestions": [
    {
      "Reply": {
        "Text": "Check order status",
        "PostbackData": "action=check_order"
      }
    },
    {
      "OpenUrl": {
        "Text": "View details",
        "PostbackData": "action=view",
        "Url": "https://example.com/orders/1234"
      }
    }
  ]
}

Neste exemplo:

  • Content.TextMessage.Bodycontém o texto da mensagem (obrigatório, de 1 a 3.072 caracteres).

  • Suggestionsé uma matriz de nível superior (opcional, até 11 itens). Cada sugestão requer um Text campo (até 25 caracteres) e um PostbackData campo (até 2.048 caracteres).

A Suggestions matriz oferece suporte a seis tipos de ação: Reply OpenUrlDialPhone,ShowLocation,RequestLocation,, CreateCalendarEvent e. Você pode misturar diferentes tipos de sugestões em uma única mensagem. Para obter detalhes completos sobre cada tipo, consulteConfigurando sugestões de RCS.

Enviando uma mensagem de texto

Para enviar uma mensagem de texto RCS, ligue SendRcsMessage com os seguintes parâmetros obrigatórios:

  • DestinationPhoneNumber: O número de telefone do destinatário em E.164 formato.

  • OriginationIdentity: O ID do pool ou o AWS RCS Agent que envia a mensagem.

  • RcsMessageContent: a string JSON que contém Content um TextMessage objeto.

Você chama a API usando a AWS CLI (aws pinpoint-sms-voice-v2 send-rcs-message) ou um SDK da AWS, como o cliente boto3. pinpoint-sms-voice-v2

Recuo de SMS ou MMS

Se o dispositivo do destinatário não suportar RCS ou estiver temporariamente inacessível no canal RCS, você poderá configurar a mensagem para retornar ao SMS ou MMS. Para ativar o fallback, inclua um FallbackConfiguration objeto em sua SendRcsMessage solicitação. FallbackConfigurationEspecifica o canal alternativo (SMSouMMS), o corpo da mensagem alternativa e a identidade de origem (um número de telefone ou ID do remetente) a serem usados na mensagem alternativa.

O fallback é opcional. Se você omitir FallbackConfiguration e o destinatário não puder receber o RCS, a mensagem não será entregue.

Para obter mais informações sobre como configurar o comportamento de fallback, consulte. Enviando mensagens ricas de RCS

Limites de mensagens de texto

Recurso Limite Observações
Corpo da mensagem (Body) 3.072 caractere (s) UTF-8 Obrigatório. Deve conter pelo menos 1 caractere.
Sugestões por mensagem 11 Total combinado de respostas e ações.
Texto de exibição da sugestão (Text) 25 caracteres Aplica-se a todos os tipos de sugestão.
Dados de postback () PostbackData 2,048 caracteres Obrigatório para todos os tipos de sugestão.

Quando usar mensagens de texto

Use TextMessage para:

  • Notificações como confirmações de pedidos, atualizações de envio e lembretes de compromissos.

  • One-time senhas e códigos de verificação.

  • Solicitações de conversação que oferecem opções de resposta como chips de sugestão, permitindo interações guiadas sem entrada de texto livre.

  • Atualizações curtas de status em que o conteúdo não exige imagens ou layouts estruturados.

Para mensagens que exijam imagens, vídeos ou layouts estruturados com títulos e descrições, use cartões ricos ou carrosséis em vez disso. Consulte Enviando mensagens ricas de RCS.