View a markdown version of this page

Gestion des agents RCS - AWS Messagerie SMS à l'utilisateur final
Comprendre l'agent AWS RCSComprendre le modèle d'identité à deux niveauxCréation d'un agent AWS RCSMise à jour d'un agent AWS RCSAffichage des agents AWS RCSRévision de votre agent de testAfficher le statut de lancement par paysSupprimer un agent AWS 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.

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 ?

L'agent AWS RCS suit le cycle de vie suivant :

  1. Créez l'agent AWS RCS.

  2. Ajoutez un agent de test (inclus dans le flux de création de la console ; facultatif via la CLI).

  3. Testez votre messagerie RCS avec des appareils de test enregistrés. Aucune approbation du transporteur n'est requise pour les tests.

  4. Soumettez un enregistrement de lancement par pays pour chaque pays dans lequel vous souhaitez envoyer des messages RCS de production.

  5. Approuvé partiellement : au moins un transporteur a approuvé votre agent. Vous pouvez commencer à envoyer aux destinataires via des transporteurs agréés.

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

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

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

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'UpdateRcsAgentAPI 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'DescribeRcsAgentsAPI 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'DescribeRcsAgentsAPI.

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'DescribeRegistrationFieldValuesAPI 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'DeleteRcsAgentAPI 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'DeleteRcsAgentAPI renvoie un message d'erreur. Pour désactiver la protection contre la suppression, utilisez l'UpdateRcsAgentAPI avec la protection contre la suppression définie surfalse.

Pour supprimer un agent AWS RCS

  1. Si la protection contre la suppression est activée, désactivez-la en appelant l'UpdateRcsAgentAPI avec la protection contre la suppression définie surfalse.

  2. Appelez l'DeleteRcsAgentAPI avec l'ID ou l'ARN de l'agent AWS RCS que vous souhaitez supprimer.

  3. Vérifiez que l'agent a été supprimé en appelant l'DescribeRcsAgentsAPI. L'agent ne doit plus apparaître dans les résultats ou son statut doit être SUPPRIMÉ.