Enviar un mensaje de texto MMS

En este fragmento de código verás cómo enviar un mensaje MMS utilizando la Messages API.

IMPORTANTE: Actualmente, solo se admiten US Short Codes, números 10DLC y números gratuitos con función SMS para el envío de MMS. En el caso de los US Short Codes, se pueden enviar mensajes MMS a las redes de AT&T, T-Mobile (antes Sprint) y Verizon en EE. UU. Más información sobre la configuración de números 10DLC (nota: esta página hace referencia a la SMS API, pero el contenido de la sección de directrices 10 DLC también se aplica a la Messages API).

El rendimiento de los mensajes, la capacidad de entrega y los volúmenes de mensajes SMS pueden variar en función del tipo de número utilizado. Para obtener más información al respecto, así como sobre los MMS en general, consulta la Página de información general sobre MMS de VonageEl Página de información general de Vonage 10DLC, y el Página de resumen de Vonage Phone Numbers.

Ejemplo

A continuación encontrará la descripción de todas las variables utilizadas en cada fragmento de código:

ClaveDescripción
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.

NOTA: No utilice un + o 00 Al introducir un número de teléfono, empieza por el código de país; por ejemplo, 14155550105.

Requisitos previos

Si no tiene una solicitud, puede crear uno. Asegúrese también de configure sus webhooks.

Escriba el código

Añada lo siguiente a send-mms-text.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": "text",
    "text": "This is an MMS text message sent via the Vonage Messages API."
  }'

Ver fuente completa

Ejecute su código

Guarde este archivo en su máquina y ejecútelo:

bash send-mms-text.sh

Requisitos previos

Si no tiene una solicitud, puede crear uno. Asegúrese también de configure sus webhooks.

Añada lo siguiente a build.gradle:

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

Crea un archivo llamado SendMmsText y añade el siguiente código al método main:

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

Ver fuente completa

Escriba el código

Añada lo siguiente al método main del archivo SendMmsText:

val messageId = client.messages.send(
    mmsText {
        to(MESSAGES_TO_NUMBER)
        from(MMS_SENDER_ID)
        text("This is an MMS text message sent using the Messages API")
    }
)

Ver fuente completa

Ejecute su código

Podemos utilizar el plugin aplicación para Gradle para simplificar la ejecución de nuestra aplicación. Actualiza tu build.gradle con lo siguiente:

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

Ejecute el siguiente comando gradle para ejecutar su aplicación, sustituyendo com.vonage.quickstart.kt.messages.mms por el paquete que contiene SendMmsText:

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

Requisitos previos

Si no tiene una solicitud, puede crear uno. Asegúrese también de configure sus webhooks.

Añada lo siguiente a build.gradle:

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

Crea un archivo llamado SendMmsText y añade el siguiente código al método main:

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

Ver fuente completa

Escriba el código

Añada lo siguiente al método main del archivo SendMmsText:

var response = client.getMessagesClient().sendMessage(
		MmsTextRequest.builder()
			.from(MMS_SENDER_ID).to(MESSAGES_TO_NUMBER)
			.text("This is an MMS message with text")
			.build()
);
System.out.println("Message sent successfully. ID: "+response.getMessageUuid());

Ver fuente completa

Ejecute su código

Podemos utilizar el plugin aplicación para Gradle para simplificar la ejecución de nuestra aplicación. Actualiza tu build.gradle con lo siguiente:

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

Ejecute el siguiente comando gradle para ejecutar su aplicación, sustituyendo com.vonage.quickstart.messages.mms por el paquete que contiene SendMmsText:

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

Pruébalo

Al ejecutar el código, se envía un mensaje MMS al número de destino.