> ## Documentation Index
> Fetch the complete documentation index at: https://agile-docs.3code.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Questionários Dinâmicos

> Crie formulários personalizados para coletar informações dentro do sistema ou por link público.

## Visão geral

Os **Questionários Dinâmicos** permitem montar formulários sob medida — com seções e campos de vários tipos — para coletar informações **embutidas em telas do sistema** (por exemplo, no detalhe de um ticket) ou por meio de um **link público**.

<img className="block dark:hidden rounded-lg" src="https://mintcdn.com/3code/4DBlrWRYlQnGmyX1/public/images/ticket/questionnaires-dark.png?fit=max&auto=format&n=4DBlrWRYlQnGmyX1&q=85&s=ab21db7bb872b362e3f450b4f448488c" alt="Lista de questionários dinâmicos - tema claro" width="1920" height="1080" data-path="public/images/ticket/questionnaires-dark.png" />

<img className="hidden dark:block rounded-lg" src="https://mintcdn.com/3code/4DBlrWRYlQnGmyX1/public/images/ticket/questionnaires-light.png?fit=max&auto=format&n=4DBlrWRYlQnGmyX1&q=85&s=6c3aeee3d7a7499214bb14fc28e17dc0" alt="Lista de questionários dinâmicos - tema escuro" width="1920" height="1080" data-path="public/images/ticket/questionnaires-light.png" />

A lista mostra **status**, **módulo**, **nome**, **ID** (copiável), **modelo de uso**, **tipo de acesso**, o **link** do formulário e quem criou. O botão **Respostas** leva ao histórico de respostas recebidas.

***

## Como criar um questionário

<Steps>
  <Step title="Dados básicos">
    Clique em **[Criar Novo](/general/create)** e preencha:

    <Card title="Campos">
      * **Ativo?** e **Editável após respondido?** (switches).
      * **Nome** e **Descrição**.
      * **Empresas** (opcional).
      * **Exibição das seções**: Todas de uma vez · Em etapas (uma por vez) · Accordion.
      * **Modelo de uso**: **Embedado** (em telas do sistema) ou **Formulário público** (link fixo).
      * **Tipo de acesso** (para formulário público): **Público** (qualquer pessoa) ou **Autenticado** (precisa de conta no Agile).
    </Card>
  </Step>

  <Step title="Configurações do formulário">
    Na aba **Configurações do formulário**, monte as **seções** e adicione **campos** (perguntas) em cada uma. É possível **reordenar** por arrastar e soltar, marcar campos como **obrigatórios**, definir **placeholder**, número de colunas e **condições de visibilidade** (campos condicionais).
  </Step>

  <Step title="Publicar e coletar">
    Salve. Se for **público**, um link é gerado para compartilhar. Acompanhe as respostas na aba **Respostas** (filtrável por período).
  </Step>
</Steps>

***

## Tipos de campo

Texto · Texto longo · Numérico · Valor monetário · Data · Upload de arquivo · E-mail · Senha · CPF · CNPJ · Telefone · CEP · Seleção única · Seleção múltipla · Caixa de seleção · Botão de opção · Escala NPS · Avaliação (estrelas) · Verdadeiro ou falso.

***

## Conceitos

<Card title="Modelo de uso">
  **Embedado** aparece dentro de telas do sistema; **Formulário público** é acessado por um link fixo.
</Card>

<Card title="Tipo de acesso">
  **Público**: qualquer pessoa responde pelo link. **Autenticado**: o respondente precisa estar logado no Agile.
</Card>

<Card title="Campos condicionais">
  Um campo pode aparecer apenas quando outra resposta atende a uma condição, deixando o formulário mais enxuto.
</Card>