Как да изградите приложение за обаждане / писане на конгреса

Американците имат традиция да общуват със своите представители в Конгреса, за да изразят своите възгледи и да ги считат за отговорни. Технолозите имат традиция да изграждат приложения около тази концепция.

Първо нека бъдем истински защо това е важно - или не

Нека бъдем истински - „писането на представител“ (или повикване на представител) не е ефективно застъпничество, не през повечето време поне. Това е така, защото Съединените щати вече са пълни с хора, които общуват със своя представител и сенатори.

Всеки конгресен офис получава стотици до хиляди съобщения всеки ден. Те не ги "четат". Те сортират съобщенията в кофи, изпращат групови отговори и ако имате късмет, служителите на ниско ниво, които обработват съставни съобщения и телефонни обаждания, могат да кажат на представителя или сенатора общ брой съобщения, получени по всяка тема. Те правят нещата по този начин не защото не искат да чуят от своите избиратели (те го правят), а защото вече чуват от толкова много избиратели - повече, отколкото могат да бъдат в крак.

Ако целта ви е да улесните хората, които имат достъп до компютри и смарт телефони, да общуват с Конгреса, chillax - тези хора вече го правят и вероятно така или иначе си губят времето.

И ако мислите, че общуването с повече ще направи Конгреса по-отчетлив, вие го имате назад. Въпросът не е как да го направим повече, а как да направим общуването с Конгреса по-ефективно.

Преди да продължите, трябва да изучите следното:

а) Моят грунд за реалността на гражданските технологии:

б) Изследователският проект на Фондацията за управление на конгреса от десетилетие на комуникацията на гражданите с Конгреса:

в) Последните туитове от Емили Елсуърт - особено частите за обмислянето му от гледна точка на служителя.

г) Пост на Даниел Шуман относно съкращението на персонала в Конгреса. Ако искате да има персонал, който да чете съобщенията, тогава искате Конгресът да спре да отрязва собствените си крака:

Все още има няколко добри причини да се грижите за това.

Обратната страна е, че не можем да се откажем от идеята да отправим петиция към нашето правителство. Това е важна традиция и е полезен инструмент като част от обучението на гражданите и организираните усилия за застъпничество, които надхвърлят писмата и призивите.

Много хора имат изградени съставни средства за комуникация (писма или телефонни обаждания). Направих го. Три пъти! В GovTrack можете да се обадите на своя представител и на сенаторите за всяка сметка чрез моя проект за spin-off phonecongress.com:

След това има POPVOX (отказ от отговорност: имам финансови връзки), countable.us (те използват данните на GovTrack), callmycongress (също използва данните на GovTrack), demokracija.io (също използва GovTrack данни, сорта), care2 и причини (петиции, които се превръщат в букви мисля?), и на и нататък.

Приложенията, които ви помагат да се обадите на вашия представител, често ви дават скрипт и или ви казват телефонния номер на вашата представителка, или другояче използва елегантен инструмент за телефония, за да наберете съставните части и след това автоматично да ги свържете в офиса на представител.

Вероятно е това, което искате да изградите, вече съществува.

Но ако наистина искате да създадете подобен инструмент, ето как да не преоткриете колелото.

(Не бъркайте нищо от това с „работа по делата“. Работата по казуси е, когато избирателят моли своя представител или сенатор за помощ по проблем, който имат с федерална агенция, като например, че не получава проверка на социалното осигуряване. Това е важно услуга, която няма връзка с това, което обсъждам тук.)

Първо, имате нужда от база данни на настоящите представители и сенатори в Конгреса.

За щастие има проект с отворен код, който започнах за това:

Базата данни на законодателите на конгреса съдържа биографична и законодателна информация за всеки действащ представител и сенатор, включително пощенски адреси и офисни номера на офиса на DC. Ако използвате тези данни, моля, не забравяйте, че разчитате на времето на доброволците, които го актуализират за вас - моля, помислете и за помощ.

Също така имайте предвид, че данните се променят редовно. Ако данните ви не се актуализират всеки ден, може да изпращате съставни съобщения до неправилното място. Това е лошо. И малко се побърква, когато един конгрес приключи и следващият започне. Ако смятате, че е около изборът или времето за встъпване в длъжност на президента (не е), ви предстоят много изследвания.

