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.
Envoi de messages RCS enrichis
Grâce à l'action SendRcsMessage API dans AWS la messagerie utilisateur final, vous pouvez envoyer du contenu riche et interactif aux destinataires via RCS (Rich Communication Services). Les messages RCS enrichis vont au-delà du texte brut et incluent des cartes enrichies, des carrousels, des fichiers multimédia et des suggestions d'actions que les destinataires choisissent de suivre. Ces éléments interactifs transforment les notifications unidirectionnelles en expériences conversationnelles bidirectionnelles, par exemple en permettant au destinataire de confirmer un rendez-vous, de parcourir un catalogue de produits ou de partager sa position sans quitter la conversation.
À utiliser SendRcsMessage lorsque vous devez diffuser du contenu interactif visuellement riche, tel que des fiches produits avec des images et des boutons d'action, des confirmations de rendez-vous avec une suggestion de calendrier, des pièces jointes ou des carrousels contenant plusieurs articles que les destinataires parcourent. Chaque SendRcsMessage demande inclut un corps de texte distinct pour tout contenu textuel, et peut inclure une solution de secours optionnelle par SMS ou MMS pour les destinataires dont les appareils ne prennent pas en charge le RCS.
Pour les messages en texte brut qui ne nécessitent pas de mise en forme enrichie, utilisez plutôt l'action SendTextMessage API. SendTextMessageaccepte uniquement le contenu texte, ce qui simplifie la demande, et fonctionne avec des pools de messagerie qui sélectionnent automatiquement entre RCS et SMS en fonction des capacités du destinataire. Pour en savoir plus, consultez Envoi de messages RCS.
Important
Vous pouvez utiliser la messagerie RCS SendRcsMessage dans tous les pays où le RCS est pris en charge. Pour la liste actuelle, voirPays pris en charge pour le RCS.
Rubriques
Conditions préalables
Avant d'envoyer des messages RCS enrichis, suivez les étapes de configuration du RCS décrites dans. Prise en main de RCS Outre un agent AWS RCS enregistré à l'état actif, vérifiez les points suivants :
-
Pour valider le contenu enrichi avant de l'envoyer aux destinataires de production, ajoutez un appareil de test enregistré à votre agent de test et envoyez-lui des messages de test. Pour en savoir plus, consultez Tester les messages RCS.
-
Configurez une destination d'événement (une rubrique Amazon SNS ou un flux de diffusion Amazon Data Firehose) pour recevoir les événements relatifs à l'état de livraison. Une destination d'événement est requise si vos messages incluent des éléments interactifs tels que des suggestions, car les sélections de destinataires sont transmises à votre application sous forme d'événements postback. Pour en savoir plus, consultez Destinations des événements dans les messages SMS destinés aux utilisateurs AWS finaux.
-
Si vous configurez un SMS ou un MMS de secours et que vous envoyez des SMS vers des destinations présentant un risque d'envoi de SMS, associez une configuration de protection pour appliquer les règles de désinscription et de pays au message de secours. Pour en savoir plus, consultez Protection contre la fraude dans AWS Messagerie SMS à l'utilisateur final.
Choisir entre SendTextMessage et SendRcsMessage
Les deux actions d'API peuvent envoyer des messages via RCS, mais elles ont des objectifs différents. SendTextMessagesuppose que chaque message est livrable sous forme de SMS et peut également le transmettre via RCS, ce qui simplifie le contrat de demande. SendRcsMessagesuppose un contenu RCS riche et ajoute des fonctionnalités qui SendTextMessage n'en ont pas, notamment les types de contenu multimédia et structuré, l'expiration des messages avec durée de vie (TTL) et le remplacement par SMS ou MMS par message.
| Capacité | SendTextMessage | SendRcsMessage |
|---|---|---|
| Contenu des messages | Texte brut uniquement | Texte, fichiers, fiches enrichies et carrousels, chacun avec des suggestions facultatives |
| Canaux de livraison | RCS ou SMS | RCS, avec option de secours par SMS ou MMS |
| Sélection du canal | Le pool sélectionne automatiquement le RCS ou le SMS en fonction de la capacité du destinataire | RCS d'abord, puis votre solution de secours par SMS ou MMS configurée |
| Fallback (Rechange) | Automatique, basé sur le pool | Explicite, par message |
| Identité d'origine | Pool, numéro de téléphone, identifiant de l'expéditeur ou agent AWS RCS | Pool ou agent AWS RCS |
| Expiration du message (TTL) | Non | Oui |
| Demander un contrat | Plus simple. Même API que l'envoi de SMS et MMS | API RCS dédiée avec un corps de texte et des types de contenu distincts |
Optez SendTextMessage pour des notifications en texte brut, lorsque vous souhaitez une sélection automatique des canaux basée sur un pool ou lorsque vous migrez des flux de travail SMS existants avec un minimum de modifications de code. Choisissez SendRcsMessage quand vous avez besoin de cartes enrichies, de carrousels, de fichiers multimédia ou de suggestions, lorsque vous souhaitez une solution de secours définie par message ou lorsque vous avez besoin TTL-based d'une date d'expiration pour le contenu urgent.
Types de contenus
Le RcsMessageContent paramètre contient un Content objet avec un seul type de contenu et une liste facultative au niveau des messagesSuggestions. Vous ne pouvez pas combiner plusieurs types de contenu dans une seule demande.
| Type de contenu | Description | En savoir plus |
|---|---|---|
| TextMessage | Corps de texte de 3 072 caractères maximum, avec des suggestions facultatives. Contrairement à un message SMS, un message texte RCS peut inclure des suggestions et est diffusé sous la forme d'un message unique plutôt que d'être divisé en segments. | Envoi de SMS RCS |
| FileMessage | Un fichier multimédia unique (image, vidéo, audio ou PDF) référencé par une URL HTTPS ou Amazon S3. | Envoi de messages sous forme de fichier RCS |
| RichCard | Une carte structurée avec un support optionnel, un titre, une description et jusqu'à 4 suggestions. | Envoi de cartes RCS Rich |
| Carrousel | Un jeu défilant de 2 à 10 cartes, chacune avec ses propres médias, textes et suggestions. | Envoi de carrousels RCS |
Suggestions
Les suggestions sont des puces interactives que les destinataires choisissent pour effectuer une action. Vous pouvez ajouter des suggestions à n'importe quel type de contenu : les suggestions au niveau du message s'appliquent à l'ensemble du message (jusqu'à 11), et les suggestions au niveau de la carte s'appliquent à une carte riche ou à une carte carrousel individuelle (jusqu'à 4). AWSLa messagerie utilisateur final prend en charge six types de suggestions, notamment des réponses, des liens et des actions telles que le fait de composer un numéro de téléphone ou de partager une position. Pour obtenir la liste complète des types de suggestions, leurs paramètres et la procédure à suivre pour recevoir des suggestions, consultezConfiguration des suggestions RCS.
SendRcsMessage aperçu de la demande
La SendRcsMessage demande utilise les paramètres clés suivants.
| Paramètre | Obligatoire | Description |
|---|---|---|
DestinationPhoneNumber |
Oui | Le numéro de téléphone du destinataire au E.164 format, par exemple+12065550100. |
OriginationIdentity |
Oui | L'ID ou l'ARN d'un pool ou d'un agent AWS RCS à partir duquel envoyer. L'agent doit être à l'état Actif. |
RcsMessageContent |
Non | Le contenu du message. Contient un Content objet contenant exactement l'un des éléments TextMessage suivants :FileMessage,RichCard, ouCarousel, et une Suggestions liste de haut niveau facultative. |
FallbackConfiguration |
Non | Le message SMS ou MMS à envoyer si la livraison du RCS échoue. Comprend un élément obligatoire Channel (SMSouMMS)MessageBody, un facultatif MediaUrls pour les MMS et un OriginationIdentity numéro de téléphone ou un identifiant d'expéditeur. |
TimeToLive |
Non | Le délai en secondes avant l'expiration du message s'il n'est pas remis. Le minimum est de 1 seconde et le maximum de 172 800 secondes (48 heures). Une valeur de 10 secondes ou plus est recommandée. |
MessageFeedbackEnabled |
Non | Définissez sur true pour activer les commentaires relatifs au message. Lorsque le destinataire reçoit le message, mettez à jour le statut du message en appelant l'PutMessageFeedbackopération. |
Une réponse réussie renvoie un MessageId que vous utilisez pour corréler les événements relatifs à l'état de livraison.
Note
Fallback for SendRcsMessage est configuré par FallbackConfiguration message. Pour le comportement de repli complet, voirConfiguration de la solution de secours par SMS ou MMS par message.
Limites de taille et de nombre de messages
| Limite | Value |
|---|---|
| Corps du message texte | 3,072 caractères |
| Titre de la carte riche | 200 caractères |
| Description de la carte riche | 2 000 caractères |
| Taille du fichier multimédia | 100 Mo |
| Longueur de l'URL du média | 2 000 caractères |
| Suggestions par message | 11 |
| Suggestions par carte | 4 |
| Texte d'affichage de la suggestion | 25 personnages |
| Données de post-back | 2 048 caractères |
| Cartes de carrousel | 2 à 10 cartes |
| Time-to-live | 1 seconde à 172 800 secondes (48 heures) |
Pour connaître les limites et restrictions du RCS pour tous les types de contenu, voirLimites et restrictions relatives à la messagerie.
Événements de livraison et actions du destinataire
AWSLa messagerie destinée aux utilisateurs finaux génère des événements qui indiquent l'état de livraison des messages et les actions du destinataire, notamment les événements de remise, de lecture, d'échec, d'expiration et de post-retour. Un événement de post-back est généré lorsqu'un destinataire choisit une suggestion et inclut la PostbackData valeur. Acheminez ces événements vers une rubrique Amazon SNS, un flux de diffusion Amazon Data Firehose ou Amazon Logs. CloudWatch Pour en savoir plus, consultez Événements liés aux messages RCS.
Bonnes pratiques
Concevez des messages RCS riches sous forme d'expériences conversationnelles et interactives. Définissez une option TimeToLive pour les contenus urgents tels que les mots de passe à usage unique, configurez une solution de secours par SMS ou MMS pour les messages qui doivent parvenir au destinataire même si son appareil ne prend pas en charge le RCS, limitez les libellés de suggestion (la limite est de 25 caractères) et incluez des identifiants structurés PostbackData afin que votre application puisse acheminer les réponses sans recherches supplémentaires. Pour des conseils détaillés, voirBonnes pratiques du RCS.
