Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Configuración de sugerencias de RCS

Las sugerencias son fichas interactivas que aparecen debajo o dentro de un mensaje de RCS. Guían a los destinatarios a lo largo de la conversación presentándoles respuestas y acciones predefinidas, como abrir una URL, llamar a un número de teléfono o compartir una ubicación, sin necesidad de que el destinatario escriba nada. Las sugerencias son la forma de crear experiencias conversacionales e interactivas con SendRcsMessage ellas.

Puedes añadir sugerencias a cualquier tipo de contenido (texto, archivo, tarjeta enriquecida y carrusel) en dos niveles:

AWSLa mensajería para el usuario final admite seis tipos de sugerencias: Reply OpenUrlDialPhone,ShowLocation,RequestLocation, yCreateCalendarEvent. Cada sugerencia requiere una Text etiqueta (hasta 25 caracteres) y PostbackData (hasta 2048 caracteres).

Cómo funcionan los datos de devolución

Cada sugerencia incluye una PostbackData cadena de hasta 2048 caracteres que los mensajes del usuario AWS final envían a la aplicación cuando el destinatario elige la sugerencia. Los datos de devolución no son visibles para el destinatario. Úsalos para codificar la información de enrutamiento, los identificadores de intención, el contexto de la sesión o cualquier metadato que tu backend necesite para procesar la selección.

Cuando un destinatario elige una sugerencia, AWS End User Messaging envía un evento de mensaje entrante al tema de Amazon SNS que usted configura para la mensajería bidireccional. Dirija su lógica en postbackData lugar del texto que se muestra. Para obtener más información sobre los eventos entrantes, consulteeventos de mensajes RCS.

Visualización de sugerencias

Responder

Una Reply sugerencia envía una respuesta de texto predefinido a su agente. El texto que se muestra aparece como un mensaje enviado en la conversación y PostbackData se envía a la aplicación.

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

OpenUrl

Una OpenUrl sugerencia abre una URL. De forma predeterminada, la URL se abre en el navegador del dispositivo. Para abrir la URL en una vista web que mantenga al destinatario dentro de la aplicación de mensajería, Application configúrela WEBVIEW y especifique unaWebviewViewMode.

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

DialPhone

Una DialPhone sugerencia inicia una llamada telefónica al número que especifiques.

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

ShowLocation

Una ShowLocation sugerencia abre un mapa en las coordenadas que especifique.

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

RequestLocation

Una RequestLocation sugerencia pide al destinatario que comparta su ubicación actual. Las coordenadas compartidas llegan como un evento de ubicación entrante independiente.

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

CreateCalendarEvent

Una CreateCalendarEvent sugerencia crea un evento de calendario en el dispositivo del destinatario con los detalles que especifiques.

{
  "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."
  }
}

Al recibir sugerencias, toca

Cuando un destinatario elige una sugerencia, AWS End User Messaging publica un mensaje entrante en tu tema de SNS bidireccional. messageBodyContiene un objeto JSON con el tipo de sugerencia, el texto que se muestra y lo que tú configuraste. postbackData Activa tu lógicapostbackData.

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

Con un RequestLocation toque, las coordenadas del destinatario llegan en un evento de ubicación entrante independiente. Para ver la referencia completa del evento entrante, consulte. eventos de mensajes RCS

Límites de sugerencias

Prácticas recomendadas

Para obtener una orientación más detallada, consulteMejores prácticas de RCS.

Temas relacionados