In this post I’d like to quickly show you how easy it is to add SMS to your web app then give you a more in-depth look at how Twilio works as well as some more robust use-cases for SMS.
This post was inspired by a conversation I had with a friend shortly after joining Twilio. We were talking about API’s when he nonchalantly explained that he himself used Twilio to send SMS notifications from his web app. As proof he then turned his laptop around to face me and pointed to the “four lines of code [he] added” to enable SMS.
Certainly it is not always that simple. Some of our biggest customers have built entire businesses around the Twilio Platform, but everyone has to start somewhere and in my opinion these four lines of code are the place to start.
So without further adieu, I present the four lines (okay, throw in a couple extra for proper formatting) needed to send an SMS from your web app:
<?php require __DIR__ . '/twilio-php-master/Twilio/autoload.php'; use Twilio\Rest\Client; $client = new Client($sid, $token); $client->messages->create( '+15558675309', // number to send to array( 'from' => '+15017250604', // your Twilio number 'body' => "There’s something strange in my neighborhood. I don’t know who to call. Send help!" ) );
Or how about Ruby:
require 'twilio-ruby' @client = Twilio::REST::Client.new account_sid, auth_token message = @client.messages.create( body: "I’m tired of having my arms cut off by snow-blowers. Please help Mr. hmmm... I forgot your name.", to: "+12345678901", # Replace with your phone number from: "+12345678901") # Replace with your Twilio number puts message.to
To see more awesome examples including node.js, python, C# or java visit the Twilio docs.
So now that we’ve gotten that out of the way, let’s quickly discuss how Twilio accomplishes this task.
How Twilio Works
When you send an SMS/MMS from your web app using Twilio it works like this:
As you can see sending an SMS is pretty straight forward, in fact all of this interaction is triggered with just those four lines I showed you above. But what if you want that user to be able to respond to your outgoing message? Well then your Twilio Phone Number needs some extra instructions, specifically what to do when it receives an incoming SMS.
When an SMS is received by your Twilio Number it looks something like this:
Now that we’ve looked at how Twilio interacts with your web application at a high level, it’s time to put our gloves on and dig in. We’ll start by doing some basic setup.
Setup: Get your free Twilio number and install a helper library
Sign up at Twilio to get your free Twilio number. Once you sign up click on Numbers to see your number.
If you plan on receiving SMS messages with your web app you will also need somewhere to host your TwiML instructions. There are lots of web hosting services that will host your application for free or cheaply including Heroku and Googles AppEngine.
Installing the Helper Library
Twilio helper libraries give you the ability to interact with the Twilio REST API in the language of your choice. Installing the libraries is usually quite straightforward. For example, to install the Ruby helper library you could just install the gem like so:
gem install twilio-ruby
Here are some of officially supported Twilio helper libraries:
Click to get installation instructions and further documentation
- twilio-php (Download .zip) – Official PHP Twilio REST API and TwiML library
- twilio-ruby – Official Ruby gem for the Twilio API
- twilio-python – Official Python module for the Twilio API
- twilio-csharp – Official .NET library for the Twilio API
- twilio-java – Official Java library for the Twilio API
- twilio-node – Official Node.js Twilio helper library
To view all of the available helper libraries visit the Twilio docs.
Once you’ve installed the helper library of your choice it’s time to use the REST API to send and receive SMS Messages.
Next Step: Read the docs
If you’ve worked with APIs in the past you might just want to dive in to the API docs. The Twilio REST API documentation is fully stocked with examples to help you dive in. However if you’re like me and you prefer a more tutorial approach check out the Twilio Quickstart, which will walk you through sending and receiving your first SMS.
Quickstart: Sending and Receiving an SMS (uses PHP)
Congratulations, now you’re able to add SMS capabilities to any of your web apps in minutes.
Once you’ve grasped these basic concepts consider upping the ante and adding even more sweetness to your application. Here are some popular ideas:
- Two-factor Authentication: Keep the SPAM out
- SMS Notifications
- Proactive Alerts
- Mobile App Distribution: Text to download – mobile solution
Well I hope this taste of the Twilio API has left you excited to learn even more. Many of my colleagues have written awesome tutorials on using SMS for even cooler purposes. Here are a few of my favorites. Happy hacking.