Programmable Messaging for WhatsApp Ruby Quickstart

With just a few lines of code, your application can send and receive messages with WhatsApp using the Twilio API for WhatsApp.

This WhatsApp Quickstart will teach you how to do this using the Twilio Sandbox for WhatsApp, Ruby, the Twilio Ruby Twilio helper library, and the Sinatra web framework. In this Quickstart, you will learn how to:

1. Sign up for Twilio and activate the Sandbox.
2. Set up your development environment to send and receive messages
3. Opt-in to the Sandbox
4. Send your first WhatsApp message
5. Receive inbound WhatsApp messages
6. Reply to incoming WhatsApp messages

Prefer to watch a video? The video below shows you how to use the Sandbox to send and receive WhatsApp messages.

---

Sign up for Twilio and activate the Sandbox

Before you can send a WhatsApp message from your web language, you'll need to sign up for a Twilio account or sign into your existing account and activate the Twilio Sandbox for WhatsApp. It allows you to prototype with WhatsApp immediately using a shared phone number, without waiting for a dedicated number to be approved by WhatsApp.

To get started, select a number from the available sandbox numbers to activate your sandbox.

join <your sandbox keyword>" to your Sandbox number in WhatsApp to join your Sandbox, and we'll reply with a confirmation that you've joined. Your sandbox keyword can be found in the console.

Once you join, you will only receive messages from your specific Sandbox. To disconnect from the sandbox, you can reply to the message from WhatsApp with sandbox stop, or switch to a different sandbox by messaging join <other sandbox keyword>.

Ruby

_17

# Download the helper library from https://www.twilio.com/docs/ruby/install

_17

require 'rubygems'

_17

require 'twilio-ruby'

_17

_17

# Find your Account SID and Auth Token at twilio.com/console

_17

# and set the environment variables. See http://twil.io/secure

_17

account_sid = ENV['TWILIO_ACCOUNT_SID']

_17

auth_token = ENV['TWILIO_AUTH_TOKEN']

_17

@client = Twilio::REST::Client.new(account_sid, auth_token)

_17

_17

message = @client.messages.create(

_17

from: 'whatsapp:+14155238886',

_17

body: 'Hello there!',

_17

to: 'whatsapp:+13233633791'

_17

)

_17

_17

puts message.sid

Output

_24

{

_24

"account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",

_24

"api_version": "2010-04-01",

_24

"body": "Hello there!",

_24

"date_created": "Thu, 24 Aug 2023 05:01:45 +0000",

_24

"date_sent": "Thu, 24 Aug 2023 05:01:45 +0000",

_24

"date_updated": "Thu, 24 Aug 2023 05:01:45 +0000",

_24

"direction": "outbound-api",

_24

"error_code": null,

_24

"error_message": null,

_24

"from": "whatsapp:+14155238886",

_24

"num_media": "0",

_24

"num_segments": "1",

_24

"price": null,

_24

"price_unit": null,

_24

"messaging_service_sid": "MGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",

_24

"sid": "SMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",

_24

"status": "queued",

_24

"subresource_uris": {

_24

"media": "/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages/SMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Media.json"

_24

},

_24

"to": "whatsapp:+13233633791",

_24

"uri": "/2010-04-01/Accounts/ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Messages/SMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.json"

_24

}

---

Receive and reply to messages from WhatsApp

When someone replies to one of your messages, you will receive a webhook request from Twilio.

You can configure webhooks by connecting your Sandbox to an app you've already built for handling incoming messages, or build a new one for WhatsApp messages.

Rate this page:

12345