This is an application that uses the Twilio API for WhatsApp and the Spotify API to build a collaborative playlist.
Read how to build a collaborative playlist over WhatsApp with Rails, Twilio and Spotify on the Twilio blog.
You can see the application and play with it at https://twilio-whatsapp-spotify.herokuapp.com/.
You will need a few things to run this application.
- Ruby installed, I'm using the latest, 2.5.1
- Rails and bundler, which you can install with
gem install rails bundler - A Twilio account (sign up for a free Twilio account here)
- Your WhatsApp sandbox set up in your Twilio account
- A Spotify developer account
- ngrok, so we can tunnel through to our locally developed application to use webhooks
To work with the Spotify API we will need to generate some API credentials. From the Spotify developer dashboard create a new application and follow the 3 step process.
- First, some details about your app. Name it, I called mine WhatsPlaying, provide a short description and check what app type it is, I chose "website"
- Next you're asked if this is a commercial integration, choose "no"
- Finally, check the agreements
Once you've completed these steps you will see the application dashboard. You will need the Client ID and Client Secret from this page.
There's one more thing we need to do here. Click on "edit settings", enter the redirect URL http://localhost:3000/auth/spotify/callback and click "add".
Clone the application, change into the directory and install the dependencies with bundler.
git clone https://github.com/philnash/whats_playing.git
cd whats_playing
bundle installCopy config/env.yml.example to config/env.yml and fill in the Spotify Client ID and Secret. Then, start the application:
bundle exec rails serverOpen localhost:3000 and sign in with Spotify. When you complete the OAuth flow you will be presented with the remaining Spotify credentials that you need. Copy these and enter them into config/env.yml.
Restart the application and load the home page again. You will see an empty embedded playlist (which you will also find in your Spotify account now).
To protect the Twilio endpoint from other access, this project uses the Twilio Rack middleware protection. To enable this, add your Twilio Auth Token to config/env.yml.
To use this with the Twilio API's WhatsApp Sandbox you will need to enable the sandbox in your Twilio console. Once you've done that you need to connect the WhatsApp to your application.
If you are running the app locally, I recommend using ngrok to give you a public URL that tunnels through to your development machine.
Connect the WhatsApp sandbox number to your application by filling in the webhook URL with https://YOUR_APP_URL/twilio/messages.
Start the application with
bundle exec rails serverThen send the WhatsApp sandbox number the name of a song. And enjoy!
Found something broken or want to improve the code, please get in touch by opening an issue or submitting a pull request!
This repo is covered by the MIT license.