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. # Messagerie RCS Rich Communication Services (RCS) pour les entreprises dans le domaine de la messagerie destinée aux utilisateurs AWS finaux vous permet d'envoyer des messages texte vérifiés et personnalisés à des destinataires aux États-Unis d'Amérique et au Canada. Le RCS est la prochaine évolution du SMS, il ne s'agit pas d'un canal distinct. Les messages RCS sont envoyés à la même application de messagerie native que celle que les destinataires utilisent déjà pour les SMS, ce qui en fait une mise à niveau sur place plutôt qu'une nouvelle application à installer. Les identités de marque vérifiées inspirent confiance, encouragent les conversations et améliorent les résultats commerciaux. Lorsque la livraison RCS n'est pas possible, AWS la messagerie à l'utilisateur final peut automatiquement revenir aux SMS. **Topics** + [Qu'est-ce que le RCS ?](rcs-overview.md) + [Débuter avec RCS](rcs-getting-started.md) + [Gestion des agents RCS](rcs-agents.md) + [Tester les messages RCS](rcs-testing.md) + [Solution de repli entre RCS et SMS à l'aide de pools téléphoniques](rcs-sms-fallback.md) + [Envoi de messages RCS](rcs-send-message.md) + [Réception de messages RCS entrants](rcs-inbound.md) + [Lancement du RCS dans les pays](rcs-country-launch.md) + [CloudWatch Métriques et surveillance du RCS](rcs-monitoring.md) + [Modèle de facturation et de tarification RCS](rcs-billing.md) # Qu'est-ce que le RCS ? Les Rich Communication Services (RCS) pour les entreprises sont un protocole de messagerie qui améliore les SMS traditionnels avec une identité de marque vérifiée. Avec AWS la messagerie destinée aux utilisateurs finaux, vous pouvez envoyer des messages texte RCS à des destinataires aux États-Unis d'Amérique et au Canada, avec une solution de remplacement automatique pour les appareils ou les opérateurs qui ne prennent pas en charge le RCS. Les messages RCS apparaissent dans la même application de messagerie que celle utilisée par les destinataires pour les SMS, mais incluent le nom de marque, le logo et les couleurs vérifiés. Cela fait du RCS une mise à niveau sur place plutôt qu'un nouveau canal à adopter. Les clients utilisant l'`SendTextMessage`API peuvent commencer à utiliser RCS avec un minimum de modifications de code, voire aucune, et les utilisateurs finaux ne modifient pas leur flux de messagerie. Les identités vérifiées inspirent confiance, encouragent les conversations, améliorent les cas d'utilisation de la messagerie existants et ouvrent la voie à de nouveaux cas d'utilisation tels que les expériences conversationnelles. **Important** Google fait partie de la chaîne de diffusion des messages pour la diffusion de vos messages RCS. Par conséquent, votre utilisation du canal de messagerie RCS dans la messagerie destinée aux utilisateurs AWS finaux est également soumise aux [conditions d'utilisation de Google RCS for Business, qui incluent des](https://developers.google.com/business-communications/rcs-business-messaging/terms-and-policies/tos) informations sur la manière dont Google peut utiliser le contenu de vos messages RCS. **Topics** + [Principaux avantages du RCS](#rcs-overview-benefits) + [En quoi le RCS diffère du SMS](#rcs-overview-how-rcs-differs) + [Pourquoi la solution de secours par SMS est essentielle](#rcs-overview-sms-fallback) + [Fonctionnalités RCS prises en charge](#rcs-overview-phase1-scope) + [Comprendre le modèle d'identité à deux niveaux](#rcs-overview-identity-model) ## Principaux avantages du RCS La messagerie RCS via AWS la messagerie utilisateur final offre les avantages suivants par rapport aux SMS traditionnels : **Identité de marque vérifiée** Les messages RCS affichent le logo, le nom et les couleurs de votre marque à côté d'un badge vérifié sur les appareils Android. Les destinataires peuvent confirmer que le message provient de votre organisation, ce qui réduit le risque d'hameçonnage et améliore l'engagement. **Reçus de livraison (DLRs)** Le RCS fournit des reçus de livraison au niveau de l'appareil qui confirment qu'un message a été remis à l'appareil du destinataire. Contrairement aux SMS, où la confirmation de livraison provient du réseau du transporteur, le RCS émet un DLRs rapport directement depuis l'appareil, ce qui vous donne une meilleure assurance quant à la livraison effective. Cela est également lié à la facturation. Avec le RCS, vous ne payez que pour les messages dont la réception est confirmée sur l'appareil, tandis que les frais de SMS sont facturés lorsque le message est accepté par le transporteur. **Performances de messagerie améliorées** Les messages envoyés via RCS ont tendance à générer de meilleurs résultats commerciaux que les SMS, car l'identité de marque vérifiée accroît la confiance et l'engagement des destinataires. Bien que le RCS ne soit pas encore aussi universellement disponible que le SMS, le sous-ensemble de messages délivrés via RCS enregistre généralement des taux d'ouverture et des conversions plus élevés. Pour les destinataires dont les appareils ou les opérateurs ne prennent pas en charge le RCS, le remplacement automatique des SMS garantit que vos messages leur parviennent toujours. **Solution de secours automatique par SMS** Lorsque vous envoyez des messages via un pool téléphonique qui contient à la fois un agent AWS RCS et des numéros de téléphone SMS, AWS la messagerie utilisateur final revient automatiquement aux SMS si la livraison RCS n'est pas possible. Cela garantit que vos messages parviennent aux destinataires, quel que soit leur appareil ou leur opérateur compatible avec le RCS. ## En quoi le RCS diffère du SMS Le tableau suivant compare les fonctionnalités de messagerie RCS et SMS de la messagerie utilisateur AWS final. **RCS comparé au SMS** | Fonctionnalité | RCS | SMS | | --- | --- | --- | | Identité de marque | Nom de marque, logo, couleurs et badge vérifiés | Numéro de téléphone ou identifiant de l'expéditeur uniquement | | Confirmation de livraison | Reçus de livraison au niveau de l'appareil : l'appareil du destinataire rend compte directement, confirmant la livraison effective. Seules les livraisons confirmées vous sont facturées. | Confirmation au niveau de l'opérateur : le réseau de l'opérateur accuse réception, mais cela ne garantit pas que le message soit parvenu à l'appareil. Vous êtes facturé lorsque le transporteur accepte le message. | | Contenu des messages | SMS | Messages texte, MMS pour les médias | | Support de l'appareil | Appareils Android avec RCS activé, iPhone avec iOS 18 ou version ultérieure | Tous les appareils mobiles | | Pays pris en charge | États-Unis d'Amérique et Canada | Plus de 200 pays et régions | ## Pourquoi la solution de secours par SMS est essentielle Les appareils mobiles et les opérateurs ne sont pas tous compatibles avec le RCS. Par exemple, les anciens appareils Android, certains opérateurs et les iPhones exécutant des versions iOS antérieures à 18 ne peuvent pas recevoir de messages RCS. Dans la plupart des cas d'utilisation, vous avez besoin d'un moyen fiable pour atteindre tous les destinataires, quel que soit leur appareil ou leur opérateur. Les pools téléphoniques résolvent ce problème. Un pool est un conteneur d'identités de messagerie qui fournit une couche d'abstraction entre vos demandes d'API et vos identités d'origine. Au lieu d'intégrer une logique de sélection des numéros de secours par SMS dans votre application, vous ajoutez des agents RCS et des numéros de téléphone à un pool et AWS la messagerie utilisateur final s'occupe du reste. Cela vous donne trois avantages : + Solution de RCS-to-SMS repli facile sans vous soucier de savoir quels chiffres fonctionnent dans quel pays. Ajoutez vos identités à un pool et le service sélectionne automatiquement la bonne. + La logique de sélection des numéros et des agents reste indépendante du code de votre application et de easy-to-manage sa configuration. Vous pouvez ajouter ou supprimer des identités sans modifier votre intégration d'envoi. + Bien que simples à configurer, les pools permettent également de contrôler totalement la manière dont vous utilisez les numéros et les agents RCS ensemble, y compris les per-use-case pools pour un routage sécurisé en termes de conformité. Pour utiliser la solution de secours par SMS, créez un pool téléphonique contenant à la fois votre agent AWS RCS et un ou plusieurs numéros de téléphone SMS. Lorsque vous envoyez un message à l'aide du pool, le service de messagerie à l'utilisateur AWS final tente d'abord de le transmettre par RCS et revient automatiquement aux SMS si nécessaire. Nous recommandons l'envoi par pool pour tous les cas d'utilisation de la messagerie, et pas uniquement pour le RCS, car il permet d'ajouter ou de modifier des identités d'origine sans modifier le code de votre application. **Note** Si vous envoyez un message directement à un agent AWS RCS (sans utiliser de pool), la solution de secours par SMS n'est pas disponible. Utilisez l'envoi direct uniquement lorsque vous avez besoin d'une RCS-or-nothing livraison ou lorsque vous gérez une logique de repli en dehors de la messagerie destinée aux utilisateurs AWS finaux. ## Fonctionnalités RCS prises en charge Le lancement initial de RCS dans la messagerie à l'utilisateur AWS final prend en charge la messagerie texte uniquement aux États-Unis d'Amérique et au Canada. Vous pouvez envoyer et recevoir des messages RCS en texte brut à l'aide de la même `SendTextMessage` API que celle que vous utilisez pour les SMS. Le RCS dans AWS la messagerie utilisateur final prend actuellement en charge les éléments suivants : + Envoyer et recevoir des SMS via RCS + Identité de marque vérifiée (logo, nom, couleurs et badge vérifié) + Reçus de livraison (DLRs) + Solution de repli automatique des SMS avec envoi basé sur un pool + Messagerie bidirectionnelle (réception de messages texte RCS entrants) + Gestion des mots clés pour les réponses automatiques + CloudWatch métriques pour la surveillance des messages RCS + Lancements nationaux aux États-Unis d'Amérique et au Canada + Agents de test RCS pour les tests sans approbation du transporteur + Maquettes de téléphone dans la console pour prévisualiser la façon dont votre marque apparaît sur les appareils + Une ressource d'agent AWS RCS unique qui gère les inscriptions spécifiques à chaque pays pour les États-Unis et le Canada + Informations d'inscription partagées entre les pays, avec personnalisation par pays + Toutes les fonctionnalités de messagerie destinées aux utilisateurs AWS finaux, y compris les ensembles de configuration, les pools téléphoniques, les listes de désinscription et les mots clés **Note** Les agents de test RCS sont généralement créés et approuvés en quelques minutes, alors que les enregistrements de numéros de téléphone par SMS peuvent prendre des jours, voire des semaines. Cela vous permet de commencer à tester rapidement la messagerie RCS. ## Comprendre le modèle d'identité à deux niveaux Dans AWS la messagerie utilisateur final, le RCS utilise un modèle d'identité à deux niveaux : l'**agent AWS RCS** (un conteneur que vous créez et gérez) et un ou plusieurs **RCS for Business IDs** (identités d'agent par pays créées lors de l'enregistrement). Pour plus de détails sur le lien entre ces identités, y compris les états du cycle de vie et le tableau de comparaison, voir[Comprendre le modèle d'identité à deux niveaux](rcs-agents.md#rcs-agents-identity-model). # Débuter avec RCS Ce guide explique comment configurer votre premier agent RCS dans AWS la messagerie utilisateur final et comment envoyer et recevoir votre premier message RCS. À la fin, vous disposerez d'un environnement de test RCS fonctionnel. Durée estimée de réalisation : 15 à 30 minutes. Voici ce que couvre ce guide : 1. Créez un agent AWS RCS et soumettez un enregistrement de test 1. Ajoutez un appareil de test et acceptez l'invitation du testeur 1. Envoyez votre premier message RCS sortant 1. Testez la messagerie entrante (bidirectionnelle) à l'aide de mots clés Pour plus d'informations sur le fonctionnement de RCS dans AWS la messagerie utilisateur final, y compris le modèle d'identité à deux niveaux (AWS RCS Agent et RCS for Business IDs), consultez. [Qu'est-ce que le RCS ?](rcs-overview.md) ## Configuration et test du RCS Cette section vous explique comment créer un agent AWS RCS, enregistrer un appareil de test, envoyer votre premier message RCS et vérifier la livraison. Une fois ces étapes terminées, vous pouvez lancer RCS dans les pays de production. ### Conditions préalables Avant de commencer, assurez-vous de disposer des éléments suivants : + **Un AWS compte avec accès à la messagerie utilisateur AWS final** : vous avez besoin d'un AWS compte autorisé pour utiliser AWS la messagerie utilisateur final. Si vous n'avez pas de compte, consultez le [guide de configuration du AWS compte](https://docs.aws.amazon.com/accounts/latest/reference/welcome-first-time-user.html). + **Un téléphone avec RCS activé** — Vous avez besoin d'un téléphone Android avec la messagerie RCS activée dans l'application de messagerie par défaut, ou d'un iPhone exécutant iOS 18 ou version ultérieure. Ce téléphone sert d'appareil de test pour recevoir des messages RCS. + **(Facultatif) AWS CLI configurée** — Si vous souhaitez tester à l'aide de l'API plutôt que de la console, installez et configurez la AWS CLI ou utilisez un AWS SDK tel que boto3 pour Python. ### Étape 1 : créer votre agent AWS RCS et soumettre un enregistrement de test La première étape consiste à créer un agent AWS RCS et à soumettre un enregistrement de test. L'enregistrement des tests crée un identifiant RCS for Business (agent de test) que vous pouvez utiliser pour envoyer des messages aux appareils de test enregistrés sans l'approbation du transporteur. Pour plus de détails sur la gestion des agents AWS RCS, notamment le cycle de vie des agents et les opérations des API, consultez[Gestion des agents RCS](rcs-agents.md). #### Création d'un agent AWS RCS (console) **Pour créer un agent AWS RCS et soumettre un enregistrement de test** 1. Ouvrez la [console de messagerie de l'utilisateur AWS final](https://console.aws.amazon.com/sms-voice/home). 1. Dans le volet de navigation, sous **Configurations**, choisissez les **agents RCS**. 1. Choisissez **Create RCS Agent.** Cela crée un agent AWS RCS, puis vous guide immédiatement tout au long de la création d'un enregistrement de test dans un flux de travail unique. 1. L'écran suivant présente une introduction au RCS et explique le processus de configuration. Vérifiez les informations et choisissez **Next** pour continuer. 1. Sur la page de **détails de l'agent**, définissez les paramètres suivants : + **Nom convivial** : étiquette réservée à la console pour votre agent AWS RCS. Il s'agit d'un nom interne destiné à votre référence (stocké sous forme de tag) et n'est pas le nom affiché sur les téléphones des destinataires. Le nom convivial n'est pas disponible via l'API. + **Protection contre la suppression** : (Facultatif) Activez cette option pour empêcher la suppression accidentelle de l'agent. + **Balises** — (Facultatif) Ajoutez des balises pour organiser et identifier votre agent. 1. Dans la section **Informations sur la marque** de la même page, entrez les informations suivantes : + **Nom d'affichage : nom** de marque que les destinataires voient à côté de vos messages RCS. + **Description** — Brève description de votre marque ou de votre entreprise. + **Cas d'utilisation** : sélectionnez le cas d'utilisation principal de votre messagerie RCS (par exemple, les notifications transactionnelles, le marketing ou le support client). 1. Dans la section **Ressources de la marque** de la même page, téléchargez les éléments suivants : + **Logo** — 224 × 224 pixels, PNG avec transparence, moins de 50 Ko. + **Image de bannière** — 1440 × 448 pixels, PNG ou JPEG, moins de 200 Ko. + **Couleur de marque** : code couleur hexadécimal (par exemple,`#1A73E8`) avec un rapport de contraste minimum de 4, 5:1 sur fond blanc. **Important** Certains actifs de marque ne peuvent pas être modifiés une fois que l'agent a été soumis à l'enregistrement. Préparez les actifs finaux de votre marque avant de créer l'agent. Si vous souhaitez d'abord expérimenter, vous pouvez créer rapidement un agent de test à l'aide de ce flux, puis créer un nouvel agent AWS RCS avec les actifs de marque finalisés ultérieurement. 1. Sur la page des **mots clés de conformité**, configurez vos mots clés et vos messages de réponse automatique. 1. Sur la page de **révision**, vérifiez tous vos paramètres. 1. Choisissez **Valider et envoyer** pour créer l'agent AWS RCS et soumettre l'enregistrement des tests. **Note** Vous avez créé avec succès un agent AWS RCS et soumis un enregistrement de test. Votre agent de test est généralement approuvé en quelques minutes. Nous allons maintenant activer la messagerie de test sur votre appareil. #### Création d'un agent AWS RCS (CLI) Vous pouvez également créer un agent AWS RCS à l'aide de la AWS CLI. Créez d'abord l'agent, puis soumettez un enregistrement de test. Étape 1 : créer l'agent AWS RCS : ``` aws pinpoint-sms-voice-v2 create-rcs-agent \ --deletion-protection-enabled ``` Étape 2 : Soumettez un enregistrement de test pour l'agent. Utilisez l'`CreateRegistration`API avec le type d'enregistrement pour les tests RCS. Vous pouvez utiliser l'`DescribeRegistrationFieldDefinitions`API pour récupérer par programmation tous les champs du formulaire d'inscription disponibles avant de le soumettre. Indiquez les actifs, la description et les coordonnées de votre marque dans les champs du formulaire d'inscription. Pour plus de détails sur l'API d'enregistrement, consultez[Gestion des agents RCS](rcs-agents.md). ### Étape 2 : Ajouter un appareil de test Une fois votre inscription au test approuvée, ajoutez votre téléphone comme appareil de test afin de recevoir les messages RCS de votre agent de test. **Note** Après avoir ajouté un appareil de test, l'invitation au testeur n'est pas envoyée immédiatement. Le système retarde l'activation d'au moins 120 secondes et l'arrivée de l'invitation peut prendre jusqu'à 20 minutes. La console indique une heure d'activation approximative. Il n'est pas nécessaire d'attendre avant d'ajouter l'appareil : le système gère le délai automatiquement. ------ #### [ Console ] **Pour ajouter un appareil de test** 1. Dans la console de messagerie utilisateur AWS final, accédez à votre agent AWS RCS et choisissez l'onglet **Testing**. 1. Choisissez **Ajouter un appareil de test**. 1. Entrez le numéro de téléphone de votre appareil de test au format E.164 (par exemple,`+12065550100`). 1. Choisissez **Ajouter**. ------ #### [ AWS CLI ] Utilisez l'`CreateVerifiedDestinationNumber`API avec le `--rcs-agent-id` paramètre pour enregistrer un appareil de test pour votre agent AWS RCS : ``` aws pinpoint-sms-voice-v2 create-verified-destination-number \ --destination-phone-number +12065550100 \ --rcs-agent-id rcs-a1b2c3d4 ``` ------ Après avoir ajouté l'appareil de test, la messagerie de l'utilisateur AWS final envoie une invitation au testeur au numéro de téléphone. **L'invitation provient d'un agent RCS appelé **RBM Tester Management** et contient deux boutons permettant d'accepter ou de refuser : **Make me a tester** et Refuser.** Le destinataire doit appuyer sur **Faire de moi un testeur** pour terminer la vérification. **Note** Sur les appareils iOS (iPhone doté d'iOS 18 ou version ultérieure), l'invitation du testeur peut apparaître dans le dossier **Expéditeurs inconnus** de l'application Messages plutôt que dans la boîte de réception principale. Si vous ne voyez pas l'invitation, consultez le dossier Expéditeurs inconnus. Pour plus de détails sur la gestion des appareils de test, y compris l'approche de l'API et le dépannage, consultez[Tester les messages RCS](rcs-testing.md). ### Étape 3 : Envoyez votre premier message RCS Une fois que votre appareil de test a accepté l'invitation du testeur, vous pouvez envoyer votre premier message RCS. Vous pouvez utiliser la console de messagerie utilisateur AWS final ou l'API. ------ #### [ Console ] **Pour envoyer un message de test à l'aide de la console** 1. Dans la console de messagerie utilisateur AWS final, accédez à votre agent AWS RCS et choisissez l'onglet **Testing**. 1. Choisissez **Messages de test sortants**. La console affiche un aperçu du rendu de votre message sur l'appareil du destinataire, ainsi que le corps de la requête JSON et la commande CLI. 1. Choisissez un appareil de test vérifié dans la liste. 1. Entrez le texte de votre message. 1. Choisissez **Envoyer un message de test**. **Note** Vous pouvez éventuellement définir un ensemble de configuration pour les événements liés aux messages. Les ensembles de configuration vous permettent de consommer des reçus de livraison DLRs détaillés () et d'autres messages dans la destination de votre choix. Ceci est facultatif pour les tests mais recommandé pour une utilisation en production. Pour en savoir plus, consultez [CloudWatch Métriques et surveillance du RCS](rcs-monitoring.md). ------ #### [ AWS CLI ] Utilisez la `send-text-message` commande pour envoyer un message de test. Spécifiez l'ARN de votre agent AWS RCS comme identité d'origine : ``` aws pinpoint-sms-voice-v2 send-text-message \ --destination-phone-number +12065550100 \ --origination-identity arn:aws:sms-voice:us-east-1:123456789012:rcs-agent/rcs-a1b2c3d4 \ --message-body "Hello from RCS! This is my first test message." ``` La `send-text-message` commande est la même que celle que vous utilisez pour les SMS. Lorsque vous spécifiez un ARN d'agent AWS RCS comme identité d'origine, la messagerie destinée à l'utilisateur AWS final transmet le message via RCS. ------ ### Étape 4 : Tester la messagerie entrante (bidirectionnelle) Vous pouvez tester la messagerie RCS entrante en configurant un mot clé avec une réponse automatique, puis en envoyant un message correspondant à ce mot clé depuis votre appareil de test. **Pour tester la messagerie entrante avec des mots clés de réponse automatique** 1. Dans la console de messagerie utilisateur AWS final, accédez à votre agent AWS RCS et configurez un mot clé. Par exemple, définissez le mot clé `RCSINBOUNDTESTING` avec un message de réponse automatique tel que « Test entrant réussi \$1 Votre message a bien été reçu. » 1. Dans l'onglet **Testing**, choisissez **Inbound deep link**. 1. Dans le champ **Corps du message par défaut**, entrez le mot clé que vous avez configuré (par exemple,`RCSINBOUNDTESTING`). 1. Choisissez **Générer le lien**. La console génère une URL de lien profond entrant à l'aide du schéma d'`sms:`URI standard de la GSMA. Ce lien profond est intégré dans le code QR affiché à l'écran. 1. Scannez le code QR avec votre téléphone testeur vérifié. Cela ouvre l'application de messagerie native avec un message prérempli adressé à votre agent AWS RCS. 1. Envoyez le message depuis votre appareil de test. 1. Vérifiez que vous recevez le message de réponse automatique sur votre appareil de test. Pour tester les mots clés de réponse automatique, il n'est pas nécessaire de configurer une destination d'événement ou une rubrique Amazon SNS. La réponse automatique est entièrement gérée par AWS la messagerie de l'utilisateur final en fonction de la configuration des mots clés sur votre agent AWS RCS. Pour recevoir et traiter des messages entrants arbitraires (et pas uniquement des correspondances de mots clés), vous devez configurer une rubrique Amazon SNS pour la messagerie bidirectionnelle. Pour en savoir plus, consultez [Réception de messages RCS entrants](rcs-inbound.md). ### Ce que tu as accompli En suivant les étapes décrites dans ce guide, vous avez : + Vous avez créé un agent AWS RCS avec les actifs de votre marque et soumis un enregistrement de test + J'ai enregistré un appareil de test et j'ai accepté l'invitation du testeur + Vous avez envoyé votre premier message RCS et vérifié la livraison + Messagerie entrante testée à l'aide de mots clés à réponse automatique Votre environnement de test est maintenant prêt. Voici comment intégrer la messagerie RCS dans votre application ou affiner le fonctionnement de la messagerie RCS : + **Recevoir et traiter les messages entrants** : configurez une rubrique Amazon SNS pour recevoir les messages RCS entrants et les traiter à l'aide des fonctions Lambda. Consultez [Réception de messages RCS entrants](rcs-inbound.md). + **Suivi des événements de livraison** : configurez des ensembles de configuration pour utiliser des reçus de livraison détaillés (DLRs) et d'autres événements liés aux messages dans la destination de l'événement de votre choix. Consultez [CloudWatch Métriques et surveillance du RCS](rcs-monitoring.md). + **Activez le remplacement par SMS** : créez un pool téléphonique avec votre agent AWS RCS et vos numéros de téléphone SMS pour revenir automatiquement aux SMS lorsque la livraison RCS n'est pas possible. Consultez [Solution de repli entre RCS et SMS à l'aide de pools téléphoniques](rcs-sms-fallback.md). + **Lancement dans les pays de production** : Soumettez les inscriptions de lancement par pays pour envoyer des messages RCS à tous les destinataires aux États-Unis d'Amérique et au Canada. Consultez [Lancement du RCS dans les pays](rcs-country-launch.md). ## Invite un agent AI pour la configuration du RCS Si vous utilisez un assistant de codage IA génératif ou un agent d'IA, vous pouvez utiliser l'invite suivante pour obtenir de l'aide pour créer un agent AWS RCS, soumettre un enregistrement de test et envoyer votre premier message de test à l'aide de la AWS CLI. **Note** Copiez l'invite suivante et collez-la dans votre agent AI ou votre assistant de codage : ``` ## RCS Setup Assistant Prompt Help me set up RCS messaging in AWS End User Messaging using the AWS CLI. The service is `pinpoint-sms-voice-v2`. Walk me through each step with exact CLI commands. Ask me for all required details before generating any commands. **Important rules for generating commands:** - All commands use the `pinpoint-sms-voice-v2` service. - Use `create-rcs-agent` exactly as spelled — NOT `create-r-c-s-agent`. - Use the term "testing" — NOT "sandbox". - There is NO `describe-messages` API. Do not generate it. - `create-rcs-agent` does NOT accept brand asset parameters (no display name, no logo, no banner, no color). Brand assets are registration fields only. - `create-verified-destination-number` uses `--rcs-agent-id`, NOT `--origination-identity`. ### Step 1: Create an RCS Agent Use `create-rcs-agent`. This creates the agent resource only. Optional parameters: `--deletion-protection-enabled`, `--opt-out-list-name`, `--tags`. The response returns `RcsAgentId` and `RcsAgentArn` — save both. ### Step 2: Create and submit a testing registration This configures brand assets and submits for approval. It requires multiple API calls in sequence: a. `create-registration --registration-type TEST_RCS_LAUNCH_REGISTRATION` → returns `RegistrationId`. Save it. b. `create-registration-association --registration-id --resource-id ` → links the registration to the agent. c. Upload images as attachments (two calls): `create-registration-attachment --attachment-body fileb://` `create-registration-attachment --attachment-body fileb://` → each returns `RegistrationAttachmentId`. Save both. d. Set ALL required registration fields using `put-registration-field-value` with `--registration-id`, `--field-path`, and the appropriate value flag (`--text-value`, `--select-choices`, or `--registration-attachment-id`). Required fields (ALL must be set or registration will be DENIED): - `agentDetails.brandName` (text, 2-65 chars) - `agentDetails.serviceName` (text, 1-100 chars) - `agentDetails.senderDisplayName` (text, 1-40 chars) - `agentDetails.useCase` (select: OTP, TRANSACTIONAL, PROMOTIONAL, MULTI_USE) - `agentDetails.agentDescription` (text, 1-100 chars) - `agentDetails.logoImage` (attachment ID from step c, 224x224 PNG) - `agentDetails.bannerImage` (attachment ID from step c, 1440x448 PNG/JPEG) - `agentDetails.accentColor` (text, hex code e.g. #0066CC) - `agentDetails.privacyPolicyUrl` (text, valid URL) - `agentDetails.termsAndConditionsUrl` (text, valid URL) - `agentDetails.averageMonthlyRcsFrequency` (select: 10, 100, 1000+) - `agentDetails.monthlyRcsVolume` (text, 1-100000) - At least ONE contact method WITH its label: agentDetails.contactWebsite + agentDetails.contactWebsiteLabel, OR agentDetails.contactPhoneNumber + agentDetails.contactPhoneLabel, OR agentDetails.contactEmailAddress + agentDetails.contactEmailLabel e. Verify all fields: `describe-registration-field-values --registration-id ` Any field showing `DeniedReason: MISSING_REQUIRED_FIELD` must be set. f. Submit: `submit-registration-version --registration-id ` g. Poll status: `describe-registrations --registration-ids ` Wait for `RegistrationStatus: COMPLETE`. **Error recovery:** If registration is DENIED, you must: 1. `create-registration-version --registration-id ` (creates new draft) 2. Re-populate ALL fields from scratch (new versions do NOT inherit values) 3. Fix the issue noted in `DeniedReasons` 4. Re-submit ### Step 3: Add a test device **Prerequisite:** Step 2 must be COMPLETE and the agent's `TestingAgent.Status` must be `ACTIVE` (check with `describe-rcs-agents`). Then wait at least 120 seconds after the agent becomes ACTIVE. Use `create-verified-destination-number --destination-phone-number --rcs-agent-id `. The device status will be `PENDING`. The user must accept the RCS tester invitation on their physical device. Check status with `describe-verified-destination-numbers` — wait for `VERIFIED`. ### Step 4: Send a test RCS message **Prerequisite:** Step 3 device must be `VERIFIED`. Use `send-text-message --destination-phone-number --origination-identity --message-body "" --message-type TRANSACTIONAL`. Returns `MessageId`. ### Step 5: Verify delivery For testing: check the test device — the message appears from the branded RCS agent. For production monitoring: set up event destinations BEFORE sending messages using `create-event-destination` (SNS, CloudWatch Logs, or Firehose). Event destinations do not retroactively capture events for already-sent messages. CloudWatch metrics in the `AWS/SMSVoice` namespace provide aggregate stats. --- **Before generating commands, ask me for:** - Brand name, service name, and sender display name - Agent description (what the agent does, what messages users receive) - Use case type: OTP, TRANSACTIONAL, PROMOTIONAL, or MULTI_USE - Logo file path (224x224 PNG) and banner file path (1440x448 PNG/JPEG) - Brand accent color hex code (e.g. #0066CC) - Privacy policy URL and terms & conditions URL - One contact method with label: website URL, phone number, or email - Estimated monthly RCS volume and per-user message frequency - Test device phone number in E.164 format (e.g. +12065550100) ``` # Gestion des agents RCS Un agent AWS RCS est la ressource de premier niveau en matière de messagerie utilisateur AWS final qui représente votre marque en matière de messagerie RCS. Il constitue une ressource unifiée qui relie votre agent de test et les agents de lancement nationaux (RCS for Business IDs). Les mots clés et la configuration de la messagerie bidirectionnelle sont définis sur l'agent AWS RCS. Les actifs de la marque sont définis lors de chaque enregistrement (agent de test ou agent de lancement dans le pays). Pour un aperçu de la relation entre l'agent AWS RCS et RCS for Business IDs, consultez. [Qu'est-ce que le RCS ?](rcs-overview.md) L'agent AWS RCS suit le cycle de vie suivant : 1. **Créez** l'agent AWS RCS. 1. **Ajoutez un agent de test** (inclus dans le flux de création de la console ; facultatif via la CLI). 1. **Testez** votre messagerie RCS avec des appareils de test enregistrés. Aucune approbation du transporteur n'est requise pour les tests. 1. **Soumettez un enregistrement de lancement par pays** pour chaque pays dans lequel vous souhaitez envoyer des messages RCS de production. 1. **Approuvé partiellement** : au moins un transporteur a approuvé votre agent. Vous pouvez commencer à envoyer aux destinataires via des transporteurs agréés. 1. **Entièrement approuvé** : tous les transporteurs du pays ont approuvé votre agent. Une portée totale dans ce pays. Un agent AWS RCS correspond à un agent de test (un RCS for Business ID) et à plusieurs agents de lancement nationaux (un RCS for Business ID par pays). Lorsque vous créez un agent AWS RCS dans la console, le flux de travail vous guide immédiatement pour créer un agent de test. La configuration de marque de l'agent de test est ensuite utilisée pour préremplir les formulaires d'enregistrement du lancement par pays, réduisant ainsi la duplication des saisies de données. **Topics** + [Comprendre l'agent AWS RCS](#rcs-agents-concept) + [Comprendre le modèle d'identité à deux niveaux](#rcs-agents-identity-model) + [Création d'un agent AWS RCS](#rcs-agents-create) + [Mise à jour d'un agent AWS RCS](#rcs-agents-update) + [Affichage des agents AWS RCS](#rcs-agents-view) + [Révision de votre agent de test](#rcs-agents-review-test-agent) + [Afficher le statut de lancement par pays](#rcs-agents-country-launch-status) + [Supprimer un agent AWS RCS](#rcs-agents-delete) ## Comprendre l'agent AWS RCS L'agent AWS RCS est distinct du RCS for Business IDs qu'il gère. Le tableau suivant récapitule les différences : **Comparaison entre l'agent AWS RCS et le RCS for Business ID** | Attribut | Agent AWS RCS | RCS pour Business ID | | --- | --- | --- | | Géré par | Vous, par le biais de la console ou de l'API de messagerie utilisateur AWS final | AWS Messagerie à l'utilisateur final, pendant le processus d'inscription | | Scope | Un par marque ou par cas d'utilisation | Un lancement par pays, plus un agent de test | | Configuration | Nom convivial, protection contre la suppression, liste de désinscription, tags, mots clés, destination de messagerie bidirectionnelle | Ressources de marque et autres paramètres définis lors de l'enregistrement | | Identifiant | Format de rcs-a1b2c3d4 | Géré en interne par le fournisseur d'infrastructure RCS | ### ID et ARN de l'agent Chaque agent AWS RCS possède un identifiant unique au format `rcs-a1b2c3d4` (le préfixe `rcs-` suivi d'une chaîne hexadécimale). Vous utilisez cet identifiant lorsque vous appelez des opérations d'API telles que `UpdateRcsAgent` et`DeleteRcsAgent`. Chaque agent AWS RCS possède également un ARN de AWS ressource au format suivant : ``` arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id ``` Vous pouvez utiliser l'ARN lorsque vous spécifiez l'agent AWS RCS comme identité d'origine dans l'`SendTextMessage`API ou lorsque vous ajoutez l'agent à un pool téléphonique. ### États de cycle de vie Un agent AWS RCS passe par les états de cycle de vie suivants : **CRÉÉ** La ressource AWS RCS Agent a été créée dans AWS la messagerie destinée aux utilisateurs finaux, mais aucune inscription n'a encore été soumise. Vous pouvez mettre à jour les actifs et la configuration de la marque dans cet état. **EN SUSPENS** Une inscription a été soumise et est en attente de traitement. L'agent n'est pas encore disponible pour envoyer des messages. **TEST** L'enregistrement des tests a été approuvé. L'agent dispose d'un agent de test (RCS for Business ID) et peut envoyer des messages aux appareils de test enregistrés. Aucun enregistrement de lancement par pays n'a été effectué. **PARTIEL** L'enregistrement des lancements dans au moins un pays a été effectué, mais les lancements des pays soumis ne sont pas tous actifs. L'agent peut envoyer des messages dans les pays où il a été approuvé, mais uniquement aux destinataires du ou des transporteurs spécifiques qui ont approuvé l'agent. `CountryStatus`Pour un pays, on passe à PARTIAL dès qu'au moins un transporteur est actif dans ce pays. **ACTIF** Toutes les inscriptions de lancement par pays soumises sont complètes et actives. L'agent est pleinement opérationnel dans tous les pays enregistrés. Notez qu'un agent ACTIF peut revenir au statut PARTIEL lorsqu'un enregistrement de lancement dans un nouveau pays est soumis, car le nouveau pays n'est pas encore approuvé. **SUPPRIMÉ** L'agent AWS RCS a été supprimé. Tous les RCS for Business associés IDs (agents de test et de lancement par pays) sont désactivés. Cette action ne peut pas être annulée. ## Comprendre le modèle d'identité à deux niveaux Dans AWS la messagerie utilisateur final, le RCS utilise un modèle d'identité à deux niveaux : l'**agent AWS RCS** et un ou plusieurs **RCS** for Business. IDs **Agent AWS RCS** L'agent AWS RCS est la ressource de premier niveau que vous créez et gérez dans la messagerie destinée aux utilisateurs AWS finaux. Il constitue une ressource unifiée qui relie votre agent de test et les agents de lancement de votre pays. Les mots clés et la configuration de la messagerie bidirectionnelle sont définis sur l'agent AWS RCS. Les actifs de la marque sont définis lors de chaque enregistrement. Chaque agent AWS RCS possède un identifiant unique au format `rcs-a1b2c3d4` et un ARN de AWS ressource. Considérez l'agent AWS RCS comme l'identité unifiée de votre marque dans tous les pays où vous lancez RCS. **RCS pour Business ID** Un RCS for Business ID est l'identité d'agent par pays créée auprès du fournisseur d'infrastructure RCS au cours du processus d'enregistrement. Chaque lancement par pays crée un identifiant RCS for Business distinct sous votre agent AWS RCS. Vous ne gérez pas IDs directement RCS for Business. AWS La messagerie destinée aux utilisateurs finaux gère la création et le cycle de vie dans le cadre du processus d'enregistrement. Un agent AWS RCS peut disposer du RCS for Business suivant : IDs + **Un agent de test** : un identifiant RCS for Business créé lors de la phase d'enregistrement des tests. L'agent de test fonctionne avec les appareils de test enregistrés et vous permet de valider votre intégration RCS avant le lancement en production. Les messages de test sont facturés au tarif standard. + **Agents de lancement dans plusieurs pays** — Chaque pays dans lequel vous lancez RCS crée un RCS pour Business ID distinct. Par exemple, si vous lancez à la fois aux États-Unis d'Amérique et au Canada, votre agent AWS RCS dispose de deux agents de lancement nationaux (un RCS américain pour Business ID et un RCS pour Business ID du Canada) en plus de l'agent de test. Le schéma suivant montre la relation entre ces identités : ``` AWS RCS Agent (rcs-a1b2c3d4) ├── Testing agent (RCS for Business ID) ├── US country launch agent (US RCS for Business ID) └── CA country launch agent (Canada RCS for Business ID) ``` Les mots clés et les destinations de messagerie bidirectionnelle sont configurés sur l'agent AWS RCS et s'appliquent à tous les RCS for Business associés. IDs Les actifs de marque sont spécifiques à chaque enregistrement (agent de test ou agent de lancement dans le pays). L'agent AWS RCS contient également des paramètres au niveau du compte tels que le nom convivial, la protection contre la suppression et la liste de désinscription. ## Création d'un agent AWS RCS Vous pouvez créer un agent AWS RCS à l'aide de la console de messagerie utilisateur AWS final ou de l'`CreateRcsAgent`API. Lorsque vous créez un agent, vous fournissez un nom convivial dans la console (une étiquette réservée à la console stockée sous forme de balise, non visible via l'API ou affichée sur les téléphones des destinataires) et vous configurez des paramètres facultatifs tels que la protection contre la suppression et l'association de listes de désinscription. Les actifs de marque sont définis lors de l'enregistrement, et non sur l'agent AWS RCS lui-même. ### Exigences relatives aux actifs de marque Les actifs de votre marque sont présentés aux destinataires à côté de vos messages RCS. Les actifs de marque sont soumis dans le cadre de l'enregistrement des tests, que la console présente comme une continuation du flux de travail de création d'agents. Les ressources suivantes sont requises lors de la création d'un agent AWS RCS : **Logo** Une image carrée qui représente votre marque. Le logo apparaît dans l'application de messagerie à côté de vos messages. + Dimensions : 224 × 224 pixels + Format : PNG avec transparence + Taille maximale de fichier : 50 Ko **Image de bannière** Une image large qui apparaît en haut du profil de votre agent dans l'application de messagerie. L'image de la bannière n'est affichée que sur les appareils Android. + Dimensions : 1440 × 448 pixels + Format : PNG ou JPEG + Taille maximale du fichier : 200 Ko **Couleur de la marque** Un code couleur hexadécimal (par exemple,`#1A73E8`) utilisé comme couleur d'accent dans l'application de messagerie. La couleur doit avoir un rapport de contraste minimum de 4, 5:1 sur fond blanc pour répondre aux exigences d'accessibilité. Si le rapport de contraste n'est pas réglé correctement, votre agent risque de ne pas être approuvé. **Important** Les actifs de marque sont soumis à des limites de modification après la création de l'agent. Certains actifs de marque ne peuvent pas être modifiés une fois que l'agent a été soumis pour enregistrement. Préparez les actifs finaux de votre marque avant de créer votre agent AWS RCS. ------ #### [ Console ] La console de messagerie utilisateur AWS final présente la création d'agents AWS RCS et les tests d'enregistrement sous la forme d'un flux de travail guidé unique. Pour les instructions relatives à la step-by-step console, voir[Étape 1 : créer votre agent AWS RCS et soumettre un enregistrement de test](rcs-getting-started.md#rcs-getting-started-create-agent). ------ #### [ AWS CLI ] Utilisez la `create-rcs-agent` commande pour créer un agent AWS RCS. Les actifs de marque (nom d'affichage, description, logo, bannière et couleur de la marque) ne sont pas des paramètres de cette commande. Ils sont soumis en tant que champs d'enregistrement lorsque vous créez un enregistrement de test. ``` aws pinpoint-sms-voice-v2 create-rcs-agent \ --deletion-protection-enabled ``` Les paramètres facultatifs suivants sont disponibles : + `--deletion-protection-enabled`— Empêche la suppression de l'agent tant que la protection contre la suppression n'est pas désactivée. + `--opt-out-list-name`— Associe une liste de désinscription existante à l'agent. + `--tags`— Des paires clé-valeur pour organiser et identifier votre agent AWS RCS. ------ ## Mise à jour d'un agent AWS RCS Utilisez l'`UpdateRcsAgent`API pour modifier les paramètres d'un agent AWS RCS existant. Vous pouvez mettre à jour les paramètres suivants : + **Protection contre la suppression** : active ou désactive la protection contre la suppression pour l'agent. + **Liste de désinscription** : associez ou dissociez une liste de désinscription à l'agent. + **Destination de messagerie bidirectionnelle** : configurez la rubrique Amazon SNS et le rôle IAM dans lesquels les messages entrants sont remis. La messagerie bidirectionnelle est toujours activée pour RCS. Les clients sont facturés pour tous les messages RCS entrants au tarif standard. Ce paramètre contrôle l'endroit où les messages entrants sont remis, et non leur réception. **Note** Les modifications apportées aux paramètres de votre agent AWS RCS via l'API sont disponibles immédiatement. Cependant, les mises à jour des actifs de la marque (champs d'enregistrement tels que le logo, la bannière et le nom d'affichage) sont examinées par le fournisseur d'infrastructure RCS et peuvent mettre du temps à apparaître sur les appareils des destinataires. Pour vérifier que les modifications apportées à votre API ont été appliquées, utilisez l'`DescribeRcsAgents`API pour confirmer la configuration actuelle de l'agent dans AWS la messagerie utilisateur final. ## Affichage des agents AWS RCS Vous pouvez consulter vos agents AWS RCS à l'aide de la console de messagerie utilisateur AWS final ou de l'`DescribeRcsAgents`API. ------ #### [ Console ] Pour afficher vos agents AWS RCS dans la console, accédez à la page des **agents RCS** sous **Configurations** dans le volet de navigation. La page de liste affiche tous les agents AWS RCS de votre compte, y compris leur état de cycle de vie actuel, leur ID d'agent et leur nom d'affichage. Choisissez un agent pour consulter ses informations, notamment les actifs de la marque, les paramètres de configuration et les inscriptions associées. ------ #### [ AWS CLI ] Utilisez la `describe-rcs-agents` commande pour répertorier tous les agents AWS RCS de votre compte : ``` aws pinpoint-sms-voice-v2 describe-rcs-agents ``` Pour récupérer les informations relatives à un agent spécifique, utilisez le `--rcs-agent-ids` paramètre : ``` aws pinpoint-sms-voice-v2 describe-rcs-agents \ --rcs-agent-ids rcs-a1b2c3d4 ``` ------ ## Révision de votre agent de test Avant de soumettre l'enregistrement d'un lancement par pays, vérifiez la configuration de votre agent de test pour vous assurer que les actifs de votre marque, vos mots clés et vos paramètres de messagerie sont corrects. L'agent de test sert de modèle pour les inscriptions aux lancements par pays. Tout problème doit donc être résolu avant de poursuivre. Pour consulter votre agent de test, accédez à votre agent AWS RCS dans la console de messagerie utilisateur AWS final et choisissez l'onglet **Inscriptions**. L'enregistrement du test montre la configuration actuelle de votre marque, y compris le logo, l'image de bannière, la couleur de la marque et le nom d'affichage tels qu'ils apparaissent sur les appareils des destinataires. Vous pouvez également utiliser l'`DescribeRegistrationFieldValues`API pour récupérer les valeurs de champ actuelles pour votre inscription aux tests par programmation. ## Afficher le statut de lancement par pays Après avoir soumis un enregistrement de lancement par pays pour votre agent AWS RCS, vous pouvez suivre le statut d'approbation de chaque opérateur dans ce pays. ------ #### [ Console ] Pour consulter l'état de lancement par pays dans la console, accédez à la page de détails de votre agent AWS RCS et choisissez l'onglet **État de lancement par pays**. Cet onglet affiche le statut d'approbation de chaque opérateur dans chaque pays où vous avez soumis un enregistrement de lancement. ------ #### [ AWS CLI ] Utilisez la `describe-rcs-agent-country-launch-status` commande pour récupérer l'état de lancement par opérateur : ``` aws pinpoint-sms-voice-v2 describe-rcs-agent-country-launch-status \ --rcs-agent-id rcs-a1b2c3d4 ``` La réponse inclut le statut d'approbation de chaque opérateur dans chaque pays où vous avez soumis un enregistrement de lancement. ------ Chaque transporteur examine et approuve votre agent de manière indépendante. Votre agent AWS RCS peut envoyer des messages dans un pays dès qu'au moins un opérateur de ce pays a approuvé l'agent. Vous n'avez pas besoin d'attendre l'approbation de tous les opérateurs pour commencer à envoyer des messages RCS. Au fur et à mesure que d'autres transporteurs approuvent votre agent, votre portée dans ce pays augmente. **Note** Vous pouvez demander des lancements dans d'autres pays depuis l'écran d'état des lancements par pays. Chaque lancement dans un nouveau pays crée un enregistrement distinct et passe par son propre processus d'approbation par le transporteur. ## Supprimer un agent AWS RCS Utilisez l'`DeleteRcsAgent`API pour supprimer définitivement un agent AWS RCS. Lorsque vous supprimez un agent, tous les RCS for Business associés IDs (y compris l'agent de test et les agents de lancement de tous les pays) sont désactivés. **Avertissement** La suppression d'un agent AWS RCS est définitive et ne peut pas être annulée. Tous les enregistrements, les lancements par pays et les configurations de test associés à l'agent sont perdus. Avant de pouvoir supprimer un agent AWS RCS, vous devez d'abord supprimer tous les enregistrements associés (enregistrements de test et de lancement par pays), puis désactiver la protection contre la suppression. Si la protection contre la suppression est activée, l'`DeleteRcsAgent`API renvoie un message d'erreur. Pour désactiver la protection contre la suppression, utilisez l'`UpdateRcsAgent`API avec la protection contre la suppression définie sur`false`. **Pour supprimer un agent AWS RCS** 1. Si la protection contre la suppression est activée, désactivez-la en appelant l'`UpdateRcsAgent`API avec la protection contre la suppression définie sur`false`. 1. Appelez l'`DeleteRcsAgent`API avec l'ID ou l'ARN de l'agent AWS RCS que vous souhaitez supprimer. 1. Vérifiez que l'agent a été supprimé en appelant l'`DescribeRcsAgents`API. L'agent ne doit plus apparaître dans les résultats ou son statut doit être SUPPRIMÉ. # Tester les messages RCS Avant de lancer la messagerie RCS en production, vous pouvez tester votre intégration à l'aide d'un agent de test. L'agent de test est un identifiant RCS for Business créé lorsque vous soumettez un enregistrement de test pour votre agent AWS RCS. Il fournit un accès complet à l'API identique à celui de production, mais limite la livraison des messages aux appareils de test enregistrés uniquement. Aucune approbation du transporteur n'est requise pour les tests. Ce chapitre se concentre sur l'agent de test lui-même, notamment sur la façon de gérer les appareils de test et de résoudre les problèmes courants. Pour savoir step-by-step comment créer votre premier agent AWS RCS et envoyer un message de test, consultez. [Débuter avec RCS](rcs-getting-started.md) Pour plus d'informations sur la création d'un agent AWS RCS et la soumission d'un enregistrement de test, consultez[Gestion des agents RCS](rcs-agents.md). **Important** Les messages de test sont facturés aux tarifs RCS standard. L'agent de test fournit un environnement de test pour valider votre intégration, mais la livraison des messages aux appareils de test entraîne les mêmes frais que les messages de production. **Topics** + [Qu'est-ce qu'un agent de test ?](#rcs-testing-what-is) + [Ajouter des appareils de test](#rcs-testing-add-devices) + [Flux d'invitation aux testeurs](#rcs-testing-tester-invitation) + [Affichage des appareils de test](#rcs-testing-view-devices) + [Envoi de messages de test](#rcs-testing-send-messages) + [Tester la solution de secours par SMS](#rcs-testing-sms-fallback) + [Résolution des problèmes liés aux tests RCS](#rcs-testing-troubleshooting) ## Qu'est-ce qu'un agent de test ? Un agent de test est un identifiant RCS for Business créé par AWS End User Messaging lorsque vous soumettez un enregistrement de test pour votre agent AWS RCS. L'agent de test vous permet de : + Envoyer des messages RCS aux appareils de test enregistrés sans l'approbation du transporteur + Utilisez l'`SendTextMessage`API pour envoyer des messages de test, la même API que celle que vous utilisez en production + Configurez des pools, des ensembles de configuration, des listes de désinscription, des mots clés et d'autres fonctionnalités de messagerie à l'utilisateur AWS final pour votre flux de travail de test + Testez la messagerie bidirectionnelle en envoyant des messages avec des mots clés de réponse automatique + Testez le comportement des SMS de secours avec ou sans numéro de téléphone SMS approuvé Les appareils de test que vous enregistrez comme agent de test fonctionnent dans tous les pays pour cet agent AWS RCS. Il n'est pas nécessaire d'enregistrer les appareils de test séparément pour chaque pays. À l'inverse, l'agent de test peut envoyer des messages aux appareils de test dans n'importe quel pays, que vous ayez ou non soumis un enregistrement de lancement dans ce pays. ## Ajouter des appareils de test Avant de pouvoir envoyer des messages RCS de test, vous devez enregistrer un ou plusieurs appareils de test en tant que numéros de destination vérifiés. Vous pouvez ajouter des appareils de test à l'aide de la console de messagerie utilisateur AWS final ou de l'`CreateVerifiedDestinationNumber`API. ------ #### [ Console ] Dans la console, les appareils de test sont ajoutés dans le cadre du flux de travail de création de l'agent AWS RCS. Pour les instructions relatives à la step-by-step console, voir[Étape 2 : Ajouter un appareil de test](rcs-getting-started.md#rcs-getting-started-add-test-device). ------ #### [ AWS CLI ] Utilisez la `create-verified-destination-number` commande avec le `--rcs-agent-id` paramètre pour enregistrer un appareil de test pour votre agent AWS RCS : ``` aws pinpoint-sms-voice-v2 create-verified-destination-number \ --destination-phone-number +12065550100 \ --rcs-agent-id rcs-a1b2c3d4 ``` **Note** Le paramètre `--origination-identity` n’est pas obligatoire. Lorsque vous le spécifiez`--rcs-agent-id`, la commande enregistre le numéro de téléphone pour les tests RCS auprès de cet agent. Lorsque vous omettez `--rcs-agent-id` et que vous l'utilisez à la `--origination-identity` place, la commande envoie un SMS OTP pour vérification par SMS. Les deux paramètres s'excluent mutuellement. ------ ## Flux d'invitation aux testeurs Après avoir ajouté un appareil de test, AWS End User Messaging envoie une invitation au testeur depuis un agent RCS appelé RBM Tester Management. L'invitation contient des boutons permettant d'accepter ou de refuser. Pour plus de détails sur le flux d'invitation des testeurs, y compris l'exigence d'attente de 120 secondes et le comportement spécifique à iOS, consultez. [Étape 2 : Ajouter un appareil de test](rcs-getting-started.md#rcs-getting-started-add-test-device) ## Affichage des appareils de test Vous pouvez consulter les appareils de test enregistrés pour votre agent AWS RCS à l'aide de la console de messagerie utilisateur AWS final ou de l'`DescribeVerifiedDestinationNumbers`API. ------ #### [ Console ] Pour consulter vos appareils de test enregistrés dans la console, accédez à la page de détails de votre agent AWS RCS et choisissez l'onglet **Testing**. L'onglet affiche tous les numéros de destination vérifiés associés à l'agent, y compris leur statut de vérification et leur numéro de téléphone. ------ #### [ AWS CLI ] Utilisez la `describe-verified-destination-numbers` commande pour répertorier les appareils de test pour votre agent AWS RCS. Utilisez le `--filters` paramètre with `rcs-agent-id` pour afficher uniquement les appareils de test RCS : ``` aws pinpoint-sms-voice-v2 describe-verified-destination-numbers \ --filters Name=rcs-agent-id,Values=rcs-a1b2c3d4 ``` ------ Les appareils de test que vous enregistrez pour un agent de test fonctionnent dans le monde entier pour cet agent AWS RCS. Un appareil de test enregistré dans une AWS région peut recevoir des messages de test envoyés depuis n'importe quelle AWS région dans laquelle votre agent AWS RCS est disponible. ## Envoi de messages de test Une fois qu'un appareil de test a accepté l'invitation du testeur, vous pouvez lui envoyer des messages RCS. Vous pouvez envoyer des messages de test à l'aide de la console de messagerie utilisateur AWS final ou de l'`SendTextMessage`API. ------ #### [ Console ] **Pour envoyer un message de test à l'aide de la console** 1. Ouvrez la console de messagerie de l'utilisateur AWS final. 1. Dans le volet de navigation, sous **Configurations**, choisissez les **agents RCS**. 1. Choisissez l'agent AWS RCS que vous souhaitez tester. 1. Choisissez l'onglet **Tests**. 1. Dans la section **Envoyer un message de test**, choisissez un appareil de test vérifié dans la liste. 1. Entrez le texte de votre message. 1. Choisissez **Envoyer un message de test**. ------ #### [ AWS CLI ] Utilisez la `send-text-message` commande pour envoyer un message de test à un numéro de destination vérifié. Spécifiez l'ARN de l'agent AWS RCS comme identité d'origine : ``` aws pinpoint-sms-voice-v2 send-text-message \ --destination-phone-number +12065550100 \ --origination-identity arn:aws:sms-voice:us-east-1:123456789012:rcs-agent/rcs-a1b2c3d4 \ --message-body "Hello from RCS testing!" ``` ------ ## Tester la solution de secours par SMS Vous pouvez tester le comportement de secours des SMS pour vérifier que vos messages sont délivrés par SMS lorsque la livraison RCS n'est pas possible. Pour obtenir des instructions complètes sur le test de la solution de secours par SMS, y compris les tests sans numéro de SMS approuvé et le end-to-end flux complet, consultez[Tester la solution de secours par SMS](rcs-sms-fallback.md#rcs-sms-fallback-testing). ## Résolution des problèmes liés aux tests RCS Les sections suivantes décrivent les problèmes courants que vous pouvez rencontrer lorsque vous testez des messages RCS et expliquent comment les résoudre. ### L'appareil de test ne reçoit pas de messages RCS Si votre appareil de test ne reçoit pas de messages RCS, vérifiez les points suivants : + Vérifiez que l'appareil de test a accepté l'invitation du testeur. Utilisez l'`DescribeVerifiedDestinationNumbers`API avec le `rcs-agent-id` filtre pour vérifier l'état de vérification de l'appareil. + Vérifiez que le RCS est activé sur le périphérique de test. Sur Android, vérifiez les paramètres de l'application de messagerie pour les fonctionnalités RCS ou Chat. Sur iPhone, RCS nécessite iOS 18 ou version ultérieure. + Vérifiez que le périphérique de test dispose d'une connexion de données active. Les messages RCS sont transmis par le biais de données, et non par le canal SMS. + Vérifiez que vous envoyez au bon numéro de téléphone au format E.164. ### Message délivré sous forme de SMS au lieu de RCS Si votre message de test est envoyé sous forme de SMS au lieu de RCS, vérifiez les points suivants : + Vérifiez que vous envoyez le message à l'aide de l'ARN de l'agent AWS RCS ou d'un pool contenant l'agent AWS RCS comme identité d'origine. Si vous spécifiez uniquement un numéro de téléphone SMS, le message est envoyé par SMS. + Vérifiez que le dispositif de test a accepté l'invitation du testeur et qu'il est enregistré en tant que numéro de destination vérifié pour le bon agent AWS RCS. + Vérifiez l'événement de livraison pour déterminer si le message a été initialement tenté via RCS et est revenu à un SMS, ou s'il a été envoyé directement par SMS. ### Invitation de testeur non reçue Si un appareil de test ne reçoit pas l'invitation du testeur, vérifiez les points suivants : + L'invitation au testeur peut prendre jusqu'à 20 minutes pour arriver après l'ajout d'un appareil de test. Si l'invitation n'est pas arrivée au bout de 20 minutes, retirez l'appareil de test et ajoutez-le à nouveau. + Vérifiez que le numéro de téléphone est au format E.164 correct et qu'il s'agit d'un numéro de téléphone portable valide. + Vérifiez que le périphérique de test dispose d'une connexion de données active et que le RCS est activé. ### iOS : invitation à un testeur dans Unknown Senders Sur les appareils iOS (iPhone doté d'iOS 18 ou version ultérieure), l'invitation du testeur envoyée par RBM Tester Management peut être filtrée dans le dossier **Expéditeurs inconnus** de l'application Messages. Il s'agit d'un comportement iOS par défaut pour les messages provenant de contacts inconnus. Pour trouver l'invitation : **Pour trouver l'invitation du testeur sur iOS** 1. Ouvrez l'app Messages sur l'iPhone. 1. Appuyez sur **Filtres** dans le coin supérieur gauche (ou balayez vers la droite depuis la liste des messages). 1. Appuyez sur **Expéditeurs inconnus**. 1. Recherchez le message de gestion de RBM Tester et appuyez sur **Make me a tester** pour accepter l'invitation. # Solution de repli entre RCS et SMS à l'aide de pools téléphoniques Un pool téléphonique est un conteneur d'identités de messagerie, telles que les agents AWS RCS et les numéros de téléphone SMS, qui fournit une couche d'abstraction entre vos demandes d'API et les identités d'origine sous-jacentes. Les pools simplifient les modifications de configuration, la migration des types de numéros et les solutions de RCS-to-SMS secours. Vous envoyez un seul appel d'API au pool, et la messagerie utilisateur AWS final s'occupe de la sélection des canaux pour vous. Ce chapitre explique comment la livraison du RCS peut échouer, ce qui rend possible le remplacement par SMS, la logique de repli et l'ordre de priorité, ainsi que les implications en matière de facturation. Il décrit également les pool-per-use-case meilleures pratiques et explique comment ajouter et supprimer des agents AWS RCS dans les pools. Pour obtenir des informations générales sur les pools de téléphones, consultez[Pools téléphoniques dans les messages SMS destinés aux utilisateurs AWS finaux](phone-pool.md). Pour plus d'informations sur la gestion des agents AWS RCS, consultez[Gestion des agents RCS](rcs-agents.md). **Topics** + [Comment la livraison du RCS peut échouer](#rcs-sms-fallback-how-rcs-fails) + [Qu'est-ce qui rend possible le repli sur les SMS](#rcs-sms-fallback-what-makes-possible) + [Pourquoi utiliser des piscines](#rcs-sms-fallback-why-pools) + [Pool-per-use-case modèle](#rcs-sms-fallback-pool-per-use-case) + [Risque de conformité lié à l'envoi au niveau du compte](#rcs-sms-fallback-compliance-risk) + [Logique de repli et ordre de priorité](#rcs-sms-fallback-logic) + [Implications de la solution de remplacement des SMS sur la facturation](#rcs-sms-fallback-billing) + [Tester la solution de secours par SMS](#rcs-sms-fallback-testing) + [Gestion des agents AWS RCS dans les pools](#rcs-sms-fallback-pool-management) ## Comment la livraison du RCS peut échouer La livraison du RCS peut échouer pour plusieurs raisons. La compréhension de ces modes de défaillance vous aide à planifier votre stratégie de repli : + **L'opérateur ne prend pas en charge le RCS** : l'opérateur mobile du destinataire n'a pas activé la messagerie RCS sur son réseau. + **L'appareil ne prend pas en charge le RCS** : l'appareil du destinataire ne dispose pas de la fonctionnalité RCS (par exemple, un ancien appareil Android ou un iPhone exécutant iOS avant la version 18). + **Agent non actif chez le transporteur** : votre agent AWS RCS n'a pas encore été approuvé par le transporteur du destinataire, ou le statut de l'agent est PARTIEL pour ce pays. + **Appareil temporairement inaccessible** — L'appareil du destinataire prend en charge le RCS mais est temporairement hors ligne ou n'a aucune connexion de données. Les messages RCS nécessitent une connexion de données pour être envoyés. Lorsque l'une de ces conditions se produit et que vous utilisez l'envoi basé sur un pool ou au niveau du compte, AWS la messagerie à l'utilisateur final revient automatiquement à la livraison de SMS en utilisant un numéro de téléphone du même pool ou du même compte. ## Qu'est-ce qui rend possible le repli sur les SMS La solution de secours par SMS nécessite à la fois un agent AWS RCS et au moins un numéro de téléphone SMS dans le même pool. Lorsque vous envoyez un message au pool, AWS End User Messaging tente d'abord de le transmettre au RCS. Si la livraison du RCS échoue, le service réessaie le message par SMS en utilisant un numéro de téléphone du même pool. Un pool ne comportant qu'un agent AWS RCS (et aucun numéro de téléphone) ne prend pas en charge le remplacement par SMS. En cas d'échec du RCS, le message n'est pas délivré. **Important** Pour que la solution de secours par SMS fonctionne, votre pool doit contenir à la fois un agent AWS RCS et un ou plusieurs numéros de téléphone SMS. Un pool ne comportant qu'un seul type d'identité ne fournit pas de solution de secours intercanal. ## Pourquoi utiliser des piscines Nous recommandons d'utiliser un pool téléphonique pour tous les cas d'utilisation de la messagerie, et pas seulement pour le RCS. Les piscines offrent les avantages suivants : + Solution de **secours automatique par SMS** : lorsqu'un pool contient à la fois un agent AWS RCS et des numéros de téléphone SMS, la messagerie à l'utilisateur AWS final tente d'abord de transmettre le RCS. Si la livraison du RCS échoue (par exemple, si l'appareil ou l'opérateur du destinataire ne prend pas en charge le RCS), le service réessaie automatiquement le message par SMS en utilisant un numéro de téléphone du même pool. Il n'est pas nécessaire d'implémenter une logique de repli dans votre application. + **Routage intelligent** : le service sélectionne la meilleure identité d'origine dans le pool en fonction de la destination, de la disponibilité des canaux et de l'historique des envois. Ce routage s'effectue de manière transparente à chaque `SendTextMessage` appel. + **Appel d'API unique** : vous spécifiez l'ID du pool comme identité d'origine dans votre `SendTextMessage` demande. Le service détermine s'il convient de livrer par RCS ou par SMS sans aucune logique supplémentaire de votre part. + **Flexibilité pour les modifications futures** : vous pouvez ajouter ou supprimer des numéros de téléphone et des agents AWS RCS d'un pool à tout moment sans modifier le code de votre application. Par exemple, vous pouvez ajouter un numéro gratuit pour le remplacement des SMS ou échanger un numéro 10DLC sans modifier votre intégration d'envoi. + **Aucun coût ni inconvénient** : la création d'un pool et l'ajout d'identités d'origine à celui-ci n'entraînent aucun frais supplémentaire. Même avec un seul numéro de téléphone ou un seul agent AWS RCS, l'utilisation d'un pool vous donne la possibilité d'ajouter d'autres identités ultérieurement sans modifier l'application. **Note** Nous vous recommandons de toujours utiliser un pool pour la messagerie. L'utilisation d'un pool ne présente aucun coût ni inconvénient, même avec une seule identité d'origine. Pour le RCS-to-SMS remplacement, le pool doit contenir à la fois un agent AWS RCS et au moins un numéro de téléphone SMS. En commençant par un pool depuis le début, vous pouvez ajouter des numéros de secours par SMS ou des agents AWS RCS supplémentaires ultérieurement sans modifier votre code d'envoi. ## Pool-per-use-case modèle Nous vous recommandons de créer un pool par cas d'utilisation. Chaque pool doit contenir tous les numéros de téléphone et l'agent AWS RCS destinés à un seul objectif de messagerie. Par exemple : + Un **pool transactionnel** pour les codes OTP et les notifications de compte, contenant votre agent AWS RCS et un numéro de 10 DLC enregistré pour la messagerie transactionnelle. + Un **pool marketing** pour les messages promotionnels, contenant le même agent AWS RCS (ou un autre) et un numéro gratuit enregistré pour le marketing. + Un **pool de rappels de rendez-vous** pour planifier les notifications, contenant votre agent AWS RCS et un numéro de téléphone dédié pour les messages liés aux rendez-vous. Ce modèle garantit que lorsque la livraison du RCS échoue et que le service revient aux SMS, le message de secours est envoyé à partir d'un numéro de téléphone enregistré et approuvé pour le même cas d'utilisation. Cela permet de garantir la conformité de votre messagerie aux exigences du transporteur et aux conditions d'enregistrement. ## Risque de conformité lié à l'envoi au niveau du compte Lorsque vous envoyez des messages au niveau du compte (sans spécifier de pool ou d'identité d'origine), AWS la messagerie utilisateur final sélectionne une identité d'origine parmi toutes les identités disponibles dans votre compte. Si plusieurs numéros de téléphone sont enregistrés dans votre compte pour différents cas d'utilisation, le service peut sélectionner un numéro de téléphone qui ne correspond pas au contenu de votre message. **Important** L'envoi au niveau du compte avec des cas d'utilisation mixtes crée un risque de conformité. Par exemple, si votre compte possède un numéro 10DLC enregistré pour les messages OTP et un numéro gratuit enregistré pour les rappels de rendez-vous, un message OTP qui revient à un SMS peut être envoyé à partir du numéro gratuit de rappel de rendez-vous. Cela enfreint les conditions d'enregistrement de ce numéro et peut entraîner le filtrage du transporteur ou la suspension du numéro. Pour éviter ce risque, utilisez l'envoi basé sur un pool avec un pool par cas d'utilisation. Lorsque vous spécifiez un ID de pool dans votre `SendTextMessage` demande, le service sélectionne uniquement les identités d'origine à partir de ce pool. Comme toutes les identités du pool sont enregistrées pour le même cas d'utilisation, le message de secours est toujours envoyé à partir d'un numéro approprié. **Comparaison de la conformité de l'approche d'envoi** | Approche d'envoi | Comportement de secours des SMS | Risque de conformité | | --- | --- | --- | | Basé sur la piscine (recommandé) | Revient à un numéro de téléphone du même pool, enregistré pour le même cas d'utilisation | Faible : le nombre de remplacement correspond au cas d'utilisation du message | | Au niveau du compte | Revient à n'importe quel numéro de téléphone disponible dans le compte | Élevé : le numéro de remplacement peut ne pas correspondre au cas d'utilisation du message si plusieurs cas d'utilisation partagent le même compte | | Direct (ARN de l'agent AWS RCS) | Aucune solution de secours par SMS | Aucun — le message est délivré via RCS uniquement ou pas du tout | ## Logique de repli et ordre de priorité Lorsque AWS la messagerie de l'utilisateur final sélectionne une identité d'origine pour un message (provenant d'un pool ou de toutes les identités de compte), elle évalue les identités dans l'ordre de priorité suivant : 1. **Identité permanente** : si un jumelage d'envoi permanent existe pour le numéro de téléphone de destination et que l'identité est toujours disponible, le service utilise cette identité. 1. **Agent AWS RCS** : s'il n'existe aucun couplage permanent, le service tente de livrer le RCS via un agent AWS RCS disponible. 1. **Code court SMS** — Si le RCS n'est pas disponible, le service sélectionne un code court SMS. 1. **SMS 10DLC** — Si aucun code court n'est disponible, le service sélectionne un numéro 10DLC. 1. Numéro **SMS gratuit — Si aucun numéro** 10DLC n'est disponible, le service sélectionne un numéro gratuit. 1. **ID de l'expéditeur du SMS** : si aucune autre identité n'est disponible, le service sélectionne un identifiant d'expéditeur. Cet ordre de priorité s'applique dans le cadre du modèle d'envoi que vous utilisez. Pour l'envoi basé sur un pool, le service ne prend en compte que les identités du pool spécifié. Pour les envois au niveau du compte, le service prend en compte toutes les identités de votre compte. ### Solution de secours automatique par SMS Lorsque vous envoyez un message via un pool ou au niveau du compte, la messagerie de l'utilisateur AWS final revient automatiquement aux SMS si la livraison RCS n'est pas possible. Fallback est asynchrone : Si AWS la messagerie utilisateur final envoie avec succès le message RCS mais ne reçoit pas de confirmation de livraison ou de signal d'échec dans les 25 secondes, le service revient aux SMS. Cela permet de gérer les cas où l'infrastructure RCS accepte le message mais où la livraison s'arrête (par exemple, l'appareil du destinataire est temporairement injoignable, le transporteur ne prend pas en charge le RCS ou l'appareil n'est pas compatible RCS). **Note** L'envoi direct (en spécifiant un ARN d'agent AWS RCS comme identité d'origine) ne prend pas en charge le repli automatique des SMS. Si vous avez besoin d'une solution de secours par SMS, utilisez l'envoi basé sur le pool. ### Envoi permanent L'envoi permanent est une optimisation du routage qui améliore la cohérence des livraisons. Lorsque AWS la messagerie de l'utilisateur final envoie avec succès un message à un numéro de téléphone de destination en utilisant une identité d'origine spécifique, le service mémorise ce jumelage pendant 25 heures. Les messages suivants envoyés à la même destination dans le délai de 25 heures sont acheminés via la même identité d'origine, à condition qu'elle soit toujours disponible dans le pool ou le compte. L'envoi permanent s'applique à la fois au RCS et à l'envoi de SMS. Par exemple, si un message est délivré via RCS via votre agent AWS RCS, le message suivant envoyé à la même destination dans les 25 heures est également tenté via RCS via le même agent. Si le message précédent a été délivré par SMS (après le repli du RCS), le message suivant est tenté par SMS via le même numéro de téléphone. Le service réessaie régulièrement de livrer le RCS, même si l'identifiant permanent est un numéro de téléphone SMS. Cela garantit que les destinataires dont les appareils bénéficient du support RCS (par exemple, après le déploiement d'un opérateur ou une mise à niveau de l'appareil) commencent à recevoir des messages RCS sans intervention manuelle. Principales caractéristiques du Sticky Sending : + **TTL dans les 25 heures** — L'accord autocollant expire 25 heures après la dernière livraison réussie. Après expiration, le service réévalue l'ordre de priorité de l'identité d'origine pour le message suivant. + **Réessai automatique du RCS** — Même lorsque l'identité permanente est un numéro de téléphone SMS, le service tente régulièrement de délivrer le RCS pour vérifier si le destinataire prend désormais en charge le RCS. + **Pas de rinçage manuel** : vous ne pouvez pas vider ou réinitialiser manuellement les paires d'envoi autocollantes. Le jumelage expire automatiquement après le délai TTL de 25 heures. ### Reçus de livraison lors du repli Lorsque le remplacement par SMS se produit, AWS la messagerie de l'utilisateur final génère un accusé de réception unique pour le canal final qui a transmis le message. Si le message est délivré par SMS après le repli du RCS, le reçu de livraison indique que le SMS est le canal de livraison. Dans des circonstances normales, AWS la messagerie utilisateur final révoque le message RCS avant que le message de secours SMS ne soit délivré. Cela empêche le destinataire de recevoir deux fois le même message. Cependant, dans de rares cas, le message RCS et le message de secours SMS peuvent être délivrés. Cela peut se produire si le message RCS est délivré après le délai de 25 secondes mais avant la fin de la révocation. Dans ces rares scénarios de double livraison, vous pouvez recevoir des reçus de livraison pour les deux canaux. Pour plus d'informations sur l'impact de la double livraison sur la facturation, consultez[Modèle de facturation et de tarification RCS](rcs-billing.md). ## Implications de la solution de remplacement des SMS sur la facturation Lorsqu'un message passe du RCS au SMS, vous êtes facturé pour la livraison du SMS, et non pour l'échec de la tentative de RCS. Les messages RCS ne sont facturés que s'ils sont livrés avec succès à l'appareil du destinataire. Si la livraison du RCS échoue et que le message revient au format SMS, vous payez le tarif SMS correspondant à ce message. Dans de rares scénarios de double livraison (dans lesquels le message RCS et le message de secours SMS sont délivrés à la fois), les deux livraisons peuvent vous être facturées. Pour obtenir tous les détails de facturation, consultez[Modèle de facturation et de tarification RCS](rcs-billing.md). ## Tester la solution de secours par SMS Vous pouvez tester le comportement de secours des SMS pour vérifier que vos messages sont délivrés par SMS lorsque la livraison RCS n'est pas possible. Il existe deux approches pour tester la solution de secours par SMS, selon que vous disposez ou non d'un numéro de téléphone SMS approuvé. ### Test sans numéro de SMS approuvé Vous pouvez vérifier que AWS la messagerie à l'utilisateur final déclenche correctement le mécanisme de secours sans numéro de téléphone SMS approuvé. Même sans numéro approuvé, vous pouvez voir les événements relatifs aux nouvelles tentatives et aux échecs par SMS, ce qui confirme que la solution de secours fonctionne. **Pour tester la solution de secours par SMS sans numéro de SMS approuvé** 1. Mettez votre appareil de test hors ligne en désactivant les données mobiles et le Wi-Fi, ou en activant le mode avion. 1. Envoyez un message RCS à l'appareil de test à l'aide de l'`SendTextMessage`API avec l'ARN de votre agent AWS RCS comme identité d'origine. 1. Vérifiez l'événement du message CloudWatch ou la destination de votre événement. Vous devriez voir un événement d'échec de livraison indiquant que la livraison RCS n'a pas été possible et que le service a tenté de remplacer les SMS. Comme aucun numéro de téléphone SMS n'est disponible pour le remplacement, la livraison du SMS échoue également. Toutefois, l'événement confirme que la messagerie de l'utilisateur AWS final a correctement déclenché le mécanisme de secours. ### Test avec un numéro de SMS approuvé Pour un test de secours complet end-to-end, ajoutez un numéro de téléphone SMS approuvé et votre agent AWS RCS au même pool téléphonique. Cela vous permet de vérifier que les messages sont envoyés par SMS lorsque le RCS n'est pas disponible. **Pour tester la solution de secours par SMS avec un numéro de SMS approuvé** 1. Créez un pool téléphonique contenant à la fois votre agent AWS RCS et un numéro de téléphone SMS approuvé (tel qu'un numéro 10DLC, un numéro gratuit ou un numéro abrégé). 1. Mettez votre appareil de test hors ligne en désactivant les données mobiles et le Wi-Fi, ou en activant le mode avion. 1. Envoyez un message à l'aide de l'`SendTextMessage`API avec l'ID du pool comme identité d'origine. 1. Vérifiez que le message est envoyé par SMS à votre appareil de test. 1. Vérifiez l'événement de livraison pour confirmer que le message a été délivré via le canal SMS après le repli du RCS. ## Gestion des agents AWS RCS dans les pools Pour step-by-step obtenir des instructions sur la création de pools avec les agents AWS RCS, l'ajout d'agents aux pools existants, la compréhension des exigences de configuration des pools et la suppression d'agents des pools, consultez[Gestion des agents AWS RCS dans les pools](phone-pool-rcs-agents.md). # Envoi de messages RCS AWS La messagerie destinée aux utilisateurs finaux utilise la même `SendTextMessage` API pour l'envoi de RCS et de SMS. La manière dont le service achemine votre message dépend de l'identité d'origine que vous spécifiez dans la demande. Vous pouvez envoyer des messages via un pool téléphonique (recommandé), au niveau du compte ou directement via un ARN d'agent AWS RCS. Cette section explique les trois modèles d'envoi, explique comment interpréter les reçus de livraison et fournit des exemples de code. Pour plus de détails sur l'envoi permanent, l'identité d'origine, l'ordre de priorité et le remplacement automatique des SMS, consultez. [Solution de repli entre RCS et SMS à l'aide de pools téléphoniques](rcs-sms-fallback.md) Pour en savoir plus sur la gestion des agents AWS RCS, consultez[Gestion des agents RCS](rcs-agents.md). **Topics** + [Schémas d'envoi](#rcs-send-message-patterns) + [Envoi permanent, commande prioritaire et solution de secours par SMS](#rcs-send-message-fallback-summary) + [Exemples de code](#rcs-send-message-examples) + [L'agent AI invite l'agent à envoyer des messages RCS](#rcs-send-message-ai-prompt) + [Gestion des reçus de livraison](#rcs-send-message-delivery-receipts) ## Schémas d'envoi AWS La messagerie utilisateur final prend en charge trois modèles d'envoi de messages RCS. Chaque modèle détermine la manière dont le service sélectionne une identité d'origine et détermine si le remplacement automatique des SMS est disponible. **Modèles d'envoi RCS** | Modèle | Comment ça marche | Solution de secours pour les SMS | Quand l’utiliser | | --- | --- | --- | --- | | Basé sur la piscine (recommandé) | Spécifiez un ID de pool comme identité d'origine. Le service sélectionne la meilleure identité dans le pool. | Oui | Tous les cas d'utilisation. Permet la sélection automatique des canaux et le remplacement des SMS avec un routage conforme aux normes de conformité. | | Au niveau du compte | Omettez l'identité d'origine. Le service sélectionne parmi toutes les identités disponibles dans votre compte. | Oui | Configurations simples avec un seul cas d'utilisation. Non recommandé pour les comptes comportant plusieurs cas d'utilisation. | | Envoi direct | Spécifiez un ARN d'agent AWS RCS comme identité d'origine. Le message est envoyé uniquement via RCS. | Non | RCS-or-nothing cas d'utilisation, ou lorsque vous gérez le repli des SMS en dehors de la messagerie destinée aux utilisateurs AWS finaux. | ### Envoi basé sur un pool (recommandé) L'envoi par pool est l'approche recommandée pour tous les cas d'utilisation du RCS. Lorsque vous spécifiez un ID de pool comme identité d'origine dans votre `SendTextMessage` demande, AWS End User Messaging sélectionne la meilleure identité d'origine dans le pool en fonction de la destination, de la disponibilité des canaux et de l'historique des envois. Si le pool contient à la fois un agent AWS RCS et des numéros de téléphone SMS, le service tente d'abord de livrer le RCS. Si la livraison du RCS échoue, le service revient automatiquement aux SMS en utilisant un numéro de téléphone du même pool. Comme toutes les identités du pool sont enregistrées pour le même cas d'utilisation, le message de secours est toujours envoyé à partir d'un numéro approprié. Pour plus de détails sur la création et la configuration de pools avec les agents AWS RCS, consultez[Solution de repli entre RCS et SMS à l'aide de pools téléphoniques](rcs-sms-fallback.md). ### Envoi au niveau du compte Lorsque vous omettez l'identité d'origine dans votre `SendTextMessage` demande, AWS la messagerie à l'utilisateur final sélectionne une identité d'origine parmi toutes les identités disponibles dans votre compte. Le service utilise l'ordre de priorité de l'identité d'origine pour déterminer l'identité à utiliser. Pour en savoir plus, consultez [Logique de repli et ordre de priorité](rcs-sms-fallback.md#rcs-sms-fallback-logic). **Important** L'envoi au niveau du compte crée un risque de conformité si votre compte contient des numéros de téléphone enregistrés pour différents cas d'utilisation. Lorsque la livraison du RCS échoue et que le service revient aux SMS, il peut sélectionner un numéro de téléphone qui ne correspond pas au contenu de votre message. Par exemple, un message OTP peut renvoyer à un numéro gratuit enregistré pour les rappels de rendez-vous, violant ainsi les conditions d'enregistrement de ce numéro. Pour éviter ce risque, utilisez l'envoi basé sur un pool avec un pool par cas d'utilisation. Pour en savoir plus, consultez [Risque de conformité lié à l'envoi au niveau du compte](rcs-sms-fallback.md#rcs-sms-fallback-compliance-risk). ### Envoi direct (RCS uniquement) Lorsque vous spécifiez un ARN d'agent AWS RCS comme identité d'origine dans votre `SendTextMessage` demande, AWS End User Messaging envoie le message uniquement via RCS. Il n'y a pas de solution de secours automatique par SMS. Si la livraison du RCS échoue, le message n'est pas réessayé sur un autre canal. Utilisez l'envoi direct lorsque : + Tu veux une RCS-or-nothing livraison. Le message ne doit être délivré que via RCS, et vous préférez ne pas le recevoir plutôt que l'envoi par SMS. + Vous gérez les SMS de secours en dehors de la messagerie destinée aux utilisateurs AWS finaux. Votre application gère la logique de repli de manière indépendante, par exemple en détectant les défaillances de livraison du RCS et en envoyant un SMS distinct via un autre système ou fournisseur. **Note** L'envoi direct contourne toute logique de repli des SMS. Si l'appareil ou l'opérateur du destinataire ne prend pas en charge le RCS, le message n'est pas délivré. Dans la plupart des cas d'utilisation, l'envoi par pool est recommandé car il fournit une solution de remplacement automatique des SMS sans frais supplémentaires. ## Envoi permanent, commande prioritaire et solution de secours par SMS Lorsque vous envoyez des messages par le biais d'un pool ou au niveau du compte, la messagerie utilisateur AWS final utilise l'envoi permanent (optimisation du routage en 25 heures), un ordre de priorité des identités d'origine et une solution de secours automatique par SMS afin de sélectionner le meilleur canal et la meilleure identité pour chaque message. Pour plus de détails sur le fonctionnement de ces mécanismes, y compris le repli automatique, les reçus de livraison en cas de repli et les implications en matière de facturation, voir. [Solution de repli entre RCS et SMS à l'aide de pools téléphoniques](rcs-sms-fallback.md) ## Exemples de code Les exemples Python suivants montrent comment envoyer des messages RCS en utilisant chacun des trois modèles d'envoi. Tous les exemples utilisent le `pinpoint-sms-voice-v2` client boto3 et l'`SendTextMessage`API. ### Exemple d'envoi basé sur un pool L'exemple suivant envoie un message via un pool téléphonique. Le service sélectionne la meilleure identité d'origine dans le pool et revient automatiquement aux SMS si la livraison RCS n'est pas possible. ``` import boto3 client = boto3.client('pinpoint-sms-voice-v2') response = client.send_text_message( DestinationPhoneNumber='+12065550100', OriginationIdentity='pool-a1b2c3d4e5f6g7h8i', MessageBody='Your appointment is confirmed for tomorrow at 2:00 PM.', MessageType='TRANSACTIONAL' ) print(f"Message ID: {response['MessageId']}") ``` ### Exemple d'envoi au niveau du compte L'exemple suivant envoie un message au niveau du compte en omettant l'identité d'origine. Le service sélectionne une identité parmi toutes les identités disponibles dans votre compte en utilisant l'ordre de priorité. ``` import boto3 client = boto3.client('pinpoint-sms-voice-v2') response = client.send_text_message( DestinationPhoneNumber='+12065550100', MessageBody='Your verification code is 123456.', MessageType='TRANSACTIONAL' ) print(f"Message ID: {response['MessageId']}") ``` **Important** Si votre compte contient des numéros de téléphone enregistrés pour différents cas d'utilisation, l'envoi au niveau du compte peut rediriger les SMS vers un numéro qui ne correspond pas au contenu de votre message. Utilisez l'envoi basé sur un pool avec un pool par cas d'utilisation pour éviter les risques de conformité. ### Exemple d'envoi direct L'exemple suivant envoie un message directement via un ARN d'agent AWS RCS. Le message est délivré via RCS uniquement, sans aucune solution de secours par SMS. ``` import boto3 client = boto3.client('pinpoint-sms-voice-v2') response = client.send_text_message( DestinationPhoneNumber='+12065550100', OriginationIdentity='arn:aws:sms-voice:us-east-1:123456789012:rcs-agent/rcs-a1b2c3d4', MessageBody='Welcome to our RCS channel! Reply HELP for assistance.' ) print(f"Message ID: {response['MessageId']}") ``` **Note** Si l'appareil ou l'opérateur du destinataire ne prend pas en charge le RCS, le message n'est pas délivré. Aucune tentative de repli par SMS n'est tentée. Utilisez ce modèle uniquement lorsque vous souhaitez une RCS-or-nothing livraison ou lorsque vous gérez le remplacement des SMS en dehors de la messagerie destinée aux utilisateurs AWS finaux. ## L'agent AI invite l'agent à envoyer des messages RCS Si vous utilisez un assistant de codage IA génératif ou un agent AI, vous pouvez utiliser l'invite suivante pour obtenir de l'aide pour envoyer des messages RCS à l'aide de la AWS CLI ou du SDK. **Note** Copiez l'invite suivante et collez-la dans votre agent AI ou votre assistant de codage : ``` ## RCS Messaging Assistant Prompt Help me send RCS messages using AWS End User Messaging SMS with the `pinpoint-sms-voice-v2` service. Show me exact CLI commands and Python/boto3 examples. Ask me for my details before generating any commands. **Important rules for generating commands:** - The API is `send-text-message` — the same command used for SMS. There is NO separate RCS send API. - There is NO `describe-messages` API. Do not generate it. - The boto3 method is `send_text_message` on the `pinpoint-sms-voice-v2` client. - Use the term "testing" — NOT "sandbox". **Prerequisites:** I have an existing RCS agent (created via the setup process) and a verified test device. ### Pattern 1: Direct RCS sending (simplest, good for testing) Send directly through my RCS Agent ARN. RCS-only delivery, no SMS fallback. If the recipient's device doesn't support RCS, the message is not delivered. CLI: `send-text-message --destination-phone-number --origination-identity --message-body "" --message-type ` Returns `MessageId`. ### Pattern 2: Pool-based sending (recommended for production) Send through a phone pool containing my RCS agent (and optionally SMS phone numbers for fallback). The service tries RCS first, then falls back to SMS asynchronously if no RCS signal within 25 seconds. This is NOT synchronous fallback — the SMS is sent as a separate attempt after the timeout. To set up a pool: - `create-pool --origination-identity --message-type TRANSACTIONAL` → returns `PoolId` - Optionally add SMS numbers: `associate-origination-identity --pool-id --origination-identity ` CLI: `send-text-message --destination-phone-number --origination-identity --message-body "" --message-type ` ### Pattern 3: Account-level sending Send without specifying `--origination-identity`. The service auto-selects the best identity from the account. CLI: `send-text-message --destination-phone-number --message-body "" --message-type ` **Compliance warning:** If the account has multiple RCS agents, SMS numbers, or different use cases, the service picks an identity automatically — which may not be the intended one. Use pool-based or direct sending for explicit control over which identity is used. ### Delivery verification - For testing: check the test device directly — the message appears from the branded RCS agent. - For production: configure event destinations BEFORE sending using `create-event-destination` (SNS, CloudWatch Logs, or Firehose). Event destinations do not retroactively capture events for already-sent messages. - CloudWatch metrics in `AWS/SMSVoice` namespace provide aggregate delivery statistics. ### Behavioral notes - Sticky sending: the service remembers the last successful identity per destination number for 25 hours. - Pool-based sending is recommended for production because it provides automatic SMS fallback. - All three patterns use the same `send-text-message` API — the only difference is what you pass (or don't pass) as `--origination-identity`. --- **Before generating commands, ask me for:** - Which sending pattern I want to use (direct, pool-based, or account-level) - My RCS Agent ARN - My pool ID (if using pool-based sending) - Destination phone number in E.164 format - Message type (TRANSACTIONAL or PROMOTIONAL) - Message text ``` ## Gestion des reçus de livraison AWS La messagerie destinée aux utilisateurs finaux fournit des reçus de livraison pour les messages RCS via Amazon EventBridge et définit les destinations des événements. Les reçus de livraison indiquent le statut final de votre message et le canal utilisé pour la livraison. Pour savoir comment configurer les destinations des événements afin de capturer les reçus de livraison et les autres événements liés aux messages, voir[Destinations des événements dans les messages SMS destinés aux utilisateurs AWS finaux](configuration-sets-event-destinations.md). ### Valeurs du statut de livraison Les valeurs d'état de livraison suivantes s'appliquent aux messages RCS : LIVRÉ Le message a été correctement envoyé à l'appareil du destinataire. PENDING Le message a été accepté par l'infrastructure RCS mais la confirmation de livraison n'a pas encore été reçue. Il se peut que le message soit toujours délivré. EXPIRÉ Le message n'a pas été remis dans le délai imparti. Pour les messages RCS avec SMS de secours, ce statut s'applique à la tentative de RCS avant que la solution de secours ne se produise. NON LIVRABLE Le message n'a pas pu être remis. Cela peut se produire lorsque l'appareil du destinataire est définitivement injoignable ou que le numéro de téléphone n'est pas valide. REFUSÉE Le message a été rejeté par l'infrastructure ou le transporteur RCS. Cela peut être dû à des violations de la politique de contenu ou à un filtrage au niveau de l'opérateur. ### Attribution des chaînes Les reçus de livraison incluent l'attribution du canal qui indique si le message a été délivré par RCS ou par SMS. Cela est important pour comprendre votre mix de livraison et à des fins de facturation. + Lorsqu'un message est délivré via RCS, le reçu de livraison indique que RCS est le canal de livraison et inclut l'identité de l'agent AWS RCS. + Lorsqu'un message redevient un SMS, le reçu de livraison indique que le SMS est le canal de livraison et inclut le numéro de téléphone SMS utilisé pour la livraison. + Lorsqu'un envoi direct (ARN de l'agent AWS RCS) échoue, le reçu de livraison indique que RCS est le canal tenté présentant un statut d'échec. Aucun reçu de secours par SMS n'est généré. Pour plus de détails sur les CloudWatch métriques RCS et le suivi des modèles de livraison, voir[CloudWatch Métriques et surveillance du RCS](rcs-monitoring.md). Pour plus d'informations sur l'impact du canal de livraison sur la facturation, consultez[Modèle de facturation et de tarification RCS](rcs-billing.md). # Réception de messages RCS entrants AWS La messagerie utilisateur final prend en charge la messagerie RCS bidirectionnelle, ce qui vous permet de recevoir des SMS de vos clients. Les messages RCS entrants suivent le même schéma que les SMS bidirectionnels : les messages entrants sont envoyés à une rubrique Amazon SNS que vous configurez, et vous les traitez à l'aide des fonctions Lambda ou d'autres abonnés SNS. **Important** Afin de consommer les messages RCS entrants, vous devez configurer une rubrique SNS de messagerie bidirectionnelle sur votre agent AWS RCS. La messagerie bidirectionnelle est désactivée par défaut lorsque vous créez un agent. Une fois que vous l'avez activée et configuré une rubrique SNS, les messages entrants sont envoyés à cette rubrique. Les clients sont facturés pour tous les messages RCS entrants au tarif standard. Cette section explique comment fonctionne la messagerie RCS bidirectionnelle, comment l'activer pour votre agent AWS RCS, le format de charge utile des messages entrants et comment gérer les mots clés. Pour plus d'informations sur la gestion des agents AWS RCS, consultez[Gestion des agents RCS](rcs-agents.md). Pour plus d'informations sur l'envoi de messages RCS, consultez[Envoi de messages RCS](rcs-send-message.md). **Topics** + [Comment fonctionne la messagerie RCS bidirectionnelle](#rcs-inbound-how-it-works) + [Configuration de votre destination de messagerie bidirectionnelle](#rcs-inbound-enable) + [Format de charge utile des messages entrants](#rcs-inbound-payload) + [Types de messages pris en charge](#rcs-inbound-text-only) + [Gestion des mots clés pour RCS](#rcs-inbound-keywords) + [Traitement des messages entrants avec Lambda](#rcs-inbound-lambda) + [Bonnes pratiques pour la messagerie RCS entrante](#rcs-inbound-best-practices) ## Comment fonctionne la messagerie RCS bidirectionnelle Lorsqu'un client envoie un message texte à votre agent AWS RCS, AWS End User Messaging reçoit le message et le publie sur une rubrique Amazon SNS que vous désignez. À partir de là, vous pouvez traiter le message en utilisant n'importe quel abonné SNS, tel qu'une fonction Lambda, une file d'attente Amazon SQS ou un point de terminaison. HTTP/HTTPS Le flux de messagerie RCS bidirectionnel fonctionne comme suit : 1. Un client envoie un message texte à votre agent AWS RCS depuis son appareil compatible RCS. 1. AWS La messagerie de l'utilisateur final reçoit le message entrant et l'évalue par rapport aux mots clés que vous avez configurés. Si le message correspond à un mot clé, le service envoie la réponse automatique configurée (le cas échéant). 1. AWS La messagerie utilisateur final publie la charge utile du message sous forme d'objet JSON dans la rubrique Amazon SNS que vous avez configurée pour la messagerie bidirectionnelle sur l'agent AWS RCS. 1. Vos abonnés SNS (par exemple, une fonction Lambda) reçoivent la charge utile du message et le traitent conformément à la logique de votre application. Le RCS dans AWS la messagerie utilisateur final prend actuellement en charge les messages texte entrants. Si un client envoie un message multimédia (tel qu'une image ou une vidéo) à votre agent AWS RCS, le message est enregistré avec le statut IGNORÉ. Votre application ne reçoit pas de messages multimédia via la rubrique SNS. ## Configuration de votre destination de messagerie bidirectionnelle Pour recevoir et traiter les messages RCS entrants dans votre application, vous devez activer la messagerie bidirectionnelle et configurer une destination sur votre agent AWS RCS. La messagerie bidirectionnelle est désactivée par défaut. Lorsque vous l'activez, vous spécifiez une rubrique Amazon SNS dans laquelle AWS la messagerie utilisateur final envoie les messages entrants. Vous pouvez configurer la destination à l'aide de la console de messagerie utilisateur AWS final ou de l'API. ------ #### [ Console ] **Pour configurer votre destination de messagerie bidirectionnelle à l'aide de la console** 1. Ouvrez la console de messagerie de l'utilisateur AWS final. 1. Dans le volet de navigation, choisissez les **agents RCS**. 1. Choisissez l'agent AWS RCS que vous souhaitez configurer. 1. Choisissez l'onglet **Messagerie bidirectionnelle**. 1. Choisissez **Modifier les paramètres**. 1. Activez l'option **Activer la messagerie bidirectionnelle**. 1. Pour le **sujet SNS**, choisissez un sujet Amazon SNS existant ou créez-en un nouveau. C'est dans cette rubrique que les messages entrants sont publiés. 1. Choisissez **Enregistrer**. ------ #### [ AWS CLI ] Pour configurer votre destination de messagerie bidirectionnelle à l'aide de l'API, appelez l'`UpdateRcsAgent`API avec les paramètres suivants : + `two-way-enabled`— Réglez sur pour `true` activer la messagerie bidirectionnelle. + `two-way-channel-arn`— L'ARN de la rubrique Amazon SNS dans laquelle les messages entrants sont publiés. + `two-way-channel-role`— L'ARN du rôle IAM qui accorde à l'utilisateur AWS final l'autorisation de publier des messages sur le sujet SNS. L'exemple suivant configure la destination de messagerie bidirectionnelle à l'aide de la CLI AWS  : ``` aws pinpoint-sms-voice-v2 update-rcs-agent \ --rcs-agent-id rcs-a1b2c3d4 \ --two-way-enabled \ --two-way-channel-arn arn:aws:sns:us-east-1:123456789012:MyRCSInboundTopic \ --two-way-channel-role arn:aws:iam::123456789012:role/SMSVoiceSNSPublishRole ``` ------ ### Autorisations des rubriques SNS La rubrique Amazon SNS que vous configurez pour la messagerie RCS bidirectionnelle doit autoriser l'utilisateur AWS final à y publier des messages. Deux options s'offrent à vous pour accorder l'accès. #### Option 1 : utiliser un rôle IAM Créez un rôle IAM que AWS la messagerie utilisateur final peut assumer pour publier des messages sur votre rubrique SNS. Le rôle nécessite à la fois une politique de confiance et une politique d'autorisation. Voici la **politique de confiance** pour le rôle IAM. *accountId*Remplacez-le par l'identifiant unique de votre Compte AWS. ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "SMSVoice", "Effect": "Allow", "Principal": { "Service": "sms-voice.amazonaws.com" }, "Action": "sts:AssumeRole", "Condition": { "StringEquals": { "aws:SourceAccount": "accountId" } } } ] } ``` Voici la **politique d'autorisation** pour le rôle IAM. Le `SMSVoiceAllowSNSPublish` Sid permet de publier sur des rubriques Amazon SNS et le `SMSVoiceAllowEncryptedSNSTopics` Sid est facultatif pour les rubriques Amazon SNS chiffrées. Effectuez les modifications suivantes : + *partition*Remplacez-la par la AWS partition dans laquelle vous utilisez AWS la messagerie utilisateur final. + *region*Remplacez-le par Région AWS celui dans lequel vous utilisez AWS la messagerie de l'utilisateur final. + *accountId*Remplacez-le par l'identifiant unique de votre Compte AWS. + *snsTopicName*Remplacez-le par le nom de la rubrique Amazon SNS qui reçoit les messages entrants. ``` { "Version": "2012-10-17", "Statement": [ { "Sid": "SMSVoiceAllowSNSPublish", "Effect": "Allow", "Action": "sns:Publish", "Resource": "arn:partition:sns:region:accountId:snsTopicName", "Condition": { "StringEquals": { "aws:ResourceAccount": "accountId" } } }, { "Sid": "SMSVoiceAllowEncryptedSNSTopics", "Effect": "Allow", "Action": [ "kms:Decrypt", "kms:GenerateDataKey*" ], "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:aws:sns:topicArn": "arn:partition:sns:region:accountId:snsTopicName", "aws:CalledViaLast": "sns.amazonaws.com" } } } ] } ``` #### Option 2 : Utiliser une politique de rubrique SNS Vous pouvez également ajouter une déclaration de politique directement à la rubrique SNS qui autorise AWS la messagerie utilisateur final à publier des messages. *snsTopicArn*Remplacez-le par l'ARN de votre rubrique SNS. ``` { "Effect": "Allow", "Principal": { "Service": "sms-voice.amazonaws.com" }, "Action": "sns:Publish", "Resource": "snsTopicArn" } ``` ## Format de charge utile des messages entrants Lorsque votre agent AWS RCS reçoit un message texte entrant, AWS End User Messaging publie une charge utile JSON dans la rubrique Amazon SNS configurée. La charge utile des messages entrants RCS utilise le même format que la messagerie bidirectionnelle SMS : ``` { "originationNumber": "+14255550182", "destinationNumber": "+12125550101", "messageKeyword": "JOIN", "messageBody": "EXAMPLE", "inboundMessageId": "cae173d2-66b9-564c-8309-21f858e9fb84", "previousPublishedMessageId": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" } ``` La charge utile des messages entrants contient les champs suivants : **Champs de charge utile des messages RCS entrants** | Champ | Description | | --- | --- | | `originationNumber` | Le numéro de téléphone qui a envoyé le message entrant (le numéro de téléphone du client). | | `destinationNumber` | L'identifiant de l'agent AWS RCS qui a reçu le message. | | `messageKeyword` | Le mot clé enregistré qui correspond au message entrant, le cas échéant. Les mots clés sont évalués par rapport au début du corps du message. | | `messageBody` | Le contenu textuel du message entrant. | | `inboundMessageId` | Identifiant unique pour le message entrant. | | `previousPublishedMessageId` | Identifiant unique du message sortant auquel le client répond, si le message entrant est une réponse à un message sortant précédent. | ## Types de messages pris en charge Le RCS dans AWS la messagerie utilisateur final prend actuellement en charge la réception de messages texte entrants. Lorsqu'un client envoie un message texte à votre agent AWS RCS, le message est envoyé à votre rubrique Amazon SNS configurée pour être traité. Si un client envoie un message multimédia (tel qu'une image, une vidéo ou un fichier) à votre agent AWS RCS, AWS End User Messaging enregistre le message avec le statut IGNORÉ. Les messages multimédias ne sont pas transmis à votre rubrique SNS et ne sont pas traités par votre application. Aucune erreur n'est renvoyée à l'expéditeur. ## Gestion des mots clés pour RCS Les mots clés vous permettent de configurer des réponses automatiques lorsque les clients envoient des mots ou des phrases spécifiques à votre agent AWS RCS. Lorsqu'un message entrant correspond à un mot clé configuré, AWS la messagerie utilisateur final renvoie le message de réponse automatique associé au client. Pour RCS, les mots clés sont configurés sur l'agent AWS RCS et s'appliquent à tous les RCS for Business associés IDs (agent de test et agents de lancement nationaux). Vous pouvez configurer jusqu'à 30 mots clés par agent AWS RCS. Pour gérer les mots clés de votre agent AWS RCS, utilisez la console de messagerie utilisateur AWS final ou l'API. Pour obtenir des informations générales sur la gestion des mots clés, consultez[Mots clés dans les SMS de messagerie destinés aux utilisateurs AWS finaux](keywords.md). **Note** Les mots clés configurés sur l'agent AWS RCS s'appliquent à tous les enregistrements associés. Vous ne pouvez pas définir des mots clés différents pour votre agent de test et les agents de lancement de votre pays indépendamment. ## Traitement des messages entrants avec Lambda Un modèle courant pour le traitement des messages RCS entrants consiste à abonner une fonction Lambda à la rubrique Amazon SNS configurée pour la messagerie bidirectionnelle. La fonction Lambda reçoit la charge utile des messages entrants et peut implémenter la logique de votre application, par exemple en répondant aux demandes des clients, en traitant des commandes ou en acheminant des messages vers d'autres systèmes. L'exemple Python suivant montre une fonction Lambda qui traite les messages RCS entrants et envoie une réponse à l'aide de l'API : `SendTextMessage` ``` import json import boto3 sms_client = boto3.client('pinpoint-sms-voice-v2') def lambda_handler(event, context): # Parse the SNS message for record in event['Records']: sns_message = json.loads(record['Sns']['Message']) origination_number = sns_message['originationNumber'] message_body = sns_message['messageBody'] keyword = sns_message.get('messageKeyword', '') print(f"Received message from {origination_number}: {message_body}") # Process the message and determine a response if keyword.upper() == 'HELP': response_text = 'Available commands: HELP, STATUS, STOP' elif keyword.upper() == 'STATUS': response_text = 'Your account is active. No action needed.' else: response_text = ( f'Thanks for your message. ' f'Reply HELP for available commands.' ) # Send a response back to the customer try: response = sms_client.send_text_message( DestinationPhoneNumber=origination_number, OriginationIdentity='pool-a1b2c3d4e5f6g7h8i', MessageBody=response_text, MessageType='TRANSACTIONAL' ) print(f"Response sent. Message ID: {response['MessageId']}") except Exception as e: print(f"Failed to send response: {str(e)}") return {'statusCode': 200} ``` Dans cet exemple, la fonction Lambda : 1. Analyse la charge utile des messages entrants provenant de l'événement SNS. 1. Vérifie le `messageKeyword` champ pour déterminer l'intention du client. 1. Envoie une réponse à l'aide de l'envoi basé sur le pool (recommandé) via l'`SendTextMessage`API. Le pool gère automatiquement la sélection des canaux. **Note** Lorsque vous envoyez des réponses à des messages entrants, utilisez l'envoi basé sur le pool pour garantir le remplacement automatique des SMS si l'appareil du client ne prend plus en charge le RCS. Pour plus de détails sur les modèles d'envoi, consultez[Envoi de messages RCS](rcs-send-message.md). ## Bonnes pratiques pour la messagerie RCS entrante Suivez ces bonnes pratiques lors de la mise en œuvre de la messagerie RCS bidirectionnelle : + **Implémentez la gestion des erreurs** : votre fonction Lambda ou votre abonné SNS doit gérer les erreurs correctement. Si votre fonction ne parvient pas à traiter un message, configurez une file d'attente de lettres mortes (DLQ) sur l'abonnement SNS afin de capturer les messages non traités pour une nouvelle tentative ultérieure. + **Envoyer des réponses de secours** : lorsque votre application reçoit un message qu'elle ne peut pas traiter, envoyez une réponse de secours utile plutôt que de laisser le client sans réponse. Par exemple, répondez avec les commandes disponibles ou dirigez le client vers un autre canal d'assistance. + **Utiliser l'envoi basé sur le pool pour les réponses** : lorsque vous envoyez des réponses à des messages entrants, utilisez l'envoi basé sur le pool pour garantir un retour automatique des SMS. Cela garantit que votre réponse parviendra au client même si son appareil ne prend plus en charge le RCS. + **Surveillez le traitement des messages** : utilisez CloudWatch les métriques Amazon pour surveiller le volume de vos messages entrants et le taux de réussite du traitement. Configurez des alarmes pour des modèles inhabituels, tels qu'une augmentation soudaine du nombre de messages entrants ou un taux élevé d'échecs de traitement. Pour plus de détails sur les métriques RCS, voir[CloudWatch Métriques et surveillance du RCS](rcs-monitoring.md). + **Gérez les réponses aux mots clés de manière cohérente** : assurez-vous que les réponses automatiques aux mots clés et les réponses programmatiques de votre application n'entrent pas en conflit. Si vous configurez une réponse automatique par mot clé pour un mot clé spécifique, votre fonction Lambda reçoit toujours le message. Concevez votre fonction de manière à éviter d'envoyer une double réponse pour les mots clés pour lesquels les réponses automatiques sont déjà configurées. # Lancement du RCS dans les pays Après avoir testé votre intégration de messagerie RCS à l'aide d'un agent de test, l'étape suivante consiste à lancer votre agent AWS RCS dans un ou plusieurs pays. Le lancement de chaque pays crée un RCS for Business ID distinct qui est approuvé pour chaque opérateur dans ce pays. AWS La messagerie destinée aux utilisateurs finaux soutient les lancements nationaux du RCS aux États-Unis d'Amérique et au Canada. Le processus de lancement par pays suit le chemin suivant : vous créez un agent AWS RCS, vous soumettez un enregistrement de test pour obtenir un agent de test, puis vous soumettez un ou plusieurs enregistrements de lancement par pays. L'enregistrement du lancement dans chaque pays fait l'objet d'un processus d'approbation distinct pour chaque opérateur de ce pays. **Note** La console de messagerie utilisateur AWS final présente la création d'agents AWS RCS et les tests d'enregistrement sous la forme d'un flux de travail guidé unique. Les utilisateurs de l'API peuvent créer l'agent AWS RCS séparément et peuvent techniquement ignorer l'enregistrement des tests, mais nous recommandons vivement de terminer les tests avant de soumettre les enregistrements de lancement par pays. Pour un aperçu de la relation entre l'agent AWS RCS et RCS for Business IDs, consultez. [Qu'est-ce que le RCS ?](rcs-overview.md) Pour en savoir plus sur la création et la gestion de votre agent AWS RCS, consultez[Gestion des agents RCS](rcs-agents.md). **Topics** + [Enregistrement des tests](#rcs-country-launch-testing-registration) + [Agent de test comme modèle pour les lancements par pays](#rcs-country-launch-template) + [Lancement aux États-Unis d'Amérique](#rcs-country-launch-us) + [Lancement au Canada](#rcs-country-launch-ca) + [Sélection de cas d'utilisation](#rcs-country-launch-use-cases) + [Gestion de l'état de l'enregistrement](#rcs-country-launch-registration-states) + [État de lancement par transporteur](#rcs-country-launch-carrier-status) + [Délais d'approbation du transporteur](#rcs-country-launch-timelines) + [Problèmes d'enregistrement courants et résolution des problèmes](#rcs-country-launch-troubleshooting) ## Enregistrement des tests Avant de pouvoir soumettre un enregistrement de lancement par pays, vous devez d'abord effectuer un enregistrement de test pour votre agent AWS RCS. L'enregistrement des tests crée un agent de test (un RCS for Business ID) que vous pouvez utiliser pour valider votre intégration avant de passer en production. Pour step-by-step obtenir des instructions sur la création d'un agent AWS RCS et la finalisation de l'enregistrement des tests, consultez[Débuter avec RCS](rcs-getting-started.md). Pour plus de détails sur la gestion des appareils de test et l'envoi de messages de test, consultez[Tester les messages RCS](rcs-testing.md). **Important** Les messages de test sont facturés aux tarifs RCS standard. ## Agent de test comme modèle pour les lancements par pays **Important** L'agent de test sert de modèle pour toutes les inscriptions de lancement dans votre pays. La configuration de marque que vous avez définie lors de l'enregistrement des tests est celle qui est préremplie dans le formulaire de lancement de chaque pays. Prenez le temps de configurer correctement votre agent de test avant de soumettre les lancements par pays. Lorsque vous soumettez un enregistrement de lancement par pays, la console de messagerie destinée à l'utilisateur AWS final remplit automatiquement le formulaire d'enregistrement avec la configuration de marque fournie par votre agent de test. Cela inclut le nom de votre marque, votre logo, l'image de bannière, la couleur de votre marque, votre description et l'URL de votre site Web. Vous pouvez personnaliser les champs pour chaque pays de lancement. Par exemple, vous pouvez ajuster le nom, le logo, l'image de bannière ou les coordonnées de l'agent destiné aux consommateurs en fonction des exigences locales. Les pays peuvent avoir différents actifs de marque. L'agent de test fournit le point de départ, mais chaque pays de lancement peut être personnalisé indépendamment. ## Lancement aux États-Unis d'Amérique Pour lancer votre agent AWS RCS aux États-Unis d'Amérique, soumettez un enregistrement de lancement par pays en utilisant `US_RCS_LAUNCH` le type d'enregistrement. L'enregistrement du lancement aux États-Unis nécessite des informations supplémentaires au-delà de celles que vous avez fournies lors de l'enregistrement des tests. ### Exigences d'enregistrement aux États-Unis L'enregistrement du lancement aux États-Unis nécessite les informations suivantes : + **Informations sur la marque** : renseignées automatiquement à partir de la configuration de votre agent de test. Vous pouvez consulter et modifier le nom de la marque, la description, l'URL du site Web et les coordonnées. + **Sélection de cas d'utilisation** : sélectionnez la catégorie de cas d'utilisation pour votre messagerie RCS. Les catégories disponibles incluent OTP (mots de passe à usage unique), transactionnel, promotionnel et à usage multiple. + **Enregistrement d'écran** — Vous devez fournir un enregistrement d'écran illustrant votre expérience de messagerie RCS. L'enregistrement doit montrer l'expérience de l'utilisateur final en matière de réception et d'interaction avec vos messages RCS. Il s'agit d'une exigence spécifique au lancement aux États-Unis. + **Politique de confidentialité et conditions d'utilisation** : sur URLs les pages de votre politique de confidentialité et de vos conditions d'utilisation. **Important** L'exigence d'enregistrement d'écran est spécifique à l'enregistrement du lancement aux États-Unis. Vous devez fournir un enregistrement qui démontre clairement votre cas d'utilisation de la messagerie RCS. Les inscriptions soumises sans enregistrement d'écran valide sont rejetées. ## Lancement au Canada Pour lancer votre agent AWS RCS au Canada, soumettez un enregistrement de lancement par pays en utilisant le type `CA_RCS_LAUNCH` d'enregistrement. L'enregistrement du lancement au Canada comporte des exigences de champs de formulaire différentes de celles du lancement aux États-Unis. ### Exigences d'enregistrement au Canada L'enregistrement du lancement au Canada nécessite les informations suivantes : + **Informations sur la marque** : renseignées automatiquement à partir de la configuration de votre agent de test. Vous pouvez consulter et modifier le nom de la marque, la description, l'URL du site Web et les coordonnées du marché canadien. + **Sélection de cas d'utilisation** : sélectionnez la catégorie de cas d'utilisation pour votre messagerie RCS. Les catégories disponibles incluent OTP (mots de passe à usage unique), transactionnel, promotionnel et à usage multiple. + **Politique de confidentialité et conditions d'utilisation** : sur URLs les pages de votre politique de confidentialité et de vos conditions d'utilisation. **Note** L'enregistrement du lancement au Canada ne nécessite pas d'enregistrement d'écran. Les exigences relatives aux champs du formulaire sont différentes de celles requises pour l'enregistrement du lancement aux États-Unis. Lisez attentivement le formulaire d'inscription pour vous assurer que tous les champs obligatoires sont remplis pour le marché canadien. ## Sélection de cas d'utilisation Lorsque vous soumettez un enregistrement de lancement par pays, vous devez sélectionner une catégorie de cas d'utilisation décrivant la manière dont vous comptez utiliser la messagerie RCS. La catégorie de cas d'utilisation est examinée par les transporteurs dans le cadre du processus d'approbation. Les catégories de cas d'utilisation suivantes sont disponibles : **Important** Des exemples de cas d'utilisation doivent être fournis pour que votre agent soit lancé. Sélectionnez le cas d'utilisation approprié, car cela détermine la configuration et les capacités de votre agent. Une sélection incorrecte peut entraîner des retards ou des problèmes de déploiement. **OTP (mot de passe à usage unique)** Utilisé pour l'authentification du compte ou la confirmation sécurisée des transactions. **Non autorisé :** mises à jour de produits, offres ou promotions. **Transactionnel** Envoyez des notifications et des mises à jour relatives aux produits ou services du client (par exemple, alertes, confirmations, mises à jour de compte). **Non autorisés :** offres, promotions, remises ou surclassements. **Promotionnel** Utilisé pour les offres, les promotions et les messages marketing visant à augmenter les ventes, y compris les rappels en cas de transactions incomplètes. **Non autorisés :** OTPs, 2FA ou notifications transactionnelles urgentes. **Multi-usage** Utilisé lorsque la messagerie inclut à la fois des messages transactionnels et promotionnels (par exemple, l'envoi d'une confirmation d'achat suivie d'une offre associée). **Non autorisé :** OTP/2FA, réinitialisation du mot de passe ou utilisation purement transactionnelle ou purement promotionnelle. ## Gestion de l'état de l'enregistrement Les inscriptions aux lancements par pays sont soumises à un processus d'approbation en plusieurs étapes. Vous pouvez suivre la progression de votre enregistrement à l'aide de deux ensembles d'états : les états d'enregistrement et les états des versions d'enregistrement. ### États d'enregistrement L'état d'enregistrement suit le statut général de l'enregistrement des lancements dans votre pays : **CRÉÉ** L'enregistrement a été créé mais n'a pas encore été soumis. Vous pouvez modifier les champs du formulaire d'inscription dans cet état. **SUBMITTED** L'enregistrement a été soumis et est en attente d'examen. **RÉVISION** L'enregistrement est en cours de révision par les transporteurs. Vous ne pouvez pas modifier l'enregistrement tant qu'il est dans cet état. **TERMINÉ** L'enregistrement a été approuvé et l'agent de lancement national (RCS for Business ID) est actif. Votre agent AWS RCS peut envoyer des messages dans ce pays. **NÉCESSITE DES MISES À JOUR** L'enregistrement nécessite des modifications avant de pouvoir être approuvé. Passez en revue les commentaires fournis, mettez à jour les champs obligatoires et soumettez à nouveau l'enregistrement. **FERMÉ** Les inscriptions ont été clôturées. Les ressources associées ont été supprimées. **SUPPRIMÉ** L'enregistrement a été supprimé. ### États de la version d'enregistrement Chaque enregistrement peut avoir plusieurs versions. L'état de la version suit le statut d'une version spécifique de l'enregistrement : **BROUILLON** La version est en cours de préparation et n'a pas été soumise. Vous pouvez modifier les champs du formulaire dans cet état. **SUBMITTED** La version a été soumise pour examen. **RÉVISION** La version est en cours de révision par les transporteurs. **APPROUVÉ** La version a été approuvée. L'agent de lancement national est actif pour ce pays. **REFUSÉ** La version a été refusée. Passez en revue les commentaires et soumettez une nouvelle version avec les modifications requises. **RÉVOQUÉ** Une version précédemment approuvée a été révoquée. L'agent de lancement du pays n'est plus actif. **ARCHIVÉ** La version a été archivée. Il ne s'agit plus de la version active mais elle est conservée à titre de référence historique. **MIS AU REBUT** La version a été supprimée avant d'être soumise. ## État de lancement par transporteur Une fois que vous avez soumis un enregistrement de lancement par pays, chaque opérateur de ce pays examine et approuve indépendamment votre agent AWS RCS. Vous pouvez suivre le statut d'approbation à la fois au niveau de chaque transporteur et au niveau agrégé du pays. ### États porteurs Chaque transporteur d'un pays possède l'un des états d'approbation suivants : **EN SUSPENS** Le transporteur passe en revue votre agent. Aucune action n'est requise de votre part. **ACTIF** Le transporteur a approuvé votre agent. Votre agent AWS RCS peut envoyer des messages RCS aux destinataires sur le réseau de cet opérateur. **REJETÉ** Le transporteur a rejeté votre agent. Vérifiez le motif du rejet et soumettez une nouvelle version d'enregistrement avec les modifications requises. ### États agrégés par pays L'état agrégé au niveau du pays résume le statut d'approbation du transporteur pour tous les transporteurs d'un pays : **EN SUSPENS** Tous les transporteurs du pays évaluent toujours votre agent. Aucun transporteur n'a encore approuvé ou rejeté l'agent. **PARTIEL** Au moins un transporteur a approuvé votre agent, mais tous les transporteurs n'ont pas terminé leur examen. Votre agent AWS RCS peut envoyer des messages aux destinataires via des transporteurs agréés. **ACTIF** Tous les transporteurs du pays ont approuvé votre agent. Votre agent AWS RCS dispose d'une portée complète dans ce pays. **REJETÉ** Tous les transporteurs du pays ont refusé votre agent. Votre agent AWS RCS peut envoyer des messages dans un pays dès qu'au moins un opérateur de ce pays a approuvé l'agent. Vous n'avez pas besoin d'attendre l'approbation de tous les opérateurs pour commencer à envoyer des messages RCS. Lorsqu'un destinataire utilise un opérateur qui n'a pas encore approuvé votre agent, AWS la messagerie utilisateur final revient automatiquement aux SMS si vous utilisez l'envoi par pool ou au niveau du compte. Au fur et à mesure que d'autres transporteurs approuvent votre agent, votre portée RCS augmente dans ce pays. Pour consulter le statut de lancement par opérateur de votre agent AWS RCS, utilisez l'`DescribeRcsAgentCountryLaunchStatus`API ou accédez à l'onglet **État de lancement par pays** sur la page des détails de l'agent dans la console de messagerie utilisateur AWS final. ## Délais d'approbation du transporteur L'approbation des transporteurs pour les lancements du RCS dans les pays est un processus en plusieurs étapes qui implique un examen par chaque transporteur dans le pays cible. Les délais d'approbation varient en fonction du transporteur et de l'exhaustivité de votre enregistrement. Aux États-Unis d'Amérique et au Canada, attendez-vous à ce que le processus d'approbation du transporteur prenne plusieurs mois à compter de la date de soumission de l'enregistrement du lancement dans votre pays. Le calendrier inclut la révision initiale, les mises à jour requises et le déploiement par opérateur. Pour garantir le bon déroulement du processus d'approbation : + Complétez tous les champs d'inscription obligatoires avec précision avant de soumettre. + Pour les lancements aux États-Unis, fournissez un enregistrement d'écran clair et complet illustrant votre cas d'utilisation de la messagerie RCS. + Répondez rapidement à tout commentaire REQUIRES\$1UPDATES issu du processus de révision. + Assurez-vous que votre politique de confidentialité et vos conditions d'utilisation URLs sont accessibles et à jour. ## Problèmes d'enregistrement courants et résolution des problèmes Les sections suivantes décrivent les problèmes courants que vous pouvez rencontrer lors du processus d'enregistrement du lancement par pays et la manière de les résoudre. ### L'inscription nécessite des mises à jour Si votre enregistrement passe à l'état REQUIRES\$1UPDATES, consultez les commentaires fournis dans les détails de l'enregistrement. Les raisons courantes incluent : + Informations de marque incomplètes ou inexactes. + Enregistrement d'écran manquant ou non valide (lancements aux États-Unis uniquement). + Politique de confidentialité ou conditions d'utilisation URLs inaccessibles ou ne répondant pas aux exigences. + Description du cas d'utilisation qui n'explique pas clairement l'objectif de votre message. Mettez à jour les champs obligatoires et soumettez à nouveau l'enregistrement. L'enregistrement revient à l'état SOUMIS et est revu. ### Le transporteur a rejeté l'agent Si un transporteur rejette votre agent AWS RCS, vérifiez le motif du rejet indiqué dans les informations relatives au statut du transporteur. Les raisons de rejet les plus courantes incluent : + Des actifs de marque qui ne répondent pas aux normes de qualité du transporteur. + Cas d'utilisation non conforme aux politiques de messagerie de l'opérateur. + Informations insuffisantes sur l'activité ou l'objectif de la messagerie. Répondez aux commentaires de rejet et soumettez une nouvelle version d'enregistrement. Notez qu'un rejet par un transporteur n'affecte pas le statut d'approbation des autres transporteurs du même pays. ### Inscription en cours de révision pour une période prolongée Les délais d'approbation des transporteurs aux États-Unis d'Amérique et au Canada sont généralement de plusieurs mois. Si votre inscription est restée en cours de révision plus longtemps que prévu : + Vérifiez que le statut REQUIRES\$1UPDATES de votre inscription ne vous aurait pas été attribué. + Vérifiez le statut de chaque transporteur à l'aide de l'`DescribeRcsAgentCountryLaunchStatus`API pour voir si certains transporteurs ont déjà approuvé leur demande alors que d'autres sont encore en train de l'examiner. + Contactez le AWS Support si vous avez besoin d'aide concernant un enregistrement en cours d'examen depuis un temps anormalement long. ### Motifs du refus d'enregistrement Lorsqu'un enregistrement est refusé, AWS la messagerie à l'utilisateur final fournit une raison de refus expliquant pourquoi l'enregistrement n'a pas été approuvé. Le tableau suivant répertorie toutes les raisons du refus d'enregistrement RCS et les mesures recommandées pour chacune d'entre elles. **Motifs du refus d'enregistrement au RCS** | Motif du refus | Description | Action recommandée | | --- | --- | --- | | REQUIRES\$1OFFLINE\$1REVIEW | Cet enregistrement nécessite un examen manuel hors ligne. | Créez un dossier de support dans le Centre de AWS support. Choisissez la catégorie d'assistance des agents RCS et incluez votre numéro d'enregistrement. Consultez [Obtenez plus d'informations Support pour les problèmes d'enregistrement](registrations-request-support.md). | | CANNOT\$1UPDATE\$1REGISTRATION | Certains champs d'agent RCS ne peuvent pas être modifiés sur un enregistrement existant. | Créez un nouvel enregistrement de test avec les champs corrigés. | | IMAGE\$1URL\$1INACCESSIBLE | L'URL de l'image fournie n'est pas accessible au public. | Fournissez une URL accessible sans authentification. Mettez à jour l'enregistrement et soumettez-le à nouveau. | | IMAGE\$1FORMAT\$1INVALID | L'image doit être au format JPEG ou PNG. | Téléchargez une image dans le bon format et soumettez-la à nouveau. | | IMAGE\$1RESOLUTION\$1INVALID | L'image ne répond pas à la résolution requise. Le logo doit mesurer 224 x 224 pixels et la bannière doit mesurer 1440 x 448 pixels. | Redimensionnez l'image aux dimensions requises et soumettez-la à nouveau. | | IMAGE\$1SIZE\$1EXCEEDED | La taille du fichier image dépasse la limite autorisée. Le logo ne doit pas dépasser 50 Ko et la bannière ne doit pas dépasser 200 Ko. | Réduisez la taille du fichier et soumettez-le à nouveau. | | ACCENT\$1COLOR\$1CONTRAST\$1INSUFFICIENT | La couleur d'accent doit avoir un rapport de contraste d'au moins 4, 5:1 par rapport au blanc. | Choisissez une couleur d'accent plus foncée qui répond aux exigences de contraste et soumettez-la à nouveau. | | PRIVACY\$1POLICY\$1INACCESSIBLE | L'URL de la politique de confidentialité fournie n'est pas accessible ou n'est pas valide. | Fournissez une URL de politique de confidentialité accessible au public et soumettez-la à nouveau. | | TERMS\$1AND\$1CONDITIONS\$1INACCESSIBLE | L'URL des conditions générales fournie n'est pas accessible ou n'est pas valide. | Fournissez une URL de conditions générales accessible au public et soumettez-la à nouveau. | | CONTACT\$1DETAILS\$1MISSING | Au moins une méthode de contact (téléphone, e-mail ou site Web) est requise dans le profil de l'agent, et chaque valeur de contact doit avoir une étiquette correspondante. | Ajoutez au moins une méthode de contact à votre profil d'agent. Assurez-vous que chaque valeur de contact possède une étiquette correspondante (par exemple, si vous fournissez un numéro de téléphone, fournissez également une étiquette de téléphone). Mettez à jour l'enregistrement et soumettez-le à nouveau. | Pour les raisons de refus nécessitant l'assistance du AWS Support, créez un dossier d'assistance dans le [Centre de AWS support](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase). Indiquez votre identifiant d'agent AWS RCS et votre numéro d'enregistrement dans la description du dossier. # CloudWatch Métriques et surveillance du RCS AWS La messagerie utilisateur final publie les métriques de messagerie RCS CloudWatch dans l'espace de `AWS/SMSVoice` noms. Vous pouvez utiliser ces mesures pour surveiller la livraison de vos messages RCS, suivre le comportement de repli entre RCS et SMS et définir des alarmes pour vous avertir lorsque les habitudes de diffusion changent. Les métriques RCS sont publiées avec les métriques SMS et MMS existantes dans le même espace de noms. **Topics** + [Métriques de messagerie RCS](#rcs-monitoring-rcs-metrics) + [Métriques existantes modifiées avec OriginationIdentityType dimension](#rcs-monitoring-modified-metrics) + [Dimensions métriques RCS](#rcs-monitoring-dimensions) + [Métriques des messages RCS entrants](#rcs-monitoring-inbound) + [Meilleures pratiques de surveillance pour le RCS](#rcs-monitoring-best-practices) ## Métriques de messagerie RCS L'espace de `AWS/SMSVoice` noms inclut les métriques suivantes spécifiques à la messagerie RCS. Ces statistiques permettent de suivre l'envoi et la livraison des messages RCS ainsi que le traitement de secours des SMS. **Métriques de messagerie RCS** | Métrique | Description | Unit | Statistiques significatives | | --- | --- | --- | --- | | RCS.MessagesSent | Le nombre de messages RCS envoyés. Cette métrique compte les messages que AWS End User Messaging a acceptés et a tenté de transmettre via RCS. Les messages bloqués par Protect ou les limites de service sont exclus de ce décompte. | Nombre | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sms-voice/latest/userguide/rcs-monitoring.html) | | RCS.MessagesDelivered | Le nombre de messages RCS envoyés avec succès à l'appareil du destinataire. Un message est considéré comme délivré lorsque AWS la messagerie de l'utilisateur final reçoit une confirmation de livraison de l'infrastructure RCS. | Nombre | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sms-voice/latest/userguide/rcs-monitoring.html) | | RCS.MessagesFallenBackToSMS | Le nombre de messages initialement tentés via RCS mais dont l'envoi par SMS est revenu. Cette métrique vous aide à comprendre à quelle fréquence la livraison RCS n'est pas disponible pour vos destinataires et peut être utilisée pour suivre les taux de repli au fil du temps. | Nombre | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/sms-voice/latest/userguide/rcs-monitoring.html) | ## Métriques existantes modifiées avec OriginationIdentityType dimension Avec l'ajout de RCS, plusieurs métriques existantes dans l'espace de `AWS/SMSVoice` noms prennent désormais en charge cette dimension. `OriginationIdentityType` Cette dimension vous permet de filtrer les métriques en fonction du type d'identité d'origine utilisé pour envoyer le message, y compris les agents AWS RCS. Les métriques existantes suivantes incluent désormais la `OriginationIdentityType` dimension : + `NumberOfTextMessagePartsSent`— Filtrez par type d'identité d'origine pour voir combien de parties du message texte ont été envoyées via chaque canal (numéro de téléphone, identifiant de l'expéditeur, agent AWS RCS ou pool). + `NumberOfTextMessagePartsDelivered`— Filtrez par type d'identité d'origine pour comparer les taux de livraison entre les canaux. + `NumberOfMediaMessagePartsSent`— Filtrez par type d'identité d'origine pour suivre l'envoi des messages multimédias par canal. + `NumberOfMediaMessagePartsDelivered`— Filtrez par type d'identité d'origine pour comparer la diffusion des messages multimédias sur les différents canaux. + `TextMessagesBlockedByProtect`— Filtrez par type d'identité d'origine pour voir quelles chaînes ont des messages bloqués par les règles de protection. + `MediaMessagesBlockedByProtect`— Filtrez par type d'identité d'origine pour suivre le blocage de Protect par canal. Utilisez la `OriginationIdentityType` dimension dont la valeur est égale `RCS_AGENT` à pour isoler les métriques des messages envoyés via votre agent AWS RCS. Pour plus d'informations sur les valeurs de dimension disponibles, consultez[Dimensions métriques RCS](#rcs-monitoring-dimensions). ## Dimensions métriques RCS Vous pouvez utiliser les dimensions suivantes pour filtrer et regrouper les métriques RCS. Ces dimensions sont disponibles à la fois pour les nouvelles métriques spécifiques au RCS et pour les métriques existantes modifiées décrites dans les sections précédentes. ### OriginationIdentityType dimension La `OriginationIdentityType` dimension filtre les métriques en fonction du type d'identité d'origine utilisé pour envoyer le message. **OriginationIdentityType valeurs de dimension** | Value | Description | | --- | --- | | PHONE\$1NUMBER | Messages envoyés à l'aide d'un numéro de téléphone (code long, code abrégé ou numéro gratuit). | | SENDER\$1ID | Messages envoyés à l'aide d'un identifiant d'expéditeur. | | RCS\$1AGENT | Messages envoyés à l'aide d'un agent AWS RCS. | | POOL | Messages envoyés via un pool téléphonique. Lorsque vous envoyez via un pool, AWS la messagerie destinée à l'utilisateur final sélectionne automatiquement l'identité d'origine appropriée (agent AWS RCS ou numéro de téléphone). | ### MessageType dimension La `MessageType` dimension filtre les métriques en fonction du type de message. **MessageType valeurs de dimension** | Value | Description | | --- | --- | | TEXT | SMS envoyés via RCS ou SMS. | | MEDIA | Messages multimédias (MMS). Le RCS dans AWS la messagerie utilisateur final ne prend actuellement en charge que les messages texte. | | DELIVERY\$1REPORT | Messages de rapport de livraison confirmant l'état de livraison du message. | **Note** Le type de `READ_REPORT` message n'est pas disponible car les accusés de lecture ne sont pas pris en charge dans la version actuelle de RCS dans AWS la messagerie utilisateur final. ## Métriques des messages RCS entrants La `NumberOfMessagesReceived` métrique existante dans l'espace de `AWS/SMSVoice` noms inclut désormais les messages RCS entrants. Vous pouvez utiliser la `OriginationIdentityType` dimension avec une valeur égale `RCS_AGENT` à pour filtrer les messages entrants reçus via votre agent AWS RCS. Les dimensions suivantes sont disponibles pour les métriques des messages RCS entrants : + `OriginationIdentityType`— `RCS_AGENT` À utiliser pour filtrer les messages RCS entrants. + `IsoCountryCode`— Filtrez selon le code de pays de l'expéditeur du message entrant. + `MessageType`— `TEXT` À utiliser pour filtrer les messages texte reçus via RCS. Dans la version actuelle, RCS in AWS End User Messaging ne prend en charge que les messages texte entrants. ## Meilleures pratiques de surveillance pour le RCS Utilisez les meilleures pratiques suivantes pour surveiller vos opérations de messagerie RCS et identifier rapidement les problèmes de diffusion. ### Suivez les taux de livraison du RCS par rapport aux SMS `RCS.MessagesDelivered`Comparez-les `RCS.MessagesFallenBackToSMS` pour savoir quel pourcentage de vos messages sont envoyés par RCS par rapport aux SMS. Un taux de repli élevé peut indiquer que bon nombre de vos destinataires utilisent des opérateurs ou des appareils qui ne prennent pas en charge le RCS. Utilisez les formules suivantes pour calculer les taux directeurs : ``` RCS delivery rate = 100 * SUM(RCS.MessagesDelivered) / SUM(RCS.MessagesSent) SMS fallback rate = 100 * SUM(RCS.MessagesFallenBackToSMS) / SUM(RCS.MessagesSent) ``` Suivez ces taux au fil du temps pour identifier les tendances à mesure que la prise en charge du RCS par les opérateurs et les appareils prend de l'ampleur. Un taux de repli décroissant indique qu'un plus grand nombre de vos destinataires reçoivent des messages via RCS. ### Définissez des CloudWatch alarmes pour les métriques RCS Créez des CloudWatch alarmes pour vous avertir lorsque les modèles de messagerie RCS changent de façon inattendue. Envisagez de configurer des alarmes pour les conditions suivantes : + **Taux de repli élevé** : définissez une alarme lorsque vous `RCS.MessagesFallenBackToSMS` dépassez un pourcentage seuil de`RCS.MessagesSent`. Une augmentation soudaine du nombre de solutions de secours peut indiquer un problème avec votre agent AWS RCS ou une panne d'opérateur. + **Baisse du taux de livraison** — Réglez une alarme lorsque le ratio `RCS.MessagesDelivered` de/ `RCS.MessagesSent` tombe en dessous de votre taux de livraison attendu. + **Volume des messages entrants** : si vous utilisez la messagerie RCS bidirectionnelle, activez une alarme `NumberOfMessagesReceived` (filtrée par`OriginationIdentityType = RCS_AGENT`) pour détecter les modifications inattendues du volume des messages entrants. # Modèle de facturation et de tarification RCS La messagerie RCS dans AWS la messagerie destinée aux utilisateurs finaux utilise un modèle de tarification comportant deux éléments de coût : des frais de AWS message et des frais de transporteur qui sont répercutés sans majoration. Ce chapitre explique la structure tarifaire de la messagerie RCS. Pour connaître les tarifs actuels, consultez [AWS la section Tarification des messages destinés aux utilisateurs finaux](https://aws.amazon.com//end-user-messaging/pricing/). AWS Les frais de messagerie destinés aux utilisateurs finaux ne sont facturés pour les messages RCS que lorsqu'ils sont correctement transmis à l'appareil du destinataire. Les tentatives de livraison qui échouent ne vous sont pas facturées. Si un message RCS échoue et revient à un SMS, vous êtes facturé pour le message SMS envoyé, et non pour l'échec de la tentative de RCS. **Topics** + [Aperçu de la facturation](#rcs-billing-overview) + [Modèle de tarification des États-Unis d'Amérique](#rcs-billing-us-pricing) + [Modèle de tarification du Canada](#rcs-billing-ca-pricing) + [Frais d'inscription](#rcs-billing-registration-fees) + [Facturation en cas de double livraison](#rcs-billing-double-delivery) + [Frais de violation de contenu](#rcs-billing-content-violations) + [Transparence des factures](#rcs-billing-transparency) ## Aperçu de la facturation La facturation RCS dans AWS la messagerie destinée aux utilisateurs finaux comprend les éléments suivants : + **Frais de message — Frais** par message pour les messages RCS sortants et entrants, basés sur les segments de message. + **Frais de transport — Frais** de transfert facturés par les transporteurs sans AWS majoration. + **Frais d'inscription — Frais** uniques et récurrents pour la configuration des agents, le contrôle de la marque et la maintenance. Chaque composant apparaît sur une ligne distincte sur votre AWS facture, ce qui vous donne une visibilité sur vos coûts de messagerie RCS. ## Modèle de tarification des États-Unis d'Amérique **La messagerie RCS aux États-Unis d'Amérique utilise un type de message appelé Rich RCS.** Les messages RCS enrichis sont mesurés par segment de 160 caractères, comme les SMS. Les messages de plus de 160 caractères sont facturés pour plusieurs segments. Chaque message Rich RCS sortant ou entrant comporte deux éléments de coût : **Frais de transport des messages** Les frais par segment facturés par AWS pour le traitement et la livraison du message RCS. **Frais du transporteur (transfert)** Les frais par segment facturés par le transporteur pour la livraison des messages RCS. AWS vous fait bénéficier de ces frais sans majoration. Les frais du transporteur sont distincts des frais de transport des messages. Le coût total par message correspond aux frais de transport du message plus les frais du transporteur. Les messages RCS entrants (messages envoyés par les utilisateurs finaux à votre agent AWS RCS) suivent la même structure tarifaire à deux composants. **Note** Les messages RCS ne sont facturés que pour les messages délivrés. Cela diffère des SMS, qui facturent les messages demandés. Pour connaître les tarifs actuels par segment, consultez la section [Tarification des messages destinés aux utilisateurs AWS finaux](https://aws.amazon.com//end-user-messaging/pricing/). ## Modèle de tarification du Canada La messagerie RCS au Canada utilise deux types de messages : **RCS Basic** Messages de 160 caractères maximum. Facturé par message. **RCS Single** Messages de plus de 160 caractères. Facturé en tant que message unique, et non en plusieurs segments. Cela diffère des États-Unis d'Amérique, où les messages Rich RCS de plus de 160 caractères sont mesurés par segment de 160 caractères, comme les SMS. Chaque message RCS sortant ou entrant au Canada comporte deux éléments de coût : des frais de transport du message et des frais de transfert du transporteur. **Note** Les messages RCS ne sont facturés que pour les messages délivrés. Cela diffère des SMS, qui facturent les messages demandés. Pour connaître les tarifs actuels, consultez [AWS la section Tarification des messages destinés aux utilisateurs finaux](https://aws.amazon.com//end-user-messaging/pricing/). ## Frais d'inscription Le lancement d'un agent AWS RCS nécessite un enregistrement auprès du fournisseur d'infrastructure RCS. Les frais de transfert du transporteur suivants s'appliquent au processus d'enregistrement : **Frais de configuration uniques pour l'agent** Des frais uniques sont facturés lorsque vous créez et enregistrez votre agent AWS RCS. Cela couvre la configuration initiale et la vérification de votre agent auprès du fournisseur d'infrastructure RCS. **Frais annuels de vérification de marque** Des frais annuels pour vérifier l'identité de votre marque. Le contrôle de marque confirme que votre organisation est légitime et autorisée à envoyer des messages RCS sous votre nom de marque. **Frais de maintenance mensuels de l'agent** Des frais mensuels récurrents pour le maintien de votre inscription active à l'agent AWS RCS auprès du fournisseur d'infrastructure RCS. Ces frais d'inscription sont des frais répercutés par le transporteur. Pour connaître les montants actuels des frais d'inscription, consultez [AWS la section Tarification des messages destinés aux utilisateurs finaux](https://aws.amazon.com//end-user-messaging/pricing/). **Important** Les frais d'inscription au RCS sont exclus des remises du Enterprise Discount Program (EDP). Ces frais sont des frais répercutés par le fournisseur d'infrastructure RCS et ne sont pas éligibles AWS aux remises de volume. Les frais d'inscription apparaissent sous forme de rubriques distinctes sur votre AWS facture. Pour plus de détails sur la manière dont les frais sont classés, consultez votre rapport sur les AWS coûts et l'utilisation. ## Facturation en cas de double livraison Lorsque AWS la messagerie de l'utilisateur final envoie un message RCS avec la fonction de secours par SMS activée (par le biais d'un envoi basé sur un pool ou au niveau du compte), le service tente d'abord de délivrer le RCS. Si la livraison du RCS échoue, le service revient aux SMS. Dans des circonstances normales, le message RCS est révoqué avant que le message de secours SMS ne soit délivré. Dans ce cas, vous êtes facturé uniquement pour le message SMS qui a été envoyé avec succès. Dans de rares cas, le message RCS et le message de secours SMS peuvent être remis au destinataire. Cela peut se produire si le message RCS est délivré après la fenêtre de révocation mais avant l'arrivée du message SMS. En cas de double livraison, le message RCS et le message SMS vous sont facturés. **Note** La double livraison est rare. AWS La messagerie destinée à l'utilisateur final est conçue pour révoquer le message RCS avant de lancer le système de secours par SMS. Surveillez vos reçus de livraison et vos CloudWatch statistiques pour suivre l'attribution des canaux de livraison. Pour plus d'informations sur les métriques RCS, consultez[CloudWatch Métriques et surveillance du RCS](rcs-monitoring.md). ## Frais de violation de contenu Il est de la responsabilité de tout expéditeur de message RCS de se conformer aux lois et réglementations du pays en matière de messagerie, ainsi qu'aux politiques du transporteur. Les opérateurs peuvent imposer des pénalités pour les messages RCS qui enfreignent leurs politiques relatives au contenu des messages. Ces pénalités sont des frais imposés par l'opérateur qui AWS peuvent être répercutés sur les clients qui envoient des messages RCS signalés par les opérateurs comme violant leurs politiques relatives au contenu des messages. Les opérateurs classent généralement les violations de contenu selon les niveaux suivants : **Niveau 1 — Hameçonnage, smishing et ingénierie sociale** L'ingénierie sociale fait référence à la pratique qui consiste à cibler des individus de manière à les manipuler afin de révéler des informations privées telles que des numéros de carte de crédit ou des numéros de sécurité sociale. **Niveau 2 — Contenu illégal** Le contenu doit être légal dans les 50 États et au niveau fédéral. Le contenu illégal inclut, sans toutefois s'y limiter, le cannabis, la marijuana, le CBD, les ordonnances illégales et la sollicitation. **Niveau 3 — Autres violations** Toutes les autres violations des messages commerciaux qui enfreignent les lois, réglementations ou codes de conduite des opérateurs fédéraux, étatiques ou locaux en matière de contenu interdit. Pour plus d'informations sur le montant des frais de violation de contenu, consultez [AWS la section Tarification des messages destinés aux utilisateurs finaux](https://aws.amazon.com//end-user-messaging/pricing/). ## Transparence des factures Les frais RCS apparaissent sous forme de lignes distinctes sur votre AWS facture, ce qui vous permet de faire la distinction entre les catégories de coûts suivantes : + Frais de message RCS (AWS frais) + Frais du transporteur RCS (frais de transfert) + Frais d'inscription au RCS (frais de transfert) + Frais de SMS (pour les messages renvoyés du RCS au SMS) Cette séparation vous aide à comprendre vos coûts de messagerie et à identifier les opportunités d'optimisation de vos dépenses. Pour obtenir des informations de facturation détaillées, consultez votre rapport sur les AWS coûts et l'utilisation.