1What FoxPlug reads from Typeform
These are the exact things it reads, and nothing else.
| What | The details it takes |
|---|---|
| Your personal access token | pasted by you. It is sent to Typeform as a bearer token. Without it the read stops with an error |
| Your most recently changed forms (name only) | the newest 8 of the first 20 forms Typeform lists, ordered by when they were last updated. Only the form id and its name are used |
| Each form's questions and their answer choices | one read per form, to learn the question wording and the list of choices you offered. Only multiple choice, picture choice, yes or no and dropdown questions are kept; questions inside a group are found too |
| Responses from the last 30 days, counted | the response count Typeform reports for the last 30 days, per form, and for each choice question how many people picked each choice. Only the first 1000 responses of a form are looked at for the choice counts |
| What comes back from the read | up to 20 'form name: question: choice' lines with a count each, plus up to 10 'form name: responses in the last 30 days' lines. Each count is a request with that many votes |
2Moments it finds, and what each becomes
A moment is one thing that happened in Typeform worth a second look. Each one is scored, then it becomes a post, a changelog entry, a thing to fix or an idea to email, or it is skipped.
A choice on one of your forms was picked by at least 3 people in the last 30 days and its words match something you shipped in the last 30 days
The moment is titled like this: Looks like you shipped what 5 people asked for: Dark mode
Your 'What should we build next?' poll got 5 votes for 'Dark mode' this month, and one of your updates is 'Shipped dark mode for the dashboard'. FoxPlug writes 'Looks like you shipped what 5 people asked for' and says it counted 5 votes in 30 days. At most 3 such moments come out of one read.
3How the brain uses it
The rules below are the ones that apply to Typeform. The same rules, with worked examples, are on the brain page.
- Typeform is read for counts only: responses per form over 30 days and how many people picked each choice of a choice question. Each 'form: question: choice' line becomes a request with that many votes. How the brain decides
- A choice only counts when its words match what you offered in the form. A typed 'Other' answer is counted as 'Other' without its text. How the brain decides
- Choice lines with at least 3 votes whose words match something you shipped in the last 30 days become a 'looks like you shipped it' say line. Matching is by words and you should check it before you post. The per-form response counts are never matched. How the brain decides
- FoxPlug keeps wording and counts, not who answered, so it cannot write to the people who voted. How the brain decides
4Set up Typeform in a few steps
Access: a personal access token with the forms:read and responses:read scopes, pasted by you. What to give it: personal access token with forms:read and responses:read (FoxPlug only reads).
- In Typeform, open the drop-down next to your username in the top left, then Account, then Personal tokens.
- Click Generate a new token, name it FoxPlug and choose only the forms:read and responses:read scopes.
- Copy the token and paste it into FoxPlug.
- Press Check for what's new.
5Limits worth knowing
Where it stops, so nothing surprises you.
- Reads at most 8 forms, the most recently changed first.
- Only the first 1000 responses of a form from the last 30 days feed the choice counts; the response count itself is Typeform's own total.
- Only multiple choice, picture choice, yes or no and dropdown questions are counted; rating, scale, ranking and text questions are skipped.
- Typeform allows two requests per second per account, so the reads are spaced about half a second apart, and a read of 8 forms takes several seconds.
- Typeform's reference says very recent responses, about the last 30 minutes, may not be returned.
- Accounts whose responses are stored in Typeform's EU data center use a different address. FoxPlug only calls the standard address, so such an account may be refused.
- NOT confirmed by the Typeform pages that were read: the exact layout of a form's questions and choices (the question title and choice label names come from the reader code and Typeform's create-form page, not from a retrieve-form example), the largest page size the responses call accepts, and whether the token is shown only once.
- A personal access token can be limited to chosen scopes, and the setup asks for the two read scopes only.
6What it never reads
Read only means read only, and the list below is what the code leaves alone.
- Typed answers: short text, long text and any other free-text question
- Email addresses, names, phone numbers and hidden fields on a response
- Anything that writes to Typeform: it creates no form, changes no form and deletes no response
7How Typeform differs from the tools next to it
Canny and Featurebase give feature requests with votes and a status. Typeform gives counts from your own polls: a choice picked by N people becomes a request with N votes, and there is no completed state, so it can only give 'Looks like you shipped it' moments. Tally does the same from Tally forms. Intercom, Help Scout, Zendesk and Crisp count labels on conversations instead of poll choices.
8Questions
Does FoxPlug read what my respondents typed?
No. It reads the list of choices you offered and counts how many people picked each one. Typed answers, email addresses, names and hidden fields are not read or kept.
Which questions are counted?
Multiple choice, picture choice, yes or no and dropdown questions. Rating, scale, ranking and text questions are skipped.
When does it read Typeform?
Only when you press Check for what's new. Nothing is fetched on a timer for your project.
Has the Typeform connection been tested against a real account?
No. It is marked code-path-only: the code path exists and its offline checks pass, but no real Typeform account of ours has exercised it. Treat the first read as the test.
FoxPlug reads this tool only when you press Check for what's new, and only to read. Plans and limits are on the pricing page. Questions: support.