Enviar uma mensagem de texto MMS
Neste trecho de código, você verá como enviar uma mensagem de texto MMS usando a Messages API.
IMPORTANTE: Atualmente, apenas US Short Codes, números 10DLC e números gratuitos habilitados para SMS são compatíveis com o envio de MMS. No caso dos US Short Codes, as mensagens MMS podem ser enviadas para as redes da AT&T, T-Mobile (anteriormente Sprint) e Verizon nos EUA. Saiba mais sobre como configurar números 10DLC (observação: esta página faz referência à SMS API, mas o conteúdo da seção “10 diretrizes para DLC” também se aplica à Messages API).
A taxa de processamento de mensagens, a taxa de entrega e os volumes de mensagens SMS podem variar dependendo do tipo de número utilizado. Para obter mais informações sobre isso e sobre MMS em geral, consulte o Página de visão geral do MMS da Vonage, o Página de visão geral do 10DLC da Vonage, e o Página de visão geral dos números de telefone da Vonage.
Exemplo
Veja a seguir a descrição de todas as variáveis utilizadas em cada trecho de código:
| Chave | Descrição |
|---|---|
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. |
NOTA: Não use um espaço à esquerda + ou 00 Ao digitar um número de telefone, comece com o código do país, por exemplo, 14155550105.
Pré-requisitos
Se você não tiver um aplicativo, acesse criar um. Certifique-se também de acessar configure seus webhooks.
Escreva o código
Adicione o seguinte ao arquivo ` 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."
}'Execute seu código
Salve este arquivo no seu computador e execute-o:
Pré-requisitos
Se você não tiver um aplicativo, acesse criar um. Certifique-se também de acessar configure seus webhooks.
Adicione o seguinte ao arquivo ` build.gradle`:
implementation 'com.vonage:server-sdk-kotlin:2.1.1'Crie um arquivo chamado ` SendMmsText ` e adicione o código a seguir ao método ` main `:
val client = Vonage {
applicationId(VONAGE_APPLICATION_ID)
privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
}Escreva o código
Adicione o seguinte ao método ` main ` do arquivo ` 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")
}
)Execute seu código
Podemos usar o plugin “ aplicativo ” para o Gradle a fim de simplificar a execução do nosso aplicativo. Atualize seu arquivo ` build.gradle ` com o seguinte:
apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''Execute o seguinte comando ` gradle ` para rodar seu aplicativo, substituindo ` com.vonage.quickstart.kt.messages.mms ` pelo pacote que contém ` SendMmsText`:
Pré-requisitos
Se você não tiver um aplicativo, acesse criar um. Certifique-se também de acessar configure seus webhooks.
Adicione o seguinte ao arquivo ` build.gradle`:
implementation 'com.vonage:server-sdk:9.3.1'Crie um arquivo chamado ` SendMmsText ` e adicione o código a seguir ao método ` main `:
VonageClient client = VonageClient.builder()
.applicationId(VONAGE_APPLICATION_ID)
.privateKeyPath(VONAGE_PRIVATE_KEY_PATH)
.build();Escreva o código
Adicione o seguinte ao método ` main ` do arquivo ` 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());Execute seu código
Podemos usar o plugin “ aplicativo ” para o Gradle a fim de simplificar a execução do nosso aplicativo. Atualize seu arquivo ` build.gradle ` com o seguinte:
apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''Execute o seguinte comando ` gradle ` para rodar seu aplicativo, substituindo ` com.vonage.quickstart.messages.mms ` pelo pacote que contém ` SendMmsText`:
Experimente
Ao executar o código, uma mensagem de texto MMS é enviada para o número de destino.