Jak vytvořit aplikaci pro volání / zápis kongresu

Američané mají tradici komunikace se svými zástupci v Kongresu, aby vyjádřili své názory a považovali je za odpovědné. Technologové mají tradici vytváření aplikací kolem tohoto konceptu.

Nejprve si povšimněte, proč na tom záleží - nebo ne

Buďme skuteční - „psaní opakování“ (nebo volání opakování) není efektivní obhajoba, přinejmenším většinou. Je to proto, že Spojené státy jsou již plné lidí, kteří komunikují s jejich zástupci a senátory.

Každá kongresová kancelář dostává každý den stovky až tisíce zpráv. Oni je „nečtou“. Rozdělují zprávy do kbelíků, rozesílají hromadné odpovědi a pokud budete mít štěstí, pracovníci na nízké úrovni, kteří zpracovávají poštovní a telefonní hovory, mohou zástupci nebo senátorovi sdělit celkový počet zpráv přijatých na každý předmět. Dělají věci tímto způsobem ne proto, že nechtějí slyšet od svých voličů (dělají), ale proto, že už slyší od tolika voličů - víc, než dokážou držet krok.

Pokud máte za cíl usnadnit lidem s přístupem k počítačům a chytrým telefonům komunikaci s Kongresem, chillax - tito lidé to již dělají a pravděpodobně stejně ztrácí čas.

A pokud si myslíte, že komunikace více povede k větší odpovědnosti Kongresu, máte to pozpátku. Otázkou není, jak to udělat více, ale jak zefektivnit komunikaci s Kongresem.

Než začnete dále, měli byste si prostudovat následující:

a) Můj základ pro realitu občanské technologie:

b) Desetiletý výzkumný projekt Nadace kongresového managementu týkající se komunikace občanů s Kongresem:

c) Nedávné tweety od Emily Ellsworthové - zejména části o přemýšlení o tom z pohledu staffera.

d) Příspěvek Daniela Schumana ke snižování počtu zaměstnanců kongresu. Pokud chcete, aby zaměstnanci četli zprávy, pak chcete, aby Kongres přestal uříznout vlastní nohy:

Existuje ještě několik dobrých důvodů, proč se o to starat.

Druhou stránkou je, že se nemůžeme vzdát myšlenky petice naší vlády. Je to důležitá tradice a je užitečným nástrojem v rámci občanského výcviku a organizovaného úsilí o obhajobu nad rámec dopisů a výzev.

Spousta lidí má sestavené komunikační nástroje (dopisy nebo telefonní hovory). Udělal jsem to. Třikrát! Na GovTrack můžete zavolat svým zástupcům a senátorům o jakémkoli účtu prostřednictvím mého spin-off projektu phonecongress.com:

Pak je tu POPVOX (vyloučení odpovědnosti: Mám finanční vazby), countable.us (používají data GovTrack), callmycongress (také používá data GovTrack), demokracie.io (také používá data GovTrack, sorta), care2 a příčiny (petice, které se mění v písmena, myslím?) a dále a dále.

Aplikace, které vám pomohou zavolat vašemu zástupci, vám často dají skript a buď vám řeknou telefonní číslo svého zástupce, nebo jinak používají šikovný nástroj pro telefonování k vytočení složky a pak je automaticky opraví do kanceláře svého zástupce.

Šance, které chcete stavět, již existují.

Ale pokud opravdu chcete postavit podobný nástroj, zde je návod, jak neobjevit kolo.

(Nic z toho nezaměňujte s „případovou prací.“ Případovou prací je situace, kdy některý z členů požádá svého zástupce nebo senátora o pomoc s problémem, který mají s federální agenturou, jako je například nepřijetí kontroly sociálního zabezpečení. To je důležité služba, která nesouvisí s tím, o čem zde diskutuji.)

Nejprve potřebujete databázi současných zástupců a senátorů v Kongresu.

Naštěstí jsem pro to začal open source projekt:

Databáze zákonodárců kongresů obsahuje biografické a legislativní informace o každém aktuálně sloužícím zástupci a senátorovi, včetně poštovních adres kanceláře DC a telefonních čísel. Pokud použijete tato data, nezapomeňte, že se spoléháte na čas dobrovolníků, kteří je pro vás aktualizují - zvažte také pomoc.

Také mějte na paměti, že se data pravidelně mění. Pokud vaše data nejsou aktualizována každý den, možná odesíláte základní komunikaci na nesprávné místo. To je špatné. Když to jeden Kongres skončí a ten druhý začíná, trochu se to šílí. Pokud si myslíte, že je to kolem voleb nebo prezidentských inauguračních časů (není), máte před sebou hodně výzkumu.

