Envoyer le contenu d'un MMS

Dans cet extrait de code, vous découvrirez comment envoyer du contenu MMS à l'aide de la Messages API.

IMPORTANT : Seuls les numéros courts américains, les numéros 10DLC et les numéros verts compatibles avec les SMS sont actuellement pris en charge pour l'envoi de MMS. Pour les numéros courts américains, les messages MMS peuvent être envoyés aux réseaux AT&T, T-Mobile (anciennement Sprint) et Verizon aux États-Unis. En savoir plus sur la mise en place des numéros 10DLC (note : cette page fait référence à l'API SMS, mais le contenu de la section 10 DLC guidelines s'applique également à l'API Messages).

Le débit des messages, la délivrabilité et le volume des SMS peuvent varier en fonction du type de numéro utilisé. Pour plus d'informations à ce sujet, et sur les MMS en général, voir la section Page de présentation de Vonage MMS, le Page de présentation de Vonage 10DLCet le Page de présentation des numéros de téléphone de Vonage.

Exemple

Vous trouverez ci-dessous la description de toutes les variables utilisées dans chaque extrait de code :

Clé	Description
`MESSAGES_API_URL`	There are two versions of the API, each with their own endpoints. For production the previous Messages API endpoint was `https://api.nexmo.com/v0.1/messages`, the new one is `https://api.nexmo.com/v1/messages`. For sandbox testing the Messages API endpoint is `https://messages-sandbox.nexmo.com/v0.1/messages` or `https://messages-sandbox.nexmo.com/v1/messages`, depending on which version you have set in the sandbox dashboard.
`MESSAGES_TO_NUMBER`	The number you are sending the to in E.164 format. For example `447700900000`.
`MMS_SENDER_ID`	The alphanumeric string that represents the name or number of the organization sending the message.
`MESSAGES_IMAGE_URL`	The publicly accessible URL of the image attachment. Supported types are .jpg, .jpeg, and .png
`MESSAGES_FILE_URL`	The publicly accessible URL of the file attachment.

NOTE : N'utilisez pas de point de départ + ou 00 lorsque vous saisissez un numéro de téléphone, commencez par l'indicatif du pays, par exemple 14155550105.

Conditions préalables

Si vous n'avez pas de dossier de candidature, vous pouvez vous adresser à créer un. Veillez également à configurer vos webhooks.

Rédiger le code

Ajouter ce qui suit à send-mms-content.sh:

curl -X POST "${MESSAGES_API_URL}" \
  -H "Authorization: Bearer "$JWT\
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d $'{
    "to": "'${MESSAGES_TO_NUMBER}'",
    "from": "'${MMS_SENDER_ID}'",
    "channel": "mms",
    "message_type": "content",
    "content": [
      {
        "type": "image",
        "url": "'${MESSAGES_IMAGE_URL}'"
      },
      {
        "type": "file",
        "url": "'${MESSAGES_FILE_URL}'"
      }
    ]
  }'

Voir la source complète

Exécutez votre code

Enregistrez ce fichier sur votre machine et exécutez-le :

bash send-mms-content.sh

Conditions préalables

Si vous n'avez pas de dossier de candidature, vous pouvez vous adresser à créer un. Veillez également à configurer vos webhooks.

Ajouter ce qui suit à build.gradle:

implementation 'com.vonage:server-sdk-kotlin:2.1.1'

Créez un fichier nommé SendMmsContent et ajoutez le code suivant à la méthode main:

val client = Vonage {
    applicationId(VONAGE_APPLICATION_ID)
    privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
}

Voir la source complète

Rédiger le code

Ajouter ce qui suit à la méthode main du fichier SendMmsContent:

val messageId = client.messages.send(
    mmsContent {
        to(MESSAGES_TO_NUMBER)
        from(MMS_SENDER_ID)
        addImage(MESSAGES_IMAGE_URL)
        addFile(MESSAGES_FILE_URL)
    }
)

Voir la source complète

Exécutez votre code

Nous pouvons utiliser le plugin application pour Gradle afin de simplifier l'exécution de notre application. Mettez à jour votre build.gradle avec ce qui suit :

apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''

Lancez la commande suivante gradle pour exécuter votre application, en remplaçant com.vonage.quickstart.kt.messages.mms par le paquet contenant SendMmsContent:

gradle run -Pmain=com.vonage.quickstart.kt.messages.mms.SendMmsContent

Conditions préalables

Si vous n'avez pas de dossier de candidature, vous pouvez vous adresser à créer un. Veillez également à configurer vos webhooks.

Ajouter ce qui suit à build.gradle:

implementation 'com.vonage:server-sdk:9.3.1'

Créez un fichier nommé SendMmsContent et ajoutez le code suivant à la méthode main:

VonageClient client = VonageClient.builder()
		.applicationId(VONAGE_APPLICATION_ID)
		.privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
		.build();

Voir la source complète

Rédiger le code

Ajouter ce qui suit à la méthode main du fichier SendMmsContent:

var response = client.getMessagesClient().sendMessage(
		MmsContentRequest.builder()
			.from(MMS_SENDER_ID).to(MESSAGES_TO_NUMBER)
			.addImage(MESSAGES_IMAGE_URL)
			.addFile(MESSAGES_FILE_URL)
			.build()
);
System.out.println("Message sent successfully. ID: "+response.getMessageUuid());

Voir la source complète

Exécutez votre code

Nous pouvons utiliser le plugin application pour Gradle afin de simplifier l'exécution de notre application. Mettez à jour votre build.gradle avec ce qui suit :

apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''

Lancez la commande suivante gradle pour exécuter votre application, en remplaçant com.vonage.quickstart.messages.mms par le paquet contenant SendMmsContent:

gradle run -Pmain=com.vonage.quickstart.messages.mms.SendMmsContent

Essayez-le

Lorsque vous exécutez le code, un message MMS contenant une image et un fichier est envoyé au numéro de destination.