Comment envoyer des SMS avec Java et l'API de Vonage

Cet article a été mis à jour en avril 2025

L'API SMS API de Vonage de Vonage est un service qui vous permet d'envoyer et de recevoir des messages SMS. Si vous êtes un développeur Java, vous pouvez utiliser l'API de Vonage pour envoyer des SMS à partir d'applications Java.

Dans ce tutoriel, nous allons vous montrer comment envoyer des messages SMS avec Java en utilisant l'API de Vonage.

Conditions préalables

L'utilisation de Java pour envoyer des SMS est relativement simple. Une fois que vous disposez de l'API SMS de Vonage, il suffit de quelques outils supplémentaires et d'une connaissance pratique de Java.

Vonage API Account

To complete this tutorial, you will need a Vonage API account. If you don’t have one already, you can sign up today and start building with free credit. Once you have an account, you can find your API Key and API Secret at the top of the Vonage API Dashboard.

Ready to start building?

Experience seamless connectivity, real-time messaging, and crystal-clear voice and video calls—all at your fingertips.

Vous aurez également besoin des éléments suivants :

• JDK (17 ou supérieur) ou son équivalent open-source OpenJDK

• Gradle

Instructions

Ci-dessous, nous vous présentons chacune des étapes à suivre pour envoyer un SMS en Java avec l'API de Vonage.

1. Créez votre application Java

2. Configurer le SDK Java de Vonage

3. Envoyez votre message SMS en Java

1. Créer votre application Java

Pour commencer, configurez votre projet Gradle et téléchargez le SDK Java de Vonage.

Créez un répertoire pour votre projet. Allez dans votre répertoire et exécutez gradle init. Si vous n'êtes pas familier avec Gradle, ne vous inquiétez pas - nous n'allons pas nous plonger dans quelque chose de trop complexe !

Sélectionner 1 : de base comme type de projet à générer. 1 : Groovy comme DSL de script de construction. À ce stade, nommez votre projet - ou appuyez sur Entrée pour l'option par défaut.

Une fois cette opération terminée, ouvrez le fichier build.gradle . Remplacez ensuite le contenu du fichier par l'extrait de code suivant :

// We're creating a Java Application:
    plugins {
        id 'application'
        id 'java'
    }
    
    // Download dependencies from Maven Central:
    repositories {
        mavenCentral()
    }
    
    // Install the Vonage Java SDK
    dependencies {
        implementation 'com.vonage:client:7.7.0'
    }
    
    // We'll create this class to contain our code:
    application {
        mainClass = 'getstarted.SendSMS'
    }

Ensuite, ouvrez votre console dans le répertoire qui contient votre fichier build.gradle dans votre console. Exécutez ensuite la commande suivante :

gradle build

Cette commande téléchargera le SDK Java de Vonage de Vonage et le stocke pour plus tard. Si vous aviez un code source, il serait également compilé, mais vous n'en avez pas encore écrit. Corrigeons cela !

2. Configurer le SDK Java de Vonage

En raison de l'option mainClass que nous avons défini dans le fichier de construction de Gradle, vous allez devoir créer une classe appelée SendSMS dans le paquetage getstarted.

(Note : Dans un code de production, vous voudriez que le paquet soit quelque chose comme com.mycoolcompany.smstoolmais ce n'est pas le cas ici, donc getstarted fera l'affaire).

Gradle utilise la même structure de répertoire que Maven, vous devez donc créer la structure de répertoire suivante dans votre répertoire de projet : src/main/java/getstarted.

Sous macOS et Linux, vous pouvez créer ce chemin en exécutant :

mkdir -p src/main/java/getstarted

Dans le répertoire getstarted créer un fichier appelé SendSMS.java. Une fois ouvert dans votre IDE préféré, ajoutez ce code :

package getstarted;

import com.vonage.client.VonageClient;
import com.vonage.client.sms.MessageStatus;
import com.vonage.client.sms.SmsSubmissionResponse;
import com.vonage.client.sms.messages.TextMessage;

static String API_KEY = "YOUR_API_KEY";
static String API_SECRET = "YOUR_API_SECRET";

public class SendSMS {

    public static void main(String[] args) throws Exception {
    // Our code will go here!
    }
}

Cela permet d'importer les éléments nécessaires du SDK de Vonage et de créer une méthode pour notre code.

Nous stockons ensuite notre clé API et notre secret API en tant que variables. Remplissez YOUR_API_KEY et YOUR_API_SECRET avec les valeurs que vous avez copiées à partir du tableau de bord de l'API de tableau de bord de l'API de Vonage.

Si vous exécutez gradle runil devrait exécuter votre méthode principale. Cependant, comme nous n'avons encore rien dans cette méthode, elle ne fera rien. Changeons cela !

3. Envoyez votre message SMS en Java

Nous sommes maintenant presque prêts à envoyer un SMS avec notre application Java !

Tout d'abord, ajoutez cet extrait à votre main méthode :

VonageClient client = VonageClient.builder()
    
    .apiKey(YOUR_API_KEY)
    .apiSecret(YOUR_API_SECRET)
    .build();

Le code suivant crée un objet VonageClient qui peut être utilisé pour envoyer des SMS. Maintenant que votre objet client est configuré, vous pouvez envoyer un SMS :

TextMessage message = new TextMessage(VONAGE_BRAND_NAME,
                    TO_NUMBER,
                    "A text message sent using the Vonage SMS API"
            );
    
            SmsSubmissionResponse response = client.getSmsClient().submitMessage(message);
    
            if (response.getMessages().get(0).getStatus() == MessageStatus.OK) {
                System.out.println("Message sent successfully. " + response.getMessages());
            } else {
                System.out.println("Message failed with error: " + response.getMessages().get(0).getErrorText());
            }

Là encore, vous devez remplacer VONAGE_BRAND_NAME par le numéro virtuel que vous avez acheté et TO_NUMBER par votre propre numéro de téléphone mobile. Ils doivent tous deux être écrits sous forme de chaînes de caractères. Veillez à fournir l'élément TO_NUMBER dans le format format E.164-par exemple, 447401234567.

Enfin, sauvegardez et exécutez gradle run. Si vous avez suivi correctement les étapes de ce tutoriel, vous enverrez un SMS à partir de Java à l'aide de l'API SMS de Vonage.

À ce stade, vous devriez voir quelque chose comme ceci :

Message sent successfully.[com.vonage.client.sms.SmsSubmissionResponseMessage@f0f0675[to=447401234567,id=13000001CA6CCC59,status=OK,remainingBalance=27.16903818,messagePrice=0.03330000,network=23420,errorText=<null>,clientRef=<null>]]

...et un message texte envoyé sur votre téléphone !

Si cela n'a pas fonctionné, il se peut qu'il y ait du texte après ERR:. Corrigez le problème et réessayez.

NOTE

Dans certains pays (États-Unis), VONAGE_BRAND_NAME doit être l'un de vos numéros virtuels Vonage. Dans d'autres pays (Royaume-Uni), vous êtes libre de choisir une chaîne alphanumérique - par exemple, votre nom de marque comme AcmeInc. Pour en savoir plus sur les fonctions SMS spécifiques à chaque pays, consultez le portail de développement.

Conclusion

Vous savez maintenant comment envoyer un SMS en Java à l'aide de l'API de Vonage ! Pour plus d'informations, veuillez vous référer aux liens de documentation fournis ci-dessous.

Pour en savoir plus

• Informations générales sur l'API SMS

• Documentation de l'API SMS

• Envoyer un SMS Documentation