View a markdown version of this page

Gestion des agents AWS RCS dans les pools - AWS Messagerie SMS à l'utilisateur final

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 AWS RCS dans les pools

Vous pouvez ajouter un agent AWS RCS comme identité d'origine dans un pool téléphonique à côté de vos numéros de téléphone SMS. Lorsqu'un pool contient à la fois un agent AWS RCS et des numéros de téléphone SMS, AWS la messagerie à l'utilisateur final tente d'abord de transmettre le RCS et revient automatiquement aux SMS si la livraison du RCS n'est pas possible. Pour plus de détails sur le fonctionnement de la solution de secours, voirSolution de repli entre RCS et SMS à l'aide de pools téléphoniques.

Note

Lorsque vous ajoutez un agent AWS RCS à un pool, utilisez-le ZZ comme code de pays ISO. Le ZZ code indique que l'agent RCS n'est pas spécifique à un pays au niveau du pool. Le routage spécifique au pays est géré par le biais des enregistrements de lancement par pays de l'agent. Un pool peut contenir des numéros de téléphone de plusieurs pays aux côtés de l'agent RCS.

Le code de pays ISO est fourni au moment de la création du pool mais n'est pas conservé dans le pool. Si vous appelezDescribePools, le code de pays ISO n'apparaît pas dans la réponse.

Création d'un pool avec un agent AWS RCS

Vous pouvez créer un nouveau pool qui inclut votre agent AWS RCS à l'aide de la console de messagerie utilisateur AWS final ou de l'CreatePoolAPI.

Console
Pour créer un pool avec un agent AWS RCS à l'aide de la console
  1. Ouvrez la console de messagerie de l'utilisateur AWS final.

  2. Dans le volet de navigation, choisissez Phone pools.

  3. Sélectionnez Create pool (Créer un groupe).

  4. Pour l'identité d'origine, sélectionnez votre agent AWS RCS. Le pool hérite de sa configuration de l'identité d'origine que vous sélectionnez.

  5. Configurez les paramètres du pool selon vos besoins, puis choisissez Create pool.

  6. Une fois le pool créé, ajoutez vos numéros de téléphone SMS au pool pour activer le remplacement des SMS. Toutes les identités d'origine du pool doivent avoir une configuration correspondante. Pour en savoir plus, consultez Exigences relatives à la configuration du pool pour RCS.

AWS CLI

Utilisez l'CreatePoolAPI pour créer un pool avec votre agent AWS RCS comme identité d'origine initiale. Spécifiez l'ARN de l'agent AWS RCS comme identité d'origine lors de la création du pool.

L'exemple suivant crée un pool à l'aide de la AWS CLI :

aws pinpoint-sms-voice-v2 create-pool \ --origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \ --iso-country-code ZZ \ --message-type TRANSACTIONAL

Une fois le pool créé, utilisez l'AssociateOriginationIdentityAPI pour ajouter des numéros de téléphone SMS au pool à des fins de repli.

Ajouter des agents AWS RCS aux pools existants

Si vous disposez déjà d'un pool contenant des numéros de téléphone SMS, vous pouvez ajouter votre agent AWS RCS au pool pour activer la messagerie RCS avec fonction de secours par SMS. Vous pouvez également ajouter des numéros de téléphone SMS supplémentaires à un pool qui contient déjà un agent AWS RCS.

Important

Avant d'ajouter une identité d'origine à un pool existant, vérifiez que la configuration du pool correspond à l'identité que vous ajoutez. Toutes les identités d'origine d'un pool doivent avoir des métadonnées identiques. En cas de non-concordance, l'opération échoue avec unConflictException. Pour plus de détails sur les champs qui doivent correspondre et sur la manière de résoudre les incohérences, consultezExigences relatives à la configuration du pool pour RCS.

Console

Avant d'ajouter un agent AWS RCS à un pool à l'aide de la console, consultez la page de détails du pool pour vérifier sa configuration actuelle. Vérifiez que le type de message, le code de pays ISO et les autres paramètres du pool sont compatibles avec l'agent AWS RCS que vous souhaitez ajouter.

Pour ajouter un agent AWS RCS à un pool existant à l'aide de la console
  1. Ouvrez la console de messagerie de l'utilisateur AWS final.

  2. Dans le volet de navigation, choisissez Phone pools.

  3. Choisissez le pool auquel vous souhaitez ajouter l'agent AWS RCS.

  4. Passez en revue la configuration du pool sur la page de détails. Vérifiez que le type de message et les autres paramètres correspondent à l'agent AWS RCS que vous souhaitez ajouter.

  5. Dans la section Identités d'origine, choisissez Ajouter une identité d'origine.

  6. Sélectionnez votre agent AWS RCS dans la liste et choisissez Ajouter.

AWS CLI

Avant d'ajouter un agent AWS RCS à un pool à l'aide de la CLI ou de l'API, utilisez l'DescribePoolsAPI pour récupérer la configuration actuelle du pool. Vérifiez que les paramètres du pool correspondent à l'agent AWS RCS que vous souhaitez ajouter.

