eztexting-java

A Java client for the EZ Texting SMS text messaging API

Overview

EZ Texting provides an API for sending SMS text messages.

You will need an account to use this library. Consult the API Documentation

This library does not implement all the features of their API.
This library can:

• Send SMS messages
• Manage Contacts
• Manage Groups
• Carrier Lookup

This library cannot:

• Manage Inbox
• Manage Keywords
• Manage Credits
• Voice Broadcast

If you need a feature implemented, please submit a pull request or file an issue.

Basic Usage

Sending a SMS message

    EzTextingClient ez = new EzTextingClient(
        new EzTextingCredentials("username","password"));
    Messaging messaging = new Messaging(ez);
    Message message = new Message.Builder()
        .subject("test")
        .message("Here I am EZ Texting")
        .phone("5551234567")
        .build();
    messaging.send(message);

Managing Groups

    GroupManager groups = new GroupManager(ez);
    Group group = groups.create("neat");
    GroupQuery query = new GroupQuery.Builder()
        .sortBy(SortBy.GROUP_NAME)
        .itemsPerPage(10)
        .page(1)
        .build();
    List<Group> all = groups.retrieveAll(query);

Managing Contacts

    ContactManager contacts = new ContactManager(ez);
    CreateRequest request = new CreateRequest.Builder()
        .phone("5551234567")
        .first("first")
        .last("last")
        .email("my@email.com")
        .group("group1")
        .group("group2")
        .build();
    Contact contact = contacts.create(request);

    UpdateRequest update = new UpdateRequest.Builder()
        .email("another@email.com")
        .group("group1", "group3")
        .build();
    contact = contacts.update(contact, update);
    contacts.delete(contact);
    
    ContactQuery query = new ContactQuery.Builder()
        .query("5551234567")
        .sortBy(SortBy.LAST_NAME)
        .ascending()
        .itemsPerPage(100)
        .build();
    List<Contact> found = contactManager.retrieveAll(query);
    

Dependencies

• Jersey Client 1.18.1 for HTTP I/O
• Jackson 2.3.3 for JSON parsing

Maven 2 Support

This library is in the Maven Central Repository.

<dependencies>
    <dependency>
        <groupId>com.github.krenfro</groupId>
        <artifactId>eztexting-java</artifactId>
        <version>0.0.3</version>
    </dependency>
</dependencies>