GregBaugues / marketing-notifications-sinatra

Demo application showing how to implement SMS notifications (for a mobile marketing use case) with Ruby and Sinatra

SMS Notifications

Use Twilio to create SMS notifications to keep your subscribers in the loop.

Running the application

Step 1. First clone this repository and cd into it

git clone [e-mail]:TwilioDevEd/marketing-notifications-sinatra.git
cd marketing-notifications-sinatra

Step 2. Install dependencies

bundle

Step 3. Export environment variables

You can find AccountSID and the AuthToken at https://www.twilio.com/user/account/settings.

export TWILIO_ACCOUNT_SID=your account sid
export TWILIO_AUTH_TOKEN=your auth token
export TWILIO_NUMBER=your twilio number

Step 4. Create application database

Make sure you have installed PostgreSQL. If on a Mac, I recommend Postgres.app. Given that, we'll use a rake task to generate the database used by the app. You just need to provide a valid user with permission to create databases.

bundle exec rake createDb[user_name]

Step 5. Make sure the tests succeed

bundle exec rake spec

Step 6. Run the server

ruby app.rb

Step 7. Expose application to the wider internet

We can use ngrok for this purpose.

  ngrok http 4567

Step 8. Configure your Twilio number

Go to your dashboard on Twilio. Click on Twilio Numbers and choose a number to setup. On the phone number page enter the address provided by ngrok into the Messaging Request URL field.

Step 9. Wrap Up!

By now your application should be up and running at http://localhost:4567/. Now your subscribers will be able to text your new Twilio number to Subscribe to your Marketing Notifications Service.

Congratulations!

Dependencies

This application uses this Twilio helper library:

• twilio-ruby

Please visit these libraries and pay your respects.