Envoi d'un MMS message

Vous pouvez utiliser la AWS CLI version v2 de la messagerie utilisateur AWS finale SMS et de la voix API pour envoyer MMS des messages à vos clients.

Utilisez la send-media-message AWS CLI commande pour envoyer un MMS message. Pour plus d'informations sur la configuration du AWS CLI, voir Configurer le AWS CLI dans le guide de AWS Command Line Interface l'utilisateur.

Important

MMSles fonctionnalités ne sont disponibles que dans certains pays. Pour plus d'informations sur les pays pris en charge pour SMS etMMS, consultez Pays et régions pris en charge pour la SMS messagerie etPays et régions pris en charge pour la MMS messagerie.

Pour vérifier si votre identité d'origine est MMS compatible, consultezÉtat et fonctionnalités du numéro de téléphone.

Avant d'envoyer un MMS message, vous devez télécharger vos fichiers multimédia dans un compartiment Amazon S3 dont le nom correspond à Région AWS votre identité MMS d'origine valide, voirConfiguration d'un compartiment dans S3 pour les MMS fichiers.

L'identité utilisée pour appeler send-media-message doit disposer d'un accès en lecture au compartiment Amazon S3 qui contient vos fichiers multimédia. Pour plus d'informations sur la configuration de l'accès en lecture, consultez les exemples de politiques basées sur l'identité pour Amazon S3 dans le guide de l'utilisateur d'Amazon S3.

Pour envoyer un MMS message

• Sur la ligne de commande, entrez la commande suivante :

  aws pinpoint-sms-voice-v2 --region 'us-east-1' send-media-message --destination-phone-number [phone] --origination-identity [phone] --message-body 'text body' --media-urls 's3://s3-bucket/media_file.jpg'

  Dans l’exemple précédent, apportez les modifications suivantes :

  • Remplacez us-east-1 dans Région AWS lequel votre identité d'origine est enregistrée.

  • Remplacez [phone] avec le numéro de téléphone de destination.

  • Remplacez [phone] avec votre identité d'origine. L'identité d'origine doit être capable ACTIVE d'envoyer le numéro de téléphone de destination.

  • Remplacez text body avec votre texto.

  • Remplacez s3://s3-bucket/media_file.jpg avec le S3 URI du fichier multimédia. Les formats de fichiers multimédia pris en charge sont répertoriés dansMMStypes de fichiers, taille et limites de caractères. Pour plus d'informations sur la création d'un compartiment S3 et la gestion des objets, consultez Configuration d'un compartiment dans S3 pour les MMS fichiers la section Création d'un compartiment et téléchargement d'objets dans le guide de l'utilisateur Amazon S3.

Si AWS la messagerie utilisateur final SMS accepte la commande, vous recevrez leMessageID. Cela signifie uniquement que la commande a été reçue avec succès et non que le périphérique de destination a déjà reçu le message. Pour obtenir la liste des codes d'erreur, consultez la section SendMediaMessage Erreurs.

{
   "MessageId": "string"
}

Configuration d'un compartiment dans S3 pour les MMS fichiers

Vos MMS fichiers doivent être stockés dans un compartiment Amazon S3. Le compartiment Amazon S3 doit se trouver dans la même Compte AWS identité Région AWS que votre identité MMS d'origine compétente. Ces instructions indiquent comment créer un compartiment Amazon S3, charger un fichier et le URI compiler dans le fichier. Pour plus d'informations sur les commandes Amazon S3, consultez Utiliser des commandes de haut niveau (s3) avec le AWS CLI. Pour plus d'informations sur la configuration du AWS CLI, voir Configurer le AWS CLI dans le guide de AWS Command Line Interface l'utilisateur.

Pour créer un compartiment Amazon S3, utilisez la commande create-bucket AWS CLI . Sur la ligne de commande, entrez la commande suivante :

aws s3api create-bucket --region 'us-east-1' --bucket BucketName

Dans la commande précédente :

• Remplacez us-east-1 avec Région AWS votre identité d'origine MMS compétente.

• Remplacez BucketName avec le nom du nouveau compartiment.

Pour copier un fichier dans le compartiment Amazon S3, utilisez la AWS CLI commande cp. Sur la ligne de commande, entrez la commande suivante :

aws s3 cp SourceFilePathAndName s3://BucketName/FileName 

Dans la commande précédente :

• Remplacez SourceFilePathAndName avec le chemin du fichier et le nom du fichier à copier.

• Remplacez BucketName avec le nom du bucket.

• Remplacez FileName avec le nom à utiliser pour le fichier.

Le URI à utiliser lors de l'envoi est :

s3://BucketName/FileName