Pak musíte určit, který zástupce a senátor reprezentuje vašeho uživatele.

Pro senátory je to snadné - zeptejte se uživatele, ve kterém z 50 států, ve kterých žijí.

Pokud uživatel nežije ve státě (obyvatelé 6 teritorií USA, cizinci žijící v zahraničí a příslušníci armády), nemá štěstí, že kontaktoval senátora, pokud nemá adresu ve státě.

Chcete-li kontaktovat zástupce (tj. Člena sněmovny reprezentantů, známého jako kongresman), musíte určit, ve kterém kongresovém okrese uživatel žije.

Neomezujte uživatele na 50 států!

Existuje 441 zástupců: 435 skutečných zástupců z 50 států a poté 6 nehlasujících delegátů z území USA. Dvě z těchto teritorií mají větší populaci než některé státy, takže je nezlevňujte jen proto, že Kongres nepovažuje ty lidi za hodné řádného zastoupení. (Pomocí databáze zákonodárců kongresů výše získáte úplný seznam států a území, které mají v Kongresu své zástupce.)

Cizinci žijící v zahraničí a příslušníci armády by měli používat adresu ve Spojených státech, pokud ji mají. Pokud tomu tak není, mají smůlu.

Nenabízejte uživateli možnost kontaktovat zástupce nebo senátora, který je nezastupuje.

Ve většině případů, pokud píšete nebo voláte senátora jiného státu nebo zástupce jiného okresu, jednoduše se o to nestarají. Váš dopis neotevřou a váš hovor nepřizpůsobí. Pokud to nabídnete svým uživatelům, ztrácíte čas.

Když zjistí, že jejich zprávy jsou nulově směrovány, nebudou šťastné. A pokud je to, na čem vám opravdu záleží, příčina a ne nástroj, pak byste chtěli, aby jejich čas využíval efektivně.

Žádost o 5místné PSČ není správné.

