Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration des suggestions RCS

Les suggestions sont des puces interactives qui apparaissent en dessous ou dans un message RCS. Ils guident les destinataires tout au long d'une conversation en présentant des réponses et des actions prédéfinies, telles que l'ouverture d'une URL, l'appel d'un numéro de téléphone ou le partage d'une position, sans que le destinataire ait à saisir du texte. Les suggestions concernent la manière dont vous pouvez créer des expériences interactives et conversationnelles avecSendRcsMessage.

Vous pouvez ajouter des suggestions à n'importe quel type de contenu (texte, fichier, carte enrichie et carrousel) à deux niveaux :

AWSLa messagerie destinée aux utilisateurs finaux prend en charge six types de suggestions : Reply OpenUrlDialPhone,ShowLocation,RequestLocation,, etCreateCalendarEvent. Chaque suggestion nécessite une Text étiquette (jusqu'à 25 caractères) et PostbackData (jusqu'à 2 048 caractères).

Comment fonctionnent les données de post-back

Chaque suggestion inclut une PostbackData chaîne de 2 048 caractères maximum que AWS la messagerie de l'utilisateur final renvoie à votre application lorsque le destinataire choisit la suggestion. Les données postback ne sont pas visibles pour le destinataire. Utilisez-le pour encoder les informations de routage, les identifiants d'intention, le contexte de session ou toute autre métadonnée dont votre backend a besoin pour traiter la sélection.

Lorsqu'un destinataire choisit une suggestion, AWS la messagerie utilisateur final envoie un message entrant à la rubrique Amazon SNS que vous configurez pour la messagerie bidirectionnelle. Acheminez votre logique postbackData plutôt que le texte affiché. Pour plus de détails sur les événements entrants, consultezÉvénements liés aux messages RCS.

Affichage des suggestions

Reply

Une Reply suggestion renvoie une réponse textuelle prédéfinie à votre agent. Le texte affiché apparaît sous forme de message envoyé dans la conversation et PostbackData est transmis à votre application.

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

OpenUrl

Une OpenUrl suggestion ouvre une URL. Par défaut, l'URL s'ouvre dans le navigateur de l'appareil. Pour ouvrir l'URL dans une vue Web qui permet au destinataire de rester dans l'application de messagerie, définissez Application WEBVIEW et spécifiez unWebviewViewMode.

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

DialPhone

Une DialPhone suggestion déclenche un appel téléphonique au numéro que vous avez indiqué.

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

ShowLocation

Une ShowLocation suggestion ouvre une carte aux coordonnées que vous spécifiez.

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

RequestLocation

Une RequestLocation suggestion invite le destinataire à partager sa position actuelle. Les coordonnées partagées arrivent sous la forme d'un événement de localisation entrant distinct.

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

CreateCalendarEvent

Une CreateCalendarEvent suggestion crée un événement de calendrier sur l'appareil du destinataire avec les informations que vous spécifiez.

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

Recevoir des suggestions

Lorsqu'un destinataire choisit une suggestion, AWS la messagerie utilisateur final publie un message entrant dans votre rubrique SNS bidirectionnelle. messageBodyIl contient un objet JSON avec le type de suggestion, le texte d'affichage et le postbackData que vous avez défini. Appliquez votre logiquepostbackData.

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

Pour un RequestLocation clic, les coordonnées du destinataire arrivent lors d'un événement de localisation entrant distinct. Pour la référence complète des événements entrants, voirÉvénements liés aux messages RCS.

Limites de suggestions

Bonnes pratiques

Pour des conseils plus approfondis, voirBonnes pratiques du RCS.

Rubriques en relation