Referência dos tipos de pergunta do trulyform

O que você precisa saber

Escolha o tipo que combina com a resposta de que você precisa. A visão geral abaixo mostra para que serve cada um.
Copie o modelo do tipo, dê um título a ele e troque os IDs por IDs novos, únicos no formulário.
Tipos com opções precisam de pelo menos duas opções com rótulo. A matriz também precisa de pelo menos uma linha com rótulo.
Todos os tipos aceitam as configurações comuns nextButton e imageAlt, além das próprias. Uma configuração que o tipo não usa é ignorada, então nem envie.
Envie configurações de número inteiro, como maxLength, como números JSON, não como strings.
list_field_types retorna as mesmas informações e, se você passar id_count, também IDs novos.

Visão geral

A referência técnica a seguir é gerada a partir do código e está em inglês, como os assistentes de IA a leem. Os nomes dos tipos, das configurações e dos operadores são os mesmos que você usa na definição.

Tipo	Para que serve
`short_text`	One line of free text, such as a name or a company.
`long_text`	A multi-line answer, such as feedback or a description.
`email`	An email address, checked for a valid format.
`phone`	A phone number in any common format.
`number`	A number, such as a quantity, an age or a budget.
`date`	A calendar date, such as an event or a birthday.
`single_choice`	Pick one of a few visible choices.
`dropdown`	Pick one choice from a long list, such as a country.
`multiple_choice`	Pick any number of choices.
`consent`	A single checkbox, such as agreeing to terms.
`nps`	Net Promoter Score: how likely someone is to recommend you, from 0 to 10.
`opinion_scale`	A rating on a short numbered scale, such as 1 to 5.
`ranking`	Put every choice in order of preference.
`matrix`	Rate several rows on the same set of columns. Options are the columns.
`file_upload`	Attach one or more files, such as a CV or a photo.
`statement`	Show text between questions. Collects no answer.
`website`	A website address.

Configurações

As configurações ficam no objeto settings de cada pergunta.

nextButton: string of up to 100 characters, default "Next". Used by every type. Label of the button that moves on. Blank or left out shows the default, and statements default to "Continue". There is no separate submit button: the last question's button sends the form, so label it "Submit" or similar.
imageAlt: string of up to 1,000 characters. Used by every type. Alt text for an image set on this question. Only used when media.inherit is false.
placeholder: string of up to 1,000 characters. Used by short_text, long_text, email, phone, number, dropdown, website. Hint shown in the empty answer field. Leave it out for the default hint; an empty string shows none.
maxLength: integer from 1 to 10,000, default 10000. Used by short_text, long_text. Most characters an answer may have.
min: number. Used by number, opinion_scale. Lowest accepted answer. Number questions: a decimal string such as "0" or "9.5" (a JSON number works too). Opinion scale: a whole number, default 1.
max: number. Used by number, opinion_scale. Highest accepted answer. Number questions: a decimal string such as "100" (a JSON number works too). Opinion scale: a whole number, default 5, at most 10 above min.
lowLabel: string of up to 255 characters, default "Not likely". Used by nps, opinion_scale. Caption under the lowest score.
highLabel: string of up to 255 characters, default "Very likely". Used by nps, opinion_scale. Caption under the highest score.
comment: true or false, default false. Used by nps, opinion_scale. Adds an optional comment box under the scale. The answer becomes {score, comment}.
label: string of up to 2,000 characters, default "I agree". Used by consent. Text beside the checkbox.
maxFiles: integer from 1 to 10, default 1. Used by file_upload. Most files per answer. The owner's plan can lower it.
maxSizeMB: integer from 1 to 10,000. Used by file_upload. Largest file in MB. Leave it out to use the account limit, which also caps any value set here.
accept: string of up to 255 characters, default ".pdf,.jpg,.jpeg,.png,.webp,.txt,.csv,.docx". Used by file_upload. Comma-separated file extensions respondents may upload.

Allowed accept extensions: pdf, jpg, jpeg, png, webp, txt, csv, doc, docx, xls, xlsx.

Tipos

`short_text`

Short text. One line of free text, such as a name or a company.

Answer: Text up to maxLength characters.
Choices: Not used. Keep options and rows empty.
Settings: placeholder, maxLength, plus the common nextButton and imageAlt.
Logic operators: eq, neq, has_value, is_empty, contains, not_contains. Compare with a string, such as "yes".
Calculations: Not usable.

Short text question

{
    "id": "01990000-0000-7000-8000-000000000001",
    "kind": "short_text",
    "title": {"type":"doc","content":[{"type":"paragraph","content":[{"type":"text","text":"What is your name?"}]}]},
    "description": {"type":"doc","content":[{"type":"paragraph","content":[]}]},
    "required": false,
    "options": [],
    "rows": [],
    "settings": {"nextButton":"Next"},
    "media": {"inherit":true,"assetId":null,"layout":"above"}
}