След това трябва да определите кой представител и сенатор представлява вашия потребител.

За лесно сенаторите - просто попитайте потребителя в коя от 50-те държави живеят.

Ако потребителят не живее в държава (жители на 6-те територии на САЩ, експатрианти, живеещи в чужбина, и военнослужещи), той няма късмета да се свърже със сенатор, освен ако няма адрес в държавата.

За да се свържете с представител (т.е. член на Камарата на представителите, известен още като конгресспер), трябва да определите в кой конгресен район живее потребителят.

Не ограничавайте потребителите до 50 щата!

Има 441 представители: 435 реални представители от 50-те щата и след това 6 делегати без право на глас от териториите на САЩ. Две от тези територии имат по-голямо население от някои щати, така че не ги намалете само защото Конгресът не смята тези хора за достойни представителство. (Използвайте по-горе базата данни на законодателите на конгреса, за да получите пълен списък на щатите и териториите, които имат представители в Конгреса.)

Емигрантите, живеещи в чужбина и военнослужещите, трябва да използват адрес в САЩ, ако имат такъв. Ако нямат, те нямат късмет.

Не предлагайте на потребителя възможността да се свърже с представител или сенатор, който не ги представлява.

В повечето случаи, ако напишете или се обадите на сенатор от друга държава или представител на друг район, те просто няма да се интересуват. Те няма да отворят писмото ви и няма да определят обаждането ви. Ако предлагате това на своите потребители, вие губите времето им.

Когато се хванат за това, че съобщенията им стават нулеви, те няма да са щастливи. И ако това, което наистина ви интересува, е кауза, а не инструмент, тогава очевидно искате да използвате времето им ефективно.

Питането за 5-цифрения им пощенски код не е правилно.

Ако получите база данни с пощенски код до район, това ще бъде грешно 10-20% от времето. Това е така, защото пощенските кодове изобщо не са в съответствие с границите на конгреса на конгреса и двете пощенски кодове и границите на окръжния конгрес се променят по-бързо от актуализирането на тези бази данни. (ZIP-плюс-четири, 9-цифрените пощенски кодове, са доста надеждни. Бихте могли да използвате база данни с такива. Но вашите потребители рядко ще знаят своите ZIP + 4.)

Трябва да попитате за техния действителен домашен адрес.

Единственият надежден начин за определяне на конгресния район на даден човек е да ги попитате за домашния им адрес (където той гласува), след което с помощта на услуга „геокодиране“ да превърнете адреса в координата на географска ширина и след това да използвате „геопространство“ ( GIS) база данни за географските граници на конгреса на конгреса. (В мобилно приложение можете да използвате геолокация, ако потребителят е у дома! И пропуснете първата стъпка.)

Изследване на окръжния конгрес на GovTrack

Олеле. Трудно е да се направи това правилно!

Трябва само да платите на компания като geocod.io (безплатен ред след това $ 1 на 1000 търсения) или CDYNE (~ 10 $ на 1000) или Google Civic Information API (безплатно). Всеки от тях има API, за да превърне адрес в конгресен район и е доста евтин. (Препоръчвам geocod.io.)

Имайте предвид:

  • Не можете да се доверите на API, за да предоставите верни отговори, само защото казват, че правят геокодиране. Колко географски точен е? Имат ли скорошни данни за улицата? Имат ли последните граници на конгреса на конгреса?
  • Около времето на изборите бъдете изключително внимателни, защото изборите се основават на следващия набор от граници на окръга, но контактуването с вашия представител се основава на границите на окръга при последните избори, докато новите представители не встъпят в длъжност (това се случва на 3 януари). Проверете при вашия доставчик на геокодиране какви граници използват и се уверете, че получавате актуализации в точното време.

Ако искате да прехвърлите свой собствен GIS инструмент ...

Ако искате да представите свой собствен GIS инструмент за обръщане към област или поне да разберете с какво се захващате с нещо от това, можете да видите как го правим в GovTrack тук, благодарение на страхотна работа на доброволец Аарон Денис:

И изходен код:

