Cómo enviar un mensaje de texto en 5 líneas de Java

Introducción

Si usted es un desarrollador Java, es posible que haya oído hablar de JEP 445: Clases sin nombre y métodos principales de instancia. Esta función de vista previa introducida en Java 21 reduce en gran medida el código repetitivo necesario para escribir un simple programa "¡Hola, mundo!". Aunque la mayoría de los desarrolladores profesionales rara vez necesitan escribir una aplicación de un solo método, a veces puede ser útil para crear ejemplos mínimos reproducibles o para probar que su entorno está configurado correctamente. En este artículo, mostraré esta nueva sintaxis enseñándote cómo enviar un mensaje de texto en sólo cinco líneas de código utilizando nuestra Messages API.

Requisitos previos

• Descargue e instale Java 21. Puede encontrar versiones de acceso anticipado antes de que sea GA. Si estás leyendo esto después de septiembre de 2023, entonces puedes encontrar builds de JDK 21 desde varios lugares, por ejemplo, Eclipse Temurin o Oracle.

• Abra un terminal y navegue hasta / cree un directorio de trabajo adecuado. Por ejemplo, cd ~/Projects && mkdir vonage-java-demo.

• Establece JDK 21 como tu versión de Java. La forma de hacerlo dependerá de su sistema operativo, pero, en teoría, no debería ser más complicado que actualizar su variable de entorno JAVA_HOME para que apunte al JDK que descargó en el Paso 1. Puede comprobar qué JDK está utilizando escribiendo java --version en tu terminal.

• Regístrate para obtener una cuenta de Vonage.

• Descargue el SDK de Java con todas sus dependencias y guárdelo en su directorio de trabajo. Sustituya el número de versión que aparece en el enlace por la versión más reciente, que puede encontrar en la página de versiones de GitHub.

El Código

A continuación se muestra el código para enviar un SMS. Cree un archivo Java en su directorio de trabajo, por ejemplo VonageTextDemo.java. A continuación, pega el código de abajo en el archivo y guárdalo. Sustituya el número en to por tu número de teléfono, apiKey por su clave API y apiSecret con su secreto (disponible en el panel de desarrollador).

import com.vonage.client.*; import com.vonage.client.messages.*; import com.vonage.client.messages.sms.*;
void main() {
    var client = VonageClient.builder().apiKey("a1b2c3d4").apiSecret("0123456789Abcdef").build();
    client.getMessagesClient().sendMessage(SmsTextRequest.builder().from("Vonage Java").to("447418360119").text("Hello, World!").build());
}

Así es como funciona el código.

• La línea 1 importa las clases de los paquetes necesarios para la compilación.

• La línea 2 es la nueva sintaxis introducida en Java 21. Aunque omitir la declaración de un paquete siempre ha sido posible, hasta Java 21, el método main tenía que estar contenido dentro de una clase y tenía que declararse exactamente como public static void main(String[] args) (o incluso public static void main(String… args)). Puede obtener más información sobre la nueva sintaxis en Inside Java Newscast #49.

• La línea 3 crea el cliente de Vonage utilizando tu clave y secreto de API como método de autenticación. Esta es la forma más simple de comenzar a usar Messages API, pero te recomendamos que uses un ID de aplicación y una clave privada en un entorno de producción.

• En la línea 4 se construye y envía el mensaje. El método com.vonage.client.messages.MessagesClient#sendMessage(MessageRequest) se invoca con un método SmsTextRequest - una subclase de MessageRequest. Todas las peticiones de mensajes siguen el patrón Builder (puedes leer más sobre esto en una de mis entradas anteriores en el blog]. Esto permite la construcción declarativa de la carga útil del mensaje. Por último, para completar.

• La línea 5 es, por supuesto, la llave de cierre del método main declarado en la línea 2.

Si desea enviar un texto por WhatsApp, sustituya SmsTextRequest por WhatsappTextRequest y actualice la importación. Tenga en cuenta que tendrá que utilizar la Messages API Sandbox para enviar un mensaje desde WhatsApp; de lo contrario, tendrá que configurar una WhatsApp Business Account y utilizar ese número. El SDK de Java proporciona el método useSandboxEndpoint() en MessagesClient para mayor comodidad.

import com.vonage.client.*; import com.vonage.client.messages.*; import com.vonage.client.messages.whatsapp.*;
void main() {
    var client = VonageClient.builder().apiKey("a1b2c3d4").apiSecret("0123456789Abcdef").build();
    client.getMessagesClient().useSandboxEndpoint().sendMessage(WhatsappTextRequest.builder().from("14157386102").to("447418360119").text("Hello, World!").build());
}

Del mismo modo, puedes enviar un mensaje de texto a través de Viber:

import com.vonage.client.*; import com.vonage.client.messages.*; import com.vonage.client.messages.viber.*;
void main() {
    var client = VonageClient.builder().apiKey("a1b2c3d4").apiSecret("0123456789Abcdef").build();
    client.getMessagesClient().useSandboxEndpoint().sendMessage(ViberTextRequest.builder().from("My Company").to("447418360119").text("Hello, World!").build());
}

Y lo mismo para Facebook Messenger: utiliza tu ID de destinatario en to y el ID del Sandbox de Mensajes en from:

import com.vonage.client.*; import com.vonage.client.messages.*; import com.vonage.client.messages.messenger.*;
void main() {
    var client = VonageClient.builder().apiKey("a1b2c3d4").apiSecret("0123456789Abcdef").build();
    client.getMessagesClient().useSandboxEndpoint().sendMessage(MessengerTextRequest.builder().from("107083064136738").to("6573130892744564").text("Hello, World!").build());
}

Compilar y ejecutar

En su directorio de trabajo, escriba el siguiente comando:

Por supuesto, sustituye client-7.6.0-all.jar por el nombre del archivo JAR que descargaste, lo mismo con "VonageTextDemo" - este debe ser el nombre que le diste al archivo que creaste anteriormente. Si la compilación se realiza correctamente, deberías ver un archivo .class en tu directorio de trabajo, por ejemplo VonageTextDemo.class. Ahora puedes ejecutarlo de la siguiente manera:

Si ahora compruebas tu teléfono, ¡deberías tener un mensaje!

Puede consultar más ejemplos en nuestro repositorio de fragmentos de código Java. La Messages API no sólo admite mensajes de texto, sino también multimedia, como archivos, imágenes, audio, Video y mucho más.

Despedida

Eso es todo por ahora. Si te encuentras con algún problema o tienes sugerencias de mejora, no dudes en plantear un problema en GitHubo ponte en contacto con nosotros en Twitter o pásate por nuestro Slack de la comunidad si tienes algún comentario o simplemente quieres saludarnos. Espero que tengas una gran experiencia usando las API de Vonage en Java.