Enviar un archivo MMS
En este fragmento de código verás cómo enviar un archivo MMS mediante 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:
| Clave | Descripción |
|---|---|
MESSAGES_API_URL | There are two versions of the API, each with their own endpoints. For production the previous Messages API endpoint was |
MESSAGES_TO_NUMBER | The number you are sending the to in E.164 format. For example |
MMS_SENDER_ID | The alphanumeric string that represents the name or number of the organization sending the message. |
MESSAGES_FILE_URL | The publicly accessible URL of the file attachment. |
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-file.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": "file",
"file": {
"url": "'${MESSAGES_FILE_URL}'"
}
}'Ejecute su código
Guarde este archivo en su máquina y ejecútelo:
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 SendMmsFile y añade el siguiente código al método main:
val client = Vonage {
applicationId(VONAGE_APPLICATION_ID)
privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
}Escriba el código
Añada lo siguiente al método main del archivo SendMmsFile:
val messageId = client.messages.send(
mmsFile {
to(MESSAGES_TO_NUMBER)
from(MMS_SENDER_ID)
url(MESSAGES_FILE_URL)
caption(MESSAGES_CAPTION)
}
)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 SendMmsFile:
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 SendMmsFile 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();Escriba el código
Añada lo siguiente al método main del archivo SendMmsFile:
var response = client.getMessagesClient().sendMessage(
MmsFileRequest.builder()
.from(MMS_SENDER_ID).to(MESSAGES_TO_NUMBER)
.url(MESSAGES_FILE_URL)
.build()
);
System.out.println("Message sent successfully. ID: "+response.getMessageUuid());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 SendMmsFile:
Pruébalo
Al ejecutar el código, se envía un archivo MMS al número de destino.