Enviar una vCard por MMS
En este fragmento de código verás cómo enviar una vCard por 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:
| 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_VCARD_URL | The publicly accessible URL of the vCard attachment. Supported types are .vcf only. |
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-vcard.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": "vcard",
"vcard": {
"url": "'${MESSAGES_VCARD_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 SendMmsVcard 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 SendMmsVcard:
val messageId = client.messages.send(
mmsVcard {
to(MESSAGES_TO_NUMBER)
from(MMS_SENDER_ID)
url(MESSAGES_VCARD_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 SendMmsVcard:
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 SendMmsVcard 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 SendMmsVcard:
var response = client.getMessagesClient().sendMessage(
MmsVcardRequest.builder()
.from(MMS_SENDER_ID).to(MESSAGES_TO_NUMBER)
.url(MESSAGES_VCARD_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 SendMmsVcard:
Requisitos previos
Si no tiene una solicitud, puede crear uno. Asegúrese también de configure sus webhooks.
Install-Package VonageEscriba el código
Añada lo siguiente a SendMmsImage.cs:
var credentials = Credentials.FromAppIdAndPrivateKeyPath(VONAGE_APPLICATION_ID, VONAGE_PRIVATE_KEY_PATH);
var vonageClient = new VonageClient(credentials);
var request = new Vonage.Messages.Mms.MmsVcardRequest()
{
To = MESSAGES_TO_NUMBER,
From = MMS_SENDER_ID,
Vcard = new Attachment
{
Url = MESSAGES_VCARD_URL
}
};
var response = await vonageClient.MessagesClient.SendAsync(request);Requisitos previos
Si no tiene una solicitud, puede crear uno. Asegúrese también de configure sus webhooks.
pip install vonage python-dotenvEscriba el código
Añada lo siguiente a send-vcard.py:
from vonage import Auth, Vonage
from vonage_messages import MmsResource, MmsVcard
client = Vonage(
Auth(
application_id=VONAGE_APPLICATION_ID,
private_key=VONAGE_PRIVATE_KEY,
)
)
message = MmsVcard(
to=MESSAGES_TO_NUMBER,
from_=MMS_SENDER_ID,
vcard=MmsResource(url=MESSAGES_VCARD_URL),
)
response = client.messages.send(message)
print(response)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.
gem install vonageCrea un archivo llamado send-mms-vcard.rb y añade el siguiente código:
client = Vonage::Client.new(
application_id: VONAGE_APPLICATION_ID,
private_key: VONAGE_PRIVATE_KEY
)Escriba el código
Añada lo siguiente a send-mms-vcard.rb:
message = client.messaging.mms(
type: 'vcard',
message: {
url: MESSAGES_VCARD_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 una tarjeta vCard por MMS al número de destino.