Senden von SMS-Nachrichten mit Java und der Vonage API

Dieser Artikel wurde im April 2025 aktualisiert.

Die Vonage SMS API ist ein Dienst, mit dem Sie SMS-Nachrichten senden und empfangen können. Wenn Sie Java-Entwickler sind, können Sie die Vonage-API nutzen, um SMS-Nachrichten aus Java-Anwendungen zu versenden.

In diesem Tutorial zeigen wir Ihnen, wie Sie mit Java und der Vonage API SMS-Nachrichten versenden können.

Voraussetzungen

Die Verwendung von Java zum Versenden von SMS-Nachrichten ist relativ einfach. Sobald Sie über die Vonage SMS-API verfügen, benötigen Sie nur ein paar zusätzliche Tools und Java-Kenntnisse.

Vonage API-Konto

Um dieses Tutorial durchzuführen, benötigen Sie ein Vonage API-Konto. Wenn Sie noch keines haben, können Sie sich noch heute anmelden und mit einem kostenlosen Guthaben beginnen. Sobald Sie ein Konto haben, finden Sie Ihren API-Schlüssel und Ihr API-Geheimnis oben auf dem Vonage-API-Dashboard.

Sind Sie bereit, mit dem Bau zu beginnen?

Erleben Sie nahtlose Konnektivität, Echtzeit-Messaging und kristallklare Sprach- und Videoanrufe - alles auf Knopfdruck.

Außerdem benötigen Sie Folgendes:

• JDK (17 oder höher) oder sein Open-Source-Äquivalent OpenJDK

• Gradle

Anweisungen

Im Folgenden führen wir Sie durch die einzelnen Schritte, die Sie ausführen müssen, um eine SMS-Nachricht in Java mit der Vonage API zu versenden.

1. Erstellen Sie Ihre Java-Anwendung

2. Konfigurieren Sie das Vonage Java SDK

3. Senden Sie Ihre SMS-Nachricht in Java

1. Erstellen Sie Ihre Java-Anwendung

Um zu beginnen, richten Sie Ihr Gradle-Projekt ein und laden Sie das Vonage Java SDK.

Erstellen Sie ein Verzeichnis für Ihr Projekt. Gehen Sie in Ihr Verzeichnis und führen Sie gradle init. Wenn Sie mit Gradle nicht vertraut sind, keine Sorge - wir werden uns nicht in etwas übermäßig Komplexes vertiefen!

Wählen Sie 1: einfach als Typ des zu erzeugenden Projekts. 1: Groovy als Build-Skript-DSL. Benennen Sie an dieser Stelle Ihr Projekt - oder drücken Sie die Eingabetaste für die Standardoption.

Sobald dies abgeschlossen ist, öffnen Sie die build.gradle Datei. Ersetzen Sie dann den Inhalt der Datei durch den folgenden Codeschnipsel:

// 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'
    }

Als nächstes öffnen Sie Ihre Konsole in dem Verzeichnis, in dem sich Ihre build.gradle Datei enthält. Führen Sie dann den folgenden Befehl aus:

gradle build

Dieser Befehl lädt das Vonage Java SDK herunter und speichert es für später. Wenn Sie Quellcode hätten, würde er diesen auch kompilieren - aber Sie haben noch keinen geschrieben. Das sollten wir ändern!

2. Konfigurieren Sie das Vonage Java SDK

Aufgrund der mainClass die wir in der Gradle-Build-Datei gesetzt haben, müssen Sie eine Klasse namens SendSMS in dem Paket getstarted.

(Anmerkung: Im Produktionscode sollte das Paket in etwa so aussehen com.mycoolcompany.smstoolsein, aber dies ist kein Produktionscode, also getstarted ausreichen.)

Gradle verwendet die gleiche Verzeichnisstruktur wie Maven, daher müssen Sie die folgende Verzeichnisstruktur in Ihrem Projektverzeichnis erstellen: src/main/java/getstarted.

Unter macOS und Linux können Sie diesen Pfad erstellen, indem Sie ihn ausführen:

mkdir -p src/main/java/getstarted

Innerhalb des Verzeichnisses getstarted Verzeichnis erstellen Sie eine Datei namens SendSMS.java. Sobald Sie diese in Ihrer bevorzugten IDE geöffnet haben, fügen Sie diesen Code hinzu:

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!
    }
}

Dies importiert die notwendigen Teile des Vonage SDK und erstellt eine Methode für unseren Code.

Wir speichern dann unseren API-Schlüssel und unser API-Geheimnis als Variablen. Füllen Sie YOUR_API_KEY und YOUR_API_SECRET mit den Werten aus, die Sie aus dem Vonage-API-Anzeigetafel.

Wenn Sie gradle runausführen, sollte es Ihre Hauptmethode ausführen. Da wir dort aber noch nichts haben, wird es nichts tun. Das müssen wir ändern!

3. Senden Sie Ihre SMS-Nachricht in Java

Jetzt sind wir fast so weit, dass wir mit unserer Java-Anwendung eine SMS-Nachricht versenden können!

Fügen Sie zunächst dieses Snippet zu Ihrer main Methode ein:

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

Der folgende Code erzeugt ein VonageClient Objekt, das für den Versand von SMS-Nachrichten verwendet werden kann. Da Ihr Client-Objekt nun konfiguriert ist, können Sie eine SMS-Nachricht senden:

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());
            }

Auch hier gilt: Ersetzen Sie VONAGE_BRAND_NAME durch die von Ihnen erworbene virtuelle Nummer und TO_NUMBER durch Ihre eigene Handynummer. Beide sollten als Zeichenketten geschrieben werden. Stellen Sie sicher, dass Sie die TO_NUMBER in E.164-Format-zum Beispiel: 447401234567.

Abschließend speichern und ausführen gradle run. Wenn Sie die Schritte in diesem Tutorial richtig befolgt haben, wird eine SMS-Nachricht von Java aus über die Vonage SMS-API gesendet.

An diesem Punkt sollten Sie etwa so etwas sehen:

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>]]

...und eine Textnachricht an Ihr Telefon!

Wenn es nicht funktioniert hat, kann es sein, dass ein Text nach ERR:. Beheben Sie das Problem und versuchen Sie es erneut.

ANMERKUNG

In einigen Ländern (USA) muss VONAGE_BRAND_NAME eine Ihrer virtuellen Vonage-Nummern sein. In anderen Ländern (Großbritannien) können Sie eine alphanumerische Zeichenfolge wählen - zum Beispiel Ihren Markennamen wie AcmeInc. Informationen über länderspezifische SMS-Funktionen finden Sie auf dem Entwicklerportal.

Schlussfolgerung

Sie wissen nun, wie Sie mit der Vonage API eine SMS in Java versenden können! Weitere Informationen finden Sie unter den unten angegebenen Links zur Dokumentation.

Weitere Lektüre

• Allgemeine Informationen über die SMS-API

• SMS-API-Dokumentation

• Eine SMS senden Dokumentation