L'exemple suivant permet de récupérer les détails du pool :

aws pinpoint-sms-voice-v2 describe-pools \ --pool-ids pool-id

Après avoir confirmé que la configuration correspond, utilisez l'AssociateOriginationIdentityAPI pour ajouter l'agent AWS RCS au pool :

aws pinpoint-sms-voice-v2 associate-origination-identity \ --pool-id pool-id \ --origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \ --iso-country-code ZZ

Exigences relatives à la configuration du pool pour RCS

Toutes les identités d'origine d'un pool doivent avoir des métadonnées identiques. Lorsque vous ajoutez une identité d'origine à un pool, AWS End User Messaging compare la configuration de l'identité à la configuration existante du pool. En cas de non-concordance, l'opération échoue avec un ConflictException qui inclut des détails sur les champs spécifiques qui diffèrent.

Les champs de configuration du pool se répartissent en deux catégories : les champs immuables qui sont définis lors de la création du pool et ne peuvent pas être modifiés, et les champs mutables que vous pouvez mettre à jour après sa création.

Champs de configuration de pool immuables ou mutables
Champ Mutabilité Remarques
Type de message Immuable Défini lors de la création du pool. Toutes les identités doivent correspondre.
Code de pays ISO Immuable Défini lors de la création du pool. Pour les agents AWS RCS, la valeur estZZ. Les pools peuvent contenir des numéros de téléphone provenant de plusieurs pays.
Protection contre la suppression Mutable Peut être activé après la création. Doit être cohérent entre les identités.
Liste de désabonnement Mutable Peut être modifié après la création. Doit être cohérent entre les identités.

Les champs de configuration suivants doivent correspondre à toutes les identités d'origine d'un pool :

  • Type de message — Toutes les identités doivent être configurées pour le même type de message (par exemple, TRANSACTIONNEL ou PROMOTIONNEL).

  • Code de pays ISO — Défini lors de la création du pool. Pour les agents AWS RCS, utilisez-le ZZ comme code de pays ISO. Les pools peuvent contenir des numéros de téléphone provenant de plusieurs pays.

  • Protection contre la suppression : le paramètre de protection contre la suppression doit être cohérent pour toutes les identités.

  • Liste de désinscription — Toutes les identités doivent être associées à la même liste de désinscription, sinon aucune d'entre elles ne doit avoir de liste de désinscription.

Comprendre ConflictException les erreurs

Lorsque vous tentez d'ajouter une identité d'origine à un pool et que la configuration ne correspond pas, l'CreatePoolAPI AssociateOriginationIdentity or renvoie unConflictException. Le message d'exception inclut des détails sur les champs qui diffèrent entre l'identité et le pool.

Par exemple, si vous essayez d'ajouter un numéro de téléphone configuré pour les messages PROMOTIONNELS à un pool configuré pour les messages TRANSACTIONNELS, le message d'erreur indique que le type de message ne correspond pas.

Pour résoudre un ConflictException :

  1. Consultez le message d'erreur pour identifier les champs différents.

  2. Mettez à jour l'identité d'origine ou la configuration du pool afin que les champs correspondent.

  3. Réessayez l'CreatePoolopération AssociateOriginationIdentity or.

Note

Si vous ne parvenez pas à résoudre l'incompatibilité de configuration, envisagez de créer un pool distinct pour l'identité d'origine. Chaque pool peut avoir sa propre configuration, et vous pouvez utiliser différents pools pour différents cas d'utilisation.

Suppression des agents AWS RCS des pools

Vous pouvez supprimer un agent AWS RCS d'un pool à l'aide de la console de messagerie utilisateur AWS final ou de l'DisassociateOriginationIdentityAPI. La suppression d'un agent AWS RCS d'un pool désactive la livraison RCS des messages envoyés via ce pool. Les messages envoyés au pool après la suppression de l'agent sont envoyés par SMS uniquement (en utilisant les numéros de téléphone restants du pool).

Console
Pour supprimer un agent AWS RCS d'un pool à l'aide de la console
  1. Ouvrez la console de messagerie de l'utilisateur AWS final.

  2. Dans le volet de navigation, choisissez Phone pools.

  3. Choisissez le pool qui contient l'agent AWS RCS que vous souhaitez supprimer.

  4. Dans la section Identités d'origine, sélectionnez l'agent AWS RCS.

  5. Choisissez Supprimer, puis confirmez la suppression.

AWS CLI

Utilisez l'DisassociateOriginationIdentityAPI pour supprimer un agent AWS RCS d'un pool :

aws pinpoint-sms-voice-v2 disassociate-origination-identity \ --pool-id pool-id \ --origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \ --iso-country-code ZZ

Après la suppression de l'agent AWS RCS, les messages envoyés via le pool sont transmis uniquement par SMS. Pour réactiver la livraison RCS, ajoutez de nouveau l'agent AWS RCS au pool à l'aide de l'API. AssociateOriginationIdentity