/send-sms-java

Sample code for sending an SMS message with Java and the Vonage SMS API.

Primary LanguageJava

⚠️ This repository is no longer maintained.

Nexmo is now known as Vonage

Support Notice

This is an archived repository. If you have any questions, feel free to reach out to us at devrel@vonage.com or through our Community Slack at https://developer.vonage.com/community/slack.


This repository is part of the How to Send SMS Messages With Java tutorial.

Prerequisites

We've built this example using JDK 16 and Gradle 7.1

Running Instructions

Navigate to the project folder in your terminal and run:

gradle build

In SendSMS.java, replace the placeholders with string values as follows:

KEY DESCRIPTION
VONAGE_API_KEY Your API key, shown in your account overview.
VONAGE_API_SECRET Your API secret, shown in your account overview.
TO_NUMBER The number you are sending the SMS to in E.164 format. For example 447401234567.
VONAGE_BRAND_NAME Sender ID, the number or text shown on a handset when it displays your message.

Note: In some countries (US), VONAGE_BRAND_NAME has to be one of your Vonage virtual numbers. In other countries (UK), you're free to pick an alphanumeric string value—for example, your brand name like AcmeInc. Read about country-specific SMS features on the dev portal.

Save and run gradle run.

You should see something like this printed to the screen:

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

... and you should receive a text message! If it didn't work, check out if something was printed after ERR: in the line above, and maybe wait a few more seconds for the message to appear.

References