> For the complete documentation index, see [llms.txt](https://docs.hominy.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hominy.com.br/guia-do-produto/formularios-publicos.md).

# Formulários públicos

Um **formulário público** é uma página acessível por link que, ao ser submetida, **cria um card** (ou um registro de base) automaticamente — sem que a pessoa precise de conta no Hominy.

São ideais para: captação de leads, abertura de chamados, recebimento de solicitações.

## Formulário de fluxo

Cada fluxo pode expor um formulário que entra na **fase inicial**:

* **Campos selecionáveis** — você escolhe quais campos da fase inicial aparecem no formulário.
* **Multi-step / wizard** — formulários em várias etapas.
* **Campos condicionais** — mostrar/esconder campos conforme respostas.
* **Branding** — logo, cor e capa personalizados (white-label).
* **Captcha** — proteção matemática + honeypot contra bots.
* **Redirect** — para onde enviar a pessoa após o envio.

O card criado pelo formulário dispara normalmente o gatilho **"Card criado"**, então você pode encadear automações (notificar, atribuir, etc.).

## Formulário de base de dados

Da mesma forma, uma [base de dados](/guia-do-produto/bases-de-dados.md) pode expor um **formulário público** que cria um **registro** na base (e não um card). Útil para cadastros alimentados externamente.

* Endpoint público dedicado, com **honeypot, throttle e validação** de campos obrigatórios.
* Configurável: título, descrição, mensagem de sucesso e campos expostos.

## Portal do cliente

Além dos formulários, há um **portal por link** (autenticado por HMAC) para o cliente acompanhar/abrir requisições, com branding básico da empresa.

## Segurança dos endpoints públicos

Os formulários ficam sob o prefixo `/api/v1/public/` e **não passam pelos guards de autenticação** — mas têm **rate limit** e proteção anti-bot próprios. Veja **Segurança**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hominy.com.br/guia-do-produto/formularios-publicos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.