Използваме Mapbox за не само визуално показване на карта, но и за геокодиране на адреси на улици и GIS заявка за граници на районите, за да определим конгреса на конгреса (те ни предоставят огромна отстъпка - благодаря Mapbox! - но списъчната цена е около $ 2 за 1000 търсения) ,

Границите на окръжния конгрес се променят периодично: винаги за изборите след десетилетни години на преброяване (2012, 2022 г. и др. Години на изборите), а след това от време на време поради преразпределение, разпоредено от съда, когато държавите се опитват да обезценят хората. Плюс около изборите време хората наистина се объркват относно това кога тези актуализации на границите на окръга влизат в сила. Ако искате да оправите тези неща правилно, трябва да следвате внимателно тези неща и да попитате експерт (като мен).

Добре, сега имате конгресен номер на конгреса, като AK-0 (най-големият конгресен окръг на Алекса) или NY-13 (13-ият конгресен окръг на Ню Йорк). Можете да използвате споменатата по-рано база данни на законодателите на конгреса, за да потърсите кой е представителят, или техния пощенски адрес или телефонен номер.

Пощенската поща е наред, но е бавна.

Изпращането на писмо по пощата на адрес на представител или офис на сенатора (обикновено техният постоянен адрес) е добро. Това е напълно приемлив начин да се свържете с Конгреса.

Цялата пощенска поща, която отива до офисите на Капитолия в САЩ, се облъчва на място извън него, за да предпази хората от антракс или нещо подобно. Това причинява забавяне от няколко седмици за цялата пощенска поща. Това е добре, стига да нямате нищо против пощата да идва късно.

И разбира се, че трябва да платите пощенски разходи.

Не правете факс вместо това. Това е просто странно. Никой представител или сенатор всъщност вече няма факс машина. Техните факс номера са виртуални факс машини, които просто им изпращат по имейл сканиране на това, което е изпратено по факс. Това е странно. Не правете това. Нека да продължат от технологията от 90-те години.

Какво ще кажете за имейла?

Представителите и сенаторите нямат имейл адреси, поне не такива, които дават на избирателите.

Ами уебформите?

Те вместо това имат контактна форма на своя уебсайт. Използването на формата за контакт на уебсайта е добър метод за връзка с тях. Тя е не по-малко ефективна от пощенското писмо. Може да е по-ефективно, защото влиза директно в системата, която представителят или сенаторът използва, за да сортира и преброява пощата си. Искате да ви се броят, така че това е, което искате.

Но ако искате да създадете приложение, което всъщност изпраща писмото, така че съставът не трябва да попълва сам формуляра, автоматизирането на това е трудно. Не се опитвайте Поддържането на автоматизирана система, която надеждно попълва тези уеб форми, отнема много време. Направете математиката. Ако има 541 представители и сенатори и всеки обновява уеб формата си веднъж годишно, това е повече от един променен формуляр всеки ден, с който трябва да се справите.

Има проект на общността, който се опитва да реши това:

и е в основата на https://democracy.io/, но аз не знам как да използвам тези данни или дали са надеждни.

(Има и други неразрешими проблеми, освен че няма да вляза тук.)

Можете вместо това и само за представители да кандидатствате да изпращате съставни писма по електронен път чрез новия API на Камарата на представителите:

Още по-добре е просто да платите на компания като VoterVoice (те използват данни на GovTrack) или POPVOX (вижте по-рано отказ от отговорност), за да направят това вместо вас. Ще бъде много по-евтино, ако просто платите на някого да изпрати съобщенията, отколкото ако сами изградите нова система.

Ако пишете писмо, предлагайте шаблон.

Ако помагате на потребителя да напише писмо, предлагайте шаблон и полезни съвети. Дайте им най-добрият ефект, за да бъдат ефективни и да не губят времето си:

а) Бъдете много ясни какво искате да направи членът на Конгреса, т.е. как да гласувате на законопроекта (дайте номер и заглавие на законопроекта), дали да приемете законопроекта и т.н. Уверете се, че искате нещо от члена на Конгреса на Конгреса всъщност може.

б) Накарайте потребителя да напише кратко лично съобщение - най-добре е кратка лична история. Да се ​​покаже, че потребителят действително е засегнат от проблема, за който го карате да пише, е важно и разграничава писмата от другите без лични истории.

