Twilio Bulk Lookup

by cweems

GitHub Readme.md

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:

Setup

Deploy

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')
  1. 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

  1. 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.

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

  3. Add your Twilio Credentials screen shot 2018-07-25 at 4 42 01 pm

  4. Import your CSV of Phone Numbers on the Contacts Page screen shot 2018-07-25 at 4 35 10 pm

  5. Click the bulk lookup button on the Dashboard Page screen shot 2018-07-25 at 4 35 34 pm

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

  7. Download your results from the Contacts Page as a CSV, TSV, or Excel. screen shot 2018-07-25 at 4 45 14 pm