Enviar un MMS
En este fragmento de código verás cómo enviar un MMS utilizando la Messages API.
IMPORTANTE: Sólo los US Short Codes, 10DLC Numbers y SMS Enabled Toll Free Numbers son actualmente compatibles para el envío de MMS. En el caso de los US Short Codes, los mensajes MMS pueden enviarse a las redes de AT&T, T-Mobile (antes Sprint) y Verizon en Estados Unidos. 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 más información al respecto, y sobre MMS en general, consulte la página Página de información general de Vonage MMSEl Página de información general de Vonage 10DLCy 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 |
|---|---|
VONAGE_APPLICATION_ID | The Vonage Application ID. |
VONAGE_APPLICATION_PRIVATE_KEY_PATH | Private key path. |
VONAGE_PRIVATE_KEY_PATH | Private key path. |
FROM_NUMBER | The phone number you are sending the MMS from. (US Short Code, 10DLC number, or SMS Enabled Toll Free Number) |
VONAGE_NUMBER | Refer to |
VONAGE_FROM_NUMBER | Refer to |
TO_NUMBER | The number you are sending the to in E.164 format. For example |
IMAGE_URL | The URL of the media you want to send. Accepted file formats are |
NOTA: No utilice un + o 00 cuando introduzca un número de teléfono, empiece por el prefijo del 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.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": "image",
"image": {
"url": "'${MESSAGES_IMAGE_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.
npm install @vonage/server-sdk @vonage/messagesCrea un archivo llamado send-mms.js y añade el siguiente código:
const { Vonage } = require('@vonage/server-sdk');
const { Channels } = require('@vonage/messages');
/**
* It is best to send messages using JWT instead of basic auth. If you leave out
* apiKey and apiSecret, the messages SDK will send requests using JWT tokens
*
* @link https://developer.vonage.com/en/messages/technical-details#authentication
*/
const vonage = new Vonage(
{
applicationId: VONAGE_APPLICATION_ID,
privateKey: VONAGE_PRIVATE_KEY,
},
{
...(MESSAGES_API_URL ? {apiHost: MESSAGES_API_URL} : {}),
},
);Escriba el código
Añada lo siguiente a send-mms.js:
vonage.messages.send({
messageType: 'image',
channel: Channels.MMS,
image: {
url: MESSAGES_IMAGE_URL,
},
to: MESSAGES_TO_NUMBER,
from: MMS_SENDER_ID,
})
.then(({ messageUUID }) => console.log(messageUUID))
.catch((error) => console.error(error));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:
Crea un archivo llamado SendMmsImage y añade el siguiente código al método main:
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:
Ejecute el siguiente comando gradle para ejecutar su aplicación, sustituyendo com.vonage.quickstart.kt.messages.mms por el paquete que contiene SendMmsImage:
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:
Crea un archivo llamado SendMmsImage 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 SendMmsImage:
var response = client.getMessagesClient().sendMessage(
MmsImageRequest.builder()
.from(MMS_SENDER_ID).to(MESSAGES_TO_NUMBER)
.url(MESSAGES_IMAGE_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:
Ejecute el siguiente comando gradle para ejecutar su aplicación, sustituyendo com.vonage.quickstart.messages.mms por el paquete que contiene SendMmsImage:
Requisitos previos
Si no tiene una solicitud, puede crear uno. Asegúrese también de configure sus webhooks.
Install-Package VonageRequisitos previos
Si no tiene una solicitud, puede crear uno. Asegúrese también de configure sus webhooks.
composer require vonage/clientCrea un archivo llamado send-mms.php y añade el siguiente código:
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.
pip install vonage python-dotenvEjecute 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.
gem install vonageCrea un archivo llamado send-mms.rb y añade el siguiente código:
Escriba el código
Añada lo siguiente a send-mms.rb:
message = client.messaging.mms(
type: 'image',
message: {
url: MESSAGES_IMAGE_URL
}
)
client.messaging.send(
from: MMS_SENDER_ID,
to: MESSAGES_TO_NUMBER,
**message
)Ejecute su código
Guarde este archivo en su máquina y ejecútelo:
Pruébalo
Al ejecutar el código, se envía un mensaje MMS al número de destino.