twilio/twilio-java


A Java library for communicating with the Twilio REST API and generating TwiML.

https://www.twilio.com/docs/libraries/java

License: MIT

Language: Java

Keywords: api, mms, phone, sms, telephony, twilio, twiml, video, voice, wireless


twilio-java

Build Status Maven Central

Recent Update

As of release 7.14.0, Beta and Developer Preview products are now exposed via the main twilio-java artifact. Releases of the alpha branch have been discontinued.

If you were using the alpha release line, you should be able to switch back to the normal release line without issue.

If you were using the normal release line, you should now see several new product lines that were historically hidden from you due to their Beta or Developer Preview status. Such products are explicitly documented as Beta/Developer Preview both in the Twilio docs and console, as well as through in-line code documentation here in the library.

Installing

twilio-java uses Maven. At present the jars are available from a public maven repository.

Use the following dependency in your project to grab via Maven:

   <dependency>
      <groupId>com.twilio.sdk</groupId>
      <artifactId>twilio</artifactId>
      <version>7.X.X</version>
      <scope>compile</scope>
   </dependency>

or Gradle:

compile "com.twilio.sdk:twilio:7.X.X"

If you want to compile it yourself, here's how:

$ git clone git@github.com:twilio/twilio-java
$ cd twilio-java
$ mvn install       # Requires maven, download from http://maven.apache.org/download.html

Quickstart

Send a SMS

String accountSid = "ACXXXXXX"; // Your Account SID from www.twilio.com/user/account
String authToken = "XXXXXXXX"; // Your Auth Token from www.twilio.com/user/account

Twilio.init(accountSid, authToken);

Message message = Message.creator(
    new PhoneNumber("+15558881234"),  // To number
    new PhoneNumber("+15559994321"),  // From number
    "Hello world!"                    // SMS body
).create();

System.out.println(message.getSid());

Make a call

String accountSid = "ACXXXXXX"; // Your Account SID from www.twilio.com/user/account
String authToken = "XXXXXXXX"; // Your Auth Token from www.twilio.com/user/account

Twilio.init(accountSid, authToken);

Call call = Call.creator(
    new PhoneNumber("+15558881234"),  // To number
    new PhoneNumber("+15559994321"),  // From number

    // Read TwiML at this URL when a call connects (hold music)
    new URI("http://twimlets.com/holdmusic?Bucket=com.twilio.music.ambient")
).create();

System.out.println(call.getSid());

Generating TwiML

To control phone calls, your application needs to output TwiML. TwiML in twilio-java now use the builder pattern!

TwiML twiml = new VoiceResponse.Builder()
    .say(new Say.Builder("Hello World!").build())
    .play(new Play.Builder("https://api.twilio.com/cowbell.mp3").loop(5).build())
    .build();

That will output XML that looks like this:

<Response>
    <Say>Hello World!</Say>
    <Play loop="5">https://api.twilio.com/cowbell.mp3</Play>
</Response>

Documentation

The documentation for the Twilio API can be found here.

Docker Image

The Dockerfile present in this repository and its respective twilio/twilio-java Docker image are currently used by Twilio for testing purposes only.

Getting help

If you need help installing or using the library, please contact Twilio Support at help@twilio.com first. Twilio's Support staff are well-versed in all of the Twilio Helper Libraries, and usually reply within 24 hours.

If you've instead found a bug in the library or would like new features added, go ahead and open issues or pull requests against this repo!

Project Statistics

Sourcerank 12
Repository Size 27.6 MB
Stars 310
Forks 275
Watchers 87
Open issues 23
Dependencies 11
Contributors 67
Tags 248
Created
Last updated
Last pushed

Top Contributors See all

Jingming Niu Sam Kitajima-Kimbrel Evan Fossier twilio-ci Matt Nowack Alexandre Payment Carlos Diaz-Padron Christer Fahlgren jmctwilio Ilan Biala Guillaume Binet eanderle Senthil Ramakrishnan Brian Levine Frank Stratton ☺ Doug Black Kyle Conroy gramanathaiah Mitchell Friedman Ameya Lokare

Packages Referencing this Repo

com.twilio.sdk:twilio
Release Candidate for Next-Gen Twilio Java Helper Library
Latest release 7.31.0 - Updated - 310 stars
com.twilio.sdk:twilio-java-sdk
Java helper library for Twilio services
Latest release 7.0.0-rc-10 - Updated - 310 stars
com.twilio.sdk:twilio-java-sdk-video-beta
Java helper library for Twilio services
Latest release 4.5.1 - Published - 310 stars

Recent Tags See all

7.31.0 November 16, 2018
7.30.0 October 28, 2018
7.29.0 October 15, 2018
7.28.0 October 15, 2018
7.27.0 October 04, 2018
7.26.0 September 28, 2018
7.25.0 September 20, 2018
7.24.2 August 31, 2018
7.24.1 August 23, 2018
7.24.1 August 23, 2018
7.24.0 August 17, 2018
7.23.1 August 09, 2018
7.23.1 August 09, 2018
7.23.0 August 03, 2018
7.23.0 August 03, 2018

Interesting Forks See all

ServiceNow/twilio-java
A Java library for communicating with the Twilio REST API and generating TwiML. Need help? E-mail...
Java - Other - Last pushed - 1 stars - 1 forks
ActivateServices/twilio-java
A Java library for communicating with the Twilio REST API and generating TwiML. Need help? E-mail...
Java - Other - Updated - 1 stars
bdacode/twilio-java
A Java library for communicating with the Twilio REST API and generating TwiML. Need help? E-mail...
Java - Other - Updated - 1 stars
LogicDispatch/twilio-java
A Java library for communicating with the Twilio API and generating TwiML
Java - MIT - Updated - 1 stars

Something wrong with this page? Make a suggestion

Last synced: 2018-11-27 17:08:22 UTC

Login to resync this repository