JavaとVonage APIでSMSメッセージを送信する方法

この記事は2025年4月に更新されました。

Vonageの Vonage SMS APIは、SMSメッセージを送受信できるサービスです。Java開発者であれば、JavaアプリケーションからSMSメッセージを送信するためにVonage APIを使用することができます。

このチュートリアルでは、Vonage APIを使ってJavaでSMSメッセージを送信する方法を紹介します。

前提条件

Javaを使ってSMSメッセージを送信するのは比較的簡単です。Vonage SMS APIさえあれば、あとはいくつかの追加ツールと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.

以下のものも必要だ：

• JDK(17以上)またはオープンソースの同等のOpenJDK

• グラドル

使用方法

以下では、Vonage APIを使ってJavaでSMSメッセージを送信するために必要な各手順を説明します。

1. Javaアプリケーションの作成

2. Vonage Java SDKの設定

3. JavaでSMSメッセージを送信する

1.Javaアプリケーションの作成

はじめに、Gradle プロジェクトをセットアップして Vonage Java SDK.

プロジェクト用のディレクトリを作成する。ディレクトリの中に入り gradle init.Gradleに慣れていなくても、心配しないでください！

選択 1: ベーシックを選択します。 1: Groovyを選択します。この時点で、プロジェクトに名前を付けるか、デフォルトのオプションでEnterキーを押します。

それが完了したら build.gradleファイルを開く。そして、ファイルの中身を以下のコード・スニペットで置き換えてください：

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

次に、あなたの build.gradleファイルのあるディレクトリでコンソールを開く。そして、以下のコマンドを実行する：

gradle build

このコマンドは Vonage Java SDKをダウンロードして保存します。ソースコードがあれば、それをコンパイルすることもできますが、あなたはまだ何も書いていません。それを修正しましょう！

2.Vonage Java SDKを設定する

Gradleビルドファイルで設定した mainClassというクラスを作成する必要があります。 SendSMSというクラスを作成する必要があります。 getstarted.

(注：本番コードでは、パッケージは次のようなものにしたい。 com.mycoolcompany.smstool(注：プロダクション・コードでは、パッケージは次のようなものにしたいものですが、これはプロダクション・コードではないので getstartedで十分だ)。

GradleはMavenと同じディレクトリ構造を使用するので、プロジェクトディレクトリ内に以下のディレクトリ構造を作成する必要があります： src/main/java/getstarted.

macOSとLinuxでは、このパスを作成するために次のコマンドを実行する：

mkdir -p src/main/java/getstarted

その getstartedディレクトリ内に SendSMS.java.お気に入りのIDEでこのファイルを開いたら、次のコードを追加する：

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

これはVonage SDKの必要な部分をインポートし、コード用のメソッドを作成します。

APIキーとAPIシークレットを変数として保存します。変数に YOUR_API_KEYと YOUR_API_SECRETに Vonage API ダッシュボード.

を実行すれば gradle runを実行すれば、メイン・メソッドが実行されるはずだ。しかし、ここにはまだ何もないので、何もしてくれません。これを変更しよう！

3.JavaでSMSメッセージを送信する

これで、JavaアプリケーションでSMSメッセージを送信する準備はほぼ整いました！

まず、次のスニペットを mainメソッドに追加します：

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

次のコードは VonageClientオブジェクトを作成します。これでクライアント・オブジェクトが構成されたので、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());
            }

この場合も VONAGE_BRAND_NAMEを購入したバーチャル番号に、そして TO_NUMBERを自分の携帯電話番号に置き換えてください。どちらも文字列で記述する。必ず TO_NUMBERを必ず記入してください。 E.164形式-例えば、447401234567。

最後に、保存して実行します。 gradle run.このチュートリアルのステップに正しく従っていれば、Vonage SMS APIを使ってJavaからSMSメッセージが送信されます。

この時点で、次のように表示されるはずだ：

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

...そして携帯電話にテキストメッセージが送られる！

もしうまくいかなかった場合、次のようなテキストがあるかもしれない。 ERR:.問題を修正し、再度お試しください。

注

一部の国 (米国) では、VONAGE_BRAND_NAME は Vonage バーチャル番号の 1 つでなければなりません。その他の国（英国）では、英数字の文字列を自由に選択できます。例えば、AcmeIncのようなブランド名です。国別のSMS機能については 開発ポータル.

結論

VonageのAPIを使ってJavaでSMSを送信する方法がわかりました！詳細については、以下のドキュメントリンクを参照してください。

さらに読む

• SMS APIに関する一般情報

• SMS API ドキュメント

• SMSドキュメントの送信