Pokud získáte databázi ZIP-to-district, bude to špatně 10–20% času. Je to proto, že PSČ se vůbec nesouhlasí s hranicemi kongresových okresů a jak poštovní směrovací čísla, tak hranice kongresových okresů se mění rychleji, než se tyto databáze aktualizují. (ZIP-plus-four's, 9místné PSČ, jsou poměrně spolehlivé. Mohli byste použít jejich databázi. Ale vaši uživatelé zřídka znají své ZIP + 4.)

Musíte požádat o jejich skutečnou adresu domů.

Jediným spolehlivým způsobem, jak určit kongresový okres osoby, je požádat je o domovskou adresu (kde volí), poté pomocí služby „geokódování“ přeměnit adresu na souřadnici zeměpisné šířky a délky a poté použít „geospatial“ ( GIS) databáze geografických hranic kongresového okresu. (V mobilní aplikaci můžete použít geolokaci, pokud je uživatel doma! A přeskočit první krok.)

Vyhledání kongresového okresu GovTrack

Yikes. Je těžké to udělat správně!

Stačí zaplatit společnosti jako geocod.io (bezplatná úroveň pak 1 $ za 1 000 vyhledávání) nebo CDYNE (~ 10 $ za 1 000) nebo Google Civic Information API (zdarma). Každý z nich má API, aby proměnil adresu v kongresový okres a je to docela levné. (Doporučuji geocod.io.)

Mějte na paměti:

  • Nemůžete důvěřovat API a poskytovat správné odpovědi jen proto, že tvrdí, že provádějí geokódování. Jak je to geograficky přesné? Mají poslední údaje o ulicích? Mají nejnovější hranice kongresového okresu?
  • Kolem volebních časů buďte zvlášť opatrní, protože volby jsou založeny na další sadě okresních hranic, ale kontaktování vašeho zástupce je založeno na hranicích okresů v posledních volbách, dokud se noví zástupci nezastoupí do funkce (k tomu dojde 3. ledna). Informujte se u svého poskytovatele geokódování, jaké hranice používají, a ujistěte se, že máte aktualizace ve správný čas.

Pokud chcete hodit svůj vlastní GIS nástroj…

Pokud chcete použít svůj vlastní nástroj GIS s adresou do okresu nebo alespoň porozumět tomu, s čím se s tím vším setkáte, můžete vidět, jak to děláme na GovTracku, díky nějaké úžasné práci dobrovolníka Aarona. Dennis:

A zdrojový kód:

Mapbox používáme nejen k vizuálnímu zobrazení mapy, ale také ke geokódování ulic a dotazu GIS o hranicích okresů k určení kongresového okresu (díky Mapboxu nám poskytují obrovskou slevu - ale katalogová cena se pohybuje kolem 2 $ za 1000 vyhledávání) .

Hranice kongresového okresu se periodicky mění: vždy pro volby po desetiletých sčítání lidu (2012, 2022 atd. Volební roky) a poté příležitostně kvůli redistribuci nařízenou soudem, když se státy pokoušejí lidi zbavit svobody. Navíc kolem volebních časů jsou lidé opravdu zmatení tím, kdy se aktualizace okresních hranic projeví. Pokud chcete tyto věci napravit, musíte je pečlivě sledovat a požádat o radu odborníka (jako jsem já).

Dobře, takže nyní máte číslo kongresového okresu, například AK-0 (velký kongresový okres Alaksa) nebo NY-13 (13. kongresový okres New York). Pomocí databáze zákonodárců kongresů, která byla zmíněna výše, můžete zjistit, kdo je zástupce, a to buď poštovní adresu nebo telefonní číslo.

Poštovní pošta je v pořádku, ale je pomalá.

Odeslání dopisu poštou na adresu zástupce nebo senátorské kanceláře (obvykle na jejich adresu DC) je dobré. To je zcela přijatelný způsob, jak kontaktovat Kongres.

Veškerá poštovní zásilka směřující do kanceláří Capitol v USA je ozařována na místě mimo lokalitu, aby se lidé chránili před antraxem nebo podobně. To způsobí zpoždění několika týdnů u všech poštovních zásilek. To je v pořádku, pokud vám nebude vadit pošta přicházející pozdě.

A samozřejmě musíte zaplatit poštovné.

Místo toho faxujte. To je prostě divné. Žádný zástupce nebo senátor již nemá fax. Jejich faxová čísla jsou virtuální faxy, které jim pouze pošlou e-mailem skenování toho, co bylo faxováno. Je to divný. Nedělejte to. Nechte je jít od technologie 90. let.

A co e-mail?

Zástupci a senátoři nemají e-mailové adresy, alespoň ne ty, které dávají voličům.

A co webové formuláře?

Všichni místo toho mají na svých webových stránkách kontaktní formulář. Použití kontaktního formuláře na webu je dobrý způsob, jak je kontaktovat. Není to méně efektivní než poštovní dopis. Mohlo by to být účinnější, protože jde přímo do systému, který zástupce nebo senátor používá k třídění a počítání jejich pošty. Chcete se počítat, takže to je to, co chcete.

Pokud však chcete vytvořit aplikaci, která ve skutečnosti dopis odešle, takže složka nemusí formulář vyplnit sama, automatizace je obtížná. Nezkoušejte. Udržování automatizovaného systému, který spolehlivě vyplňuje tyto webové formuláře, je časově velmi náročné. Vypočítat. Pokud existuje 541 zástupců a senátorů a každý z nich jednou ročně upraví svůj webový formulář, každý den se musíte vypořádat s více než jednou změnou formuláře.

Existuje komunitní projekt, který se snaží vyřešit:

a je to základ https://democracy.io/, ale nevím, jak tato data použít, nebo zda jsou spolehlivá.

(Kromě toho, že se sem nedostanu, existují další nevyřešitelné problémy.)

Místo toho můžete, a pouze pro zástupce, požádat o zasílání dopisů voličům elektronicky prostřednictvím nového API Sněmovny reprezentantů:

Ještě lepší je, že za to zaplatíte společnost jako VoterVoice (používají data GovTrack) nebo POPVOX (viz předchozí prohlášení). Bude to mnohem levnější, pokud zaplatíte pouze někomu, kdo vám zprávy pošle, než kdybyste sami vytvořili nový systém.

Pokud píšete dopis, nabídněte šablonu.

Pokud pomáháte uživateli napsat dopis, nabídněte šablonu a užitečné rady. Dejte jim nejlepší šanci, aby byli efektivní a neztráceli čas:

a) Vyjádřete se jasně, co chcete, aby člen Kongresu udělal, tj. jak hlasovat o návrhu zákona (uveďte číslo a název účtu), zda chcete cosponovat účet atd. Ujistěte se, že požadujete něco, co člen Kongresu skutečně může.

b) Nechte uživatele napsat krátkou osobní zprávu - nejlepší je krátký osobní příběh. Důležité je ukázat, že uživatel je skutečně ovlivněn problémem, o kterém se chystáte psát, a odlišuje dopisy od ostatních bez osobních příběhů.

