View a markdown version of this page

Messages RCS de test - AWS Messagerie SMS pour l'utilisateur final
Qu'est-ce qu'un agent de test ?Ajouter des appareils de testFlux d'invitation des testeursVisualisation 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.

Messages RCS de test

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 qui est 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 l'envoi des messages aux seuls appareils de test enregistrés. 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 une présentation étape par étape de la création de votre premier agent AWS RCS et de l'envoi d'un message de test, consultez. Prise en main de 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 de 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 que AWS la messagerie des utilisateurs finaux crée lorsque vous soumettez un enregistrement de test pour votre agent AWS RCS. L'agent de test vous permet de :

  • Envoyer des messages RCS à des appareils de test enregistrés sans l'approbation de l'opérateur

  • Utilisez l'SendTextMessageAPI pour envoyer des messages de test, la même API 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 pour les utilisateurs AWS finaux 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 de repli des SMS avec ou sans numéro de téléphone SMS approuvé

Les appareils de test que vous enregistrez auprès d'un 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 à des appareils de test dans n'importe quel pays, que vous ayez soumis ou non un enregistrement de lancement pour 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 de l'utilisateur AWS final ou de l'CreateVerifiedDestinationNumberAPI.

Console

Dans la console, les appareils de test sont gérés dans le sous-onglet de gestion des testeurs RBM de l'onglet Testing de votre agent AWS RCS. Pour obtenir des instructions détaillées sur la console, consultezÉ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 la vérification des SMS. Les deux paramètres s'excluent mutuellement.

Flux d'invitation des testeurs

Une fois que vous avez ajouté un appareil de test, AWS la messagerie des utilisateurs finaux 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 le délai d'attente de 120 secondes et le OS-specific comportement des testeurs, consultez. Étape 2 : ajouter un appareil de test

Visualisation 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 de l'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 Tests. Choisissez le sous-onglet de gestion des testeurs RBM pour voir 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 auprès d'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 où 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 de l'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 repli des SMS pour vérifier que vos messages sont transmis par SMS lorsque la livraison RCS n'est pas possible. Pour obtenir des instructions complètes sur les tests de secours par SMS, y compris les tests sans numéro de SMS approuvé et le flux complet de bout en bout, 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 lors du test des messages RCS et 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 l'appareil 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 une version ultérieure.

  • Vérifiez que l'appareil de test dispose d'une connexion de données active. Les messages RCS sont transmis via des données, et non via le canal SMS.

  • Vérifiez que vous envoyez au bon numéro de téléphone au E.164 format correct.

Message envoyé sous forme de SMS au lieu de RCS

Si votre message 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 ne spécifiez qu'un numéro de téléphone SMS, le message est envoyé par SMS.

  • Vérifiez que l'appareil 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 redevenu 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 E.164 format du numéro de téléphone est correct et qu'il s'agit d'un numéro de mobile valide.

  • Vérifiez que l'appareil 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 avec iOS 18 ou version ultérieure), l'invitation au 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'application Messages sur l'iPhone.

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

  3. Appuyez sur Expéditeurs inconnus.

  4. Recherchez le message de gestion des testeurs RBM et appuyez sur Faire de moi un testeur pour accepter l'invitation.