View a markdown version of this page

Tester les messages RCS - AWS Messagerie SMS à l'utilisateur final
Qu'est-ce qu'un agent de test ?Ajouter des appareils de testFlux d'invitation aux testeursAffichage des appareils de testEnvoi de messages de testTester la solution de secours par SMSRésolution des problèmes liés aux tests RCS

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 Pour plus d'informations sur la création d'un agent AWS RCS et la soumission d'un enregistrement de test, consultezGestion des agents RCS.

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.

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'SendTextMessageAPI 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'CreateVerifiedDestinationNumberAPI.

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.

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

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'DescribeVerifiedDestinationNumbersAPI.

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'SendTextMessageAPI.

Console
Pour envoyer un message de test à l'aide de la console

  1. Ouvrez la console de messagerie de l'utilisateur AWS final.

  2. Dans le volet de navigation, sous Configurations, choisissez les agents RCS.

  3. Choisissez l'agent AWS RCS que vous souhaitez tester.

  4. Choisissez l'onglet Tests.

  5. Dans la section Envoyer un message de test, choisissez un appareil de test vérifié dans la liste.

  6. Entrez le texte de votre message.

  7. 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, consultezTester la solution de secours par SMS.

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'DescribeVerifiedDestinationNumbersAPI 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.

  2. Appuyez sur Filtres dans le coin supérieur gauche (ou balayez vers la droite depuis la liste des messages).

  3. Appuyez sur Expéditeurs inconnus.

  4. Recherchez le message de gestion de RBM Tester et appuyez sur Make me a tester pour accepter l'invitation.