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 sugestões de RCS

As sugestões são chips interativos que aparecem abaixo ou dentro de uma mensagem RCS. Eles orientam os destinatários em uma conversa apresentando respostas e ações predefinidas, como abrir uma URL, ligar para um número de telefone ou compartilhar um local, sem exigir que o destinatário digite. As sugestões são como você cria experiências interativas e de conversação com o. SendRcsMessage

Você pode adicionar sugestões a qualquer tipo de conteúdo (texto, arquivo, rich card e carrossel) em dois níveis:

AWSO End User Messaging suporta seis tipos de sugestões: Reply OpenUrl DialPhoneShowLocation,,RequestLocation,, CreateCalendarEvent e. Cada sugestão requer um Text rótulo (até 25 caracteres) e PostbackData (até 2.048 caracteres).

Como funcionam os dados de postback

Cada sugestão inclui uma PostbackData sequência de até 2.048 caracteres que o AWS End User Messaging envia de volta ao seu aplicativo quando o destinatário escolhe a sugestão. Os dados do postback não são visíveis para o destinatário. Use-o para codificar informações de roteamento, identificadores de intenção, contexto da sessão ou quaisquer metadados que seu back-end precise para processar a seleção.

Quando um destinatário escolhe uma sugestão, o AWS End User Messaging entrega um evento de mensagem de entrada para o tópico do Amazon SNS que você configura para mensagens bidirecionais. Direcione sua lógica em postbackData vez do texto exibido. Para obter detalhes sobre eventos de entrada, consulteEventos de mensagem RCS.

Exibição de sugestões

Responder

Uma Reply sugestão envia uma resposta de texto predefinida de volta ao seu agente. O texto exibido aparece como uma mensagem enviada na conversa e PostbackData é entregue ao seu aplicativo.

{ "Reply": { "Text": "Yes, confirm", "PostbackData": "confirm_order_12345" } }

OpenUrl

Uma OpenUrl sugestão abre um URL. Por padrão, o URL é aberto no navegador do dispositivo. Para abrir a URL em uma visualização da web que mantém o destinatário dentro do aplicativo de mensagens, Application defina WEBVIEW e especifique a. WebviewViewMode

{
  "OpenUrl": {
    "Text": "Complete payment",
    "PostbackData": "pay_12345",
    "Url": "https://example.com/pay",
    "Application": "WEBVIEW",
    "WebviewViewMode": "TALL"
  }
}

DialPhone

Uma DialPhone sugestão inicia uma chamada telefônica para o número que você especificar.

{ "DialPhone": { "Text": "Call support", "PostbackData": "dial_support", "PhoneNumber": "+18005551234" } }

ShowLocation

Uma ShowLocation sugestão abre um mapa nas coordenadas que você especificar.

{
  "ShowLocation": {
    "Text": "View on map",
    "PostbackData": "show_store_loc",
    "Latitude": 47.6062,
    "Longitude": -122.3321,
    "Label": "Seattle store"
  }
}

RequestLocation

Uma RequestLocation sugestão solicita que o destinatário compartilhe sua localização atual. As coordenadas compartilhadas chegam como um evento de localização de entrada separado.

{ "RequestLocation": { "Text": "Share location", "PostbackData": "request_user_location" } }

CreateCalendarEvent

Uma CreateCalendarEvent sugestão cria um evento de calendário no dispositivo do destinatário com os detalhes que você especificar.

{
  "CreateCalendarEvent": {
    "Text": "Add to calendar",
    "PostbackData": "calendar_appt_5678",
    "Title": "Service appointment",
    "StartTime": "2026-05-28T14:00:00Z",
    "EndTime": "2026-05-28T15:00:00Z",
    "Description": "Downtown location. Arrive 10 minutes early."
  }
}

Recebendo sugestões de toques

Quando um destinatário escolhe uma sugestão, o AWS End User Messaging publica uma mensagem de entrada em seu tópico bidirecional do SNS. O messageBody contém um objeto JSON com o tipo de sugestão, o texto de exibição e o postbackData que você definiu. Ative sua lógicapostbackData.

{
  "originationNumber": "+12065551234",
  "destinationNumber": "rcs-a1b2c3d4",
  "messageBody": "{\"type\":\"SUGGESTION\",\"text\":\"Yes, confirm\",\"postbackData\":\"confirm_order_12345\"}",
  "inboundMessageId": "msg-abc123def456"
}

Com um RequestLocation toque, as coordenadas do destinatário chegam em um evento de localização de entrada separado. Para obter a referência completa do evento de entrada, consulteEventos de mensagem RCS.

Limites de sugestão

Práticas recomendadas

Para obter uma orientação mais aprofundada, consulteMelhores práticas de RCS.

Tópicos relacionados