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. # 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.