How to Send SMS in Ruby Using Plivo’s SMS API

Your company has settled on Plivo to handle its voice and messaging communications, and now it’s your job to start integrating Plivo into your company’s applications. Don’t worry — Plivo has an SDK to help you out. Let’s see how to send and receive messages through Plivo in a Ruby application.

Install the Plivo SDK

gem install plivo

If you prefer to install from source code or run a beta branch, visit our Quickstart Guide for instructions.

Find your Auth ID and Auth Token

Choose a phone number

The SMS regulations followed by the carriers vary from country to country. For messages to countries other than the US and Canada, you might want to register an alphanumeric sender ID for your messages. You can learn more about the use of alphanumeric sender ID and register one from your Plivo Console.

Send an SMS message

require 'rubygems'
require 'plivo'
include Plivoclient ="auth_id", "auth_token")
message_created = client.messages.create(
'Hello, world!'

Replace the placeholders auth_id and auth_token with actual values from your Plivo Console. Save the file as SendSMS.rb. Run it using the command:

ruby SendSMS.rb

Note: If you’re using a Plivo trial account, you can send messages only to phone numbers that have been verified with Plivo. You can verify a phone number using the Sandbox Numbers page of the Console.

Receive an SMS message

First, create a file called receive_sms.rb (or whatever name you like) with this code in it:

require "sinatra"get "/receive_sms/" do
from_number = params[:From]
to_number = params[:To]
text = params[:Text]
puts "Message received - From: #{from_number}, To: #{to_number}, Text: #{text}"

Run it with the command

ruby receive_sms.rb

You should then be able to see your basic server app in action on http://localhost:4567/receive_sms/.

That’s fine for testing, but it’s not much good if you can’t connect to the internet to receive incoming messages and handle callbacks. For that, we recommend using ngrok, which exposes local servers behind NATs and firewalls to the public internet over secure tunnels. Install it and run ngrok on the command line, specifying the port that hosts the application on which you want to receive messages:

Ngrok will display a forwarding link that you can use to access your local server using the public network.

Now you can create an application to receive SMS messages (follow our Quickstart guide for details).


Haven’t tried Plivo yet? Getting started is easy and only takes 5 minutes! Sign up today.

Originally published at on Jan 20, 2021.

Developer Evangelist