в) Бъдете уважителни. Не искайте. Не отправяйте заплахи да не гласувате за тях (това е празна заплаха!). И със сигурност не говорете за това да правите или да не давате своя принос в кампанията - това може да е незаконно (това е потенциално подкуп!). Не забравяйте, че по същество е недоплатен стажант, който чете пощата, а вашата работа е да накарате стажанта да иска да ви помогне - да не иска да ви пренебрегва.

Телефонните разговори също работят, но бъдете още по-уважителни.

Накрая е телефонното обаждане.

Телефонното обаждане е добре. Но. Моля, бъдете още по-отговорни за това, защото вие ще накарате вашите потребители да говорят с действително човешко същество от другата страна, което заслужава уважение толкова, колкото всеки. Използвате и ценното време на офиса, така че, моля, имайте предвид, че не сте единственият човек, чиито нужди са важни - службата има и други сътрудници, които също могат да ви помогнат.

Така че, очевидно кампанията за телефонни обаждания ще бъде по-ефективна от кампанията за писане на писма. Викането по-силно е по-ефективно. Не мислете, че става въпрос за технология или за намиране на секретен застъпнически метод. Просто викате по-силно, когато използвате телефона, ескалирайки състезанието за застъпнически оръжия за това, че сте гласни.

[Това вече не е вярно от началото на 2017 г.] В GovTrack използвам Twilio. Предоставям на потребителя скрипт, който да прочете при телефонното обаждане. Те въвеждат телефонния си номер и GovTrack ги повиква и - чрез Twilio - свързва повикването им с офиса на техния представител. Базата данни на законодателите на конгреса, свързана по-горе, има телефонните номера, от които се нуждаете.

Можете да видите моя изходен код за него:

Използването на Twilio като това има две предимства:

а) По-лесно е да се обадите на потребителя, отколкото да го накарате да се обади на негов представител.

б) Записвам обажданията (с разрешение на потребителя) и ги слушам, за да разбера дали тези телефонни разговори имат смисъл. Това е ценна информация за мен, подобно на други анализи на приложения.

Подобно на пощенско писмо, телефонното обаждане има транзакционни разходи, но при цената на Twilio е около 10 пъти по-евтино от пощенските разходи.

Трябва да докладвате вашите номера и да уважавате институцията.

Твърде лесно е да се каже, че сте имали милион потребители да пишат или да се обаждат на Конгреса, но ако не доставяте съобщения бързо и ефективно, тогава сте продали змийско масло - това застрашава самата институция на петицията на правителството. Това са истински неща. Ние имаме огромни етични отговорности, когато създаваме подобни инструменти.

Знам предизвикателствата, които трябва да бъдат преодолени, за да бъдат ефективни, и ще ви извикам, ако не виждам, че сте се обърнали към тях.

  1. Ако доставяте писмени съобщения до Конгреса, трябва да отчетете колко съобщения са получени успешно. Ако не го направите, ще предположа, че не доставяте всички съобщения на вашия потребител и ще ви извикам на него.
  2. Ако потребителите ви правят телефонни обаждания, трябва да съобщите колко време за персонала причинявате да бъдете поети и трябва да съобщите как сте потвърдили, че вашите потребители не тормозят персонала на конгреса. Ако не си правите труда да проверявате, ще ви извикам.

След добавянето на този инструмент към GovTrack през 2013 г., потребителите са осъществили 5 288 обаждания към Конгреса със средна продължителност на разговорите (за свързани разговори) от 85 секунди. Имаше обаждащ се от почти всеки конгресен район. Доста е готин. Както споменах по-горе, записвам обажданията и на място проверявам дали те уважават.

И това знам за писането и обаждането на вашия представител. Ще актуализирам тази публикация, както се сещам за други неща.

Работя над създаването на отворена инфраструктура около конгресните данни повече от десетилетие. Трудна работа е Едва изкарвам пари, когато отделям време за това. Ако използвате моите неща, моля, помислете как можете да допринесете за отворената екосистема на законодателни данни и / или убедете вашите финансиращи да ме финансират ... искам да кажа ... това.