twiliodeved / receive-mms-rails Goto Github PK

View Code? Open in Web Editor NEW

6.0 21.0 1.0 1005 KB

Process SMS and MMS messages received by the application using rails

License: MIT License

Ruby 76.46% JavaScript 6.91% HTML 14.17% SCSS 2.47%

ruby rails mms twilio twilio-sms

receive-mms-rails's Introduction

Receive MMS: Process MMS messages received by the application using rails

About

Use Twilio to receive SMS and MMS messages. For a step-by-step tutorial see the Twilio docs.

Note: protect your webhooks

Twilio supports HTTP Basic and Digest Authentication. Authentication allows you to password protect your TwiML URLs on your web server so that only you and Twilio can access them.

Learn more about HTTP authentication here, which includes sample code you can use to secure your web application by validating incoming Twilio requests.

Local development

This project is built using the Ruby on Rails web framework and NodeJS to serve assets through Webpack.

First clone this repository and cd into it

$ git clone [email protected]:TwilioDevEd/receive-mms-rails.git
$ cd receive-mms-rails

Install Rails dependencies
```
$ bundle install
```
Install Node dependencies
```
$ npm install
```
Copy the sample configuration file and edit it to match your configuration
```
$ cp .env.example .env
```
You can find your TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN in your Twilio Account Settings. You will also need a TWILIO_NUMBER, which you may find here.
Create database and run migrations
```
$ bundle exec rails db:setup
```
Make sure the tests succeed
```
$ bundle exec rspec
```
Run the server
```
$ bundle exec rails s
```
Expose your application to the wider internet using ngrok. This step is important because the application won't work as expected if you run it through localhost.
```
$ ngrok http 3000
```
Once ngrok is running, open up your browser and go to your ngrok URL. It will look something like this: http://9a159ccf.ngrok.io

You can read this blog post for more details on how to use ngrok.
Configure Twilio to call your webhooks

You will also need to configure Twilio to call your application when calls are received on your TWILIO_NUMBER. The voice url should look something like this:
```
http://6b5f6b6d.ngrok.io/mms_resources
```

How to Demo

Send an MMS to your twilio number
Access http://localhost:3000. You should see a list with all the resources sent through your MMS

receive-mms-rails's People

Contributors

Stargazers

Watchers

receive-mms-rails's Issues

Dependabot can't resolve your Ruby dependency files

Dependabot can't resolve your Ruby dependency files.

As a result, Dependabot couldn't update your dependencies.

The error Dependabot encountered was:

Bundler::VersionConflict with message: Bundler could not find compatible versions for gem "ruby":
  In Gemfile:
    ruby (~> 3.0)

    pg was resolved to 1.2.3, which depends on
      ruby (>= 2.2, < 2.8.dev) x64-mingw32

    rack-mini-profiler (>= 2.3.0, <= 2.3.1) was resolved to 2.3.1, which depends on
      ruby (>= 2.4.0)

If you think the above is an error on Dependabot's side please don't hesitate to get in touch - we'll do whatever we can to fix it.