Skip to content

EFForg/call-congress

 
 

Repository files navigation

Call Power

Connecting people to power through their phones.

The admin interface lets activists:

  • Create and edit campaigns
  • Adjust call targets and phone numbers
  • Record audio prompts and select versions
  • Easily embed campaign forms on their website
  • View campaign statistics and system analytics

The server lets callers:

  • Dial in directly to the campaign number
  • Fill out a web form and get a call back on their phone
    • specifying a target directly
    • or entering their zip code to look up their location
  • Reference a script during the call

Campaign Configuration

  1. Create a campaign with one of several types, to determine how callers are matched to targets.
  • Executive connects callers to the Whitehouse Switchboard, or to a specific office if known
  • Congress connects callers to their Senators, Representative, or both. Uses the OpenStates API.
  • State connects callers to their Governor or State Legislators. Uses the OpenStates API.
  • Local connects callers to a local official. Campaigners must enter these numbers in advance.
  • Custom can connect callers to corporate offices, local officals, or any other phone number entered in advance.
  1. Choose targets by segmenting on user location (determined by zipcode or lat/lon), and order by legislative chamber or random shuffle. For local and custom campaigns, campaigners can set a specific order by drag-and-drop.

  2. Record audio prompts in the browser (Firefox/Chrome only), or edit with another program and upload as MP3 files. For dynamic prompts, you can also text-to-speech templates. Reuse versions between campaigns, or adjust your prompts as the campaign evolves.

  3. Review the campaign setup, place a test call to yourself, and get the script to embed in your action platform.

Action Integration

For most uses, you can just place the <script> tag provided in the launch page into your action platform. This will add a post-submit callback to your action form to connect the caller, and optionally display the script in a lightbox.

For more complex integrations, Call Power provides javascript embeds and a full json API.

Installation Instructions

This application should be easy to host on Heroku, with Docker, or directly on any WSGI-compatible server. Requires Python, flask, a SQL database (we recommend Postgres, but Mysql should work), Redis or Memcache, and an SMTP server.

Read detailed instrustions at INSTALLATION.md

Political Data

Political data is downloaded as CSV files stored in this repository. These are read on startup and saved in a memory cache for fast local lookup.

To update these files with new data after elections, run cd call_server/political_data/data && make clean && make, and python manager.py loadpoliticaldata

Code License

See the license file for licensing information under the GNU AGPL. This license is applicable to the entire project, sans any 3rd party libraries that may be included.

About

a simple server that connects calls between citizens and their congress person using the Twilio API

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 54.6%
  • JavaScript 22.3%
  • HTML 19.8%
  • CSS 2.3%
  • Shell 0.3%
  • Dockerfile 0.3%
  • Other 0.4%