NOT SUPPORTED OR MAINTAINED BY TWILIO, USE AT YOUR OWN RISK.

Bulk Lookup for Twilio

Twilio lookup allows you to determine if a phone number is a mobile number or a landline. This project allows you to upload a CSV, run a bulk lookup, and then download a CSV with information from the Lookup API.

Prerequesites

Before you start, you'll need the following:

• A Twilio Account
• A Heroku Account
• The Heroku CLI installed

Setup

You can also clone this repository and run the app locally.

1. Create your first admin user via the command line:

Heroku:

$ heroku run rails console
> AdminUser.create(email: 'your_email@mail.com', password: 'your_pass', password_confirmation: 'your_pass')

Locally:

$ rails c
> AdminUser.create(email: 'your_email@mail.com', password: 'your_pass', password_confirmation: 'your_pass')

2. twilio-bulk-lookup uses Redis for queueing paralell requests. You will need to have redis installed in your environment:

Heroku: heroku addons:create heroku-redis:hobby-dev

Local setup: https://redis.io/topics/quickstart

3. Set REDIS_URL environment variable to be the URL of your redis instance. If you are running the app locally, this will be something like redis://localhost:6379/1.

4. Visit your heroku application and log in using the credentials you entered above.

5. Add your Twilio Credentials

6. Import your CSV of Phone Numbers on the Contacts Page

7. Click the bulk lookup button on the Dashboard Page

8. Wait for your lookup to process. It will take rougly 1 hour to process 4,000 contacts.

9. Download your results from the Contacts Page as a CSV, TSV, or Excel.