c) Buďte uctiví. Nevyžadujte. Nevytvářejte hrozby, že pro ně nebudete hlasovat (je to prázdná hrozba!). A rozhodně nemluvte o tom, jak přispět nebo neinvestovat do kampaně - to by mohlo být nezákonné (je to potenciálně úplatkářství!). Nezapomeňte, že to je v podstatě málo placení stážisté, kteří čtou poštu, a vaším úkolem je přimět stážisty, aby vám pomohl - nechci vás ignorovat.

Telefonní hovory fungují také, ale buďte ještě ohleduplnější.

Konečně je tu telefonní hovor.

Telefonní hovor je v pořádku. Ale. Prosím, buďte o to zodpovědnější, protože vaše uživatele budou mluvit o skutečné lidské bytosti na druhé straně, která si zaslouží respekt stejně jako kdokoli jiný. Využíváte také drahocenný čas kanceláře, takže si prosím uvědomte, že nejste jediný člověk, jehož potřeby jsou důležité - kancelář má i další složky, které by jim měly pomoci.

Takže kampaň telefonních hovorů bude zřejmě efektivnější než kampaň na psaní dopisů. Křičet hlasitěji bývá účinnější. Nemyslete si, že se jedná o technologii nebo nalezení tajné metody obhajoby. Jednoduše křičíte, když používáte telefon, a eskalujete závodní zbrojení, že jsou hlasité.

[Toto již neplatí od začátku roku 2017.] V GovTracku používám Twilio. Dávám uživateli skript pro čtení při telefonním hovoru. Zadají své telefonní číslo a GovTrack je zavolá a - prostřednictvím Twilio - spojí svůj hovor s kanceláří svého zástupce. Výše uvedená databáze zákonodárců kongresů obsahuje telefonní čísla, která potřebujete.

Můžete vidět můj zdrojový kód:

Použití Twilio jako je tato má dvě výhody:

a) Je o něco jednodušší zavolat uživateli, než nechat zavolat jeho zástupce.

b) Zaznamenávám hovory (se souhlasem uživatele) a poslouchám je, abych pochopil, zda jsou tyto telefonní hovory smysluplné. Jsou to pro mě cenné údaje, stejně jako jiné analytické aplikace.

Stejně jako poštovní dopis má telefonní hovor transakční cenu, ale podle ceny společnosti Twilio je to asi 10x levnější než poštovné.

Musíte nahlásit svá čísla a respektovat instituci.

Je až příliš snadné říci, že jste měli milion uživatelů psát nebo volat Kongres, ale pokud nedoručíte zprávy rychlým a efektivním způsobem, pak jste prodali hadí olej - což by ohrozilo samotnou instituci petiční vlády. To jsou skutečné věci. Při vytváření nástrojů, jako je tento, máme obrovskou etickou odpovědnost.

Vím, že výzvy, které je třeba překonat, aby byly účinné, budu na ně zavolat, pokud nevidím, že jste je řešili.

  1. Pokud doručujete písemné zprávy Kongresu, musíte nahlásit, kolik zpráv bylo úspěšně přijato. Pokud tak neučiníte, předpokládám, že nevydáváte všechny své uživatelské zprávy, a já vám na ně zavolám.
  2. Pokud máte uživatele, kteří telefonují, musíte nahlásit, kolik času strávíte zaměstnanci, a musíte nahlásit, jak jste ověřili, že vaši uživatelé neobtěžují kongresový personál. Pokud se neobtěžujete kontrolovat, zavolám vám.

Od přidání tohoto nástroje do GovTrack v roce 2013 uživatelé uskutečnili 5 288 hovorů do Kongresu s průměrnou dobou trvání hovoru (u spojených hovorů) 85 sekund. Téměř každý kongresový okres byl volající. To je parádní. Jak jsem zmínil výše, zaznamenávám hovory a nechám si zkontrolovat, zda jsou slušné.

A to je to, co vím o psaní a volání vašeho zástupce. Aktualizuji tento příspěvek, když přemýšlím o jiných věcech.

Více než deset let pracuji na vytváření otevřené infrastruktury kolem kongresových dat. Je to těžká práce. Sotva vydělám nějaké peníze, když na to trávím čas. Pokud používáte moje věci, přemýšlejte o tom, jak můžete přispět zpět do otevřeného legislativního ekosystému dat a / nebo přesvědčit své investory, aby mě financovali… myslím… to.