Guides · Representatives & sending
Using Voci

Representatives & sending

How Voci works out who covers your address, how to add local officials, and what a sent letter looks like.

Giving your address

Voci does not ask for your address when you sign up. It asks the first time a step actually needs to be aimed at someone — you will see Who's your rep? in the step editor, or Update address from the representatives panel on your dashboard.

A full street address gives the most precise match, but ZIP and city is usually enough. Press Find my reps and Voci resolves it to the people who represent that location. It is saved once and reused across every issue.

What the lookup covers

The automatic lookup finds your federal and state legislators — your members of Congress, your senators, and your state legislature representatives — with their office, party, district, and whatever public contact details are on file. They show on the dashboard under Congress and State.

It does not automatically cover city councils, school boards, mayors, county commissions, or the hundreds of other local bodies. There is no single database of those, and they are exactly the ones that matter most for local issues — so Voci gives you two other ways to get them.

Local officials

Add a contact — in the step editor, or under Local on the dashboard — lets you enter one yourself. Name, role, and an email if you want to send to them; phone and notes are optional.

Contacts are saved to your account and reused on future issues, so this is a one-time cost per official. Their email is usually on your city or district website, on the page for the council, board, or office.

The local-official finder

Find local officials does the searching for you. Voci searches the web for the officials covering your saved address, and comes back with a list you can pick from — tick the ones you want and Save selected adds them to your contacts.

It can take up to 30 seconds, and it is capped at five runs a day.

If it comes back empty, add the contact manually — small jurisdictions often have nothing machine-readable published at all.

How a step finds its target

Each step carries a target — sometimes a named office, more often a role like “Your city council member” or “Your U.S. Senator”. Voci matches that against what it knows about you:

  • For a federal or state target, it picks from the legislators resolved from your address.
  • For a local target, it looks through your saved contacts for the closest office match — a step aimed at the school board finds your school board contact rather than your senator.
  • When nothing matches, the editor asks you to add the missing contact rather than guessing.

Whoever is matched shows on the step under Addressed to, with their office website and phone where those are known. If an office has no public email on file, Voci says so and points you at the website or the phone number instead.

Sending a letter

With a draft written and a target matched, Send via email delivers it. Voci handles the delivery, and sets the reply address to your own email, so when the office writes back it comes to you, not to Voci.

Before it goes
You need a draft and a target with an email. Voci will tell you which is missing.
After it goes
The step records who it went to and when. Send again is available for follow-ups.
Limits
Ten letters a day across your account, and three sends per individual step — enough to follow up, not enough to flood an office.
Replies
Go straight to your email address. Voci does not read them, and does not know whether you got one — that is what outcome logging is for.

What the office receives

A plain email. No Voci logo, no colours, no buttons, no branding of any kind — just your letter, typeset for reading.

Offices that receive Voci letters and want to know what they are looking at can read the page written for them: what Voci is, that a human wrote, edited and approved every letter, and how the platform prevents mass-generated identical mail.

Not ready to send through Voci? Copy and Open in email are always there — the step editor covers both.

Something here wrong or missing? Tell us.