# Formulários

> Crie no painel formulários de inscrição em pop-up, slide-in, banner, página inteira e incorporados, publique-os no seu site com uma tag de script e receba as respostas.

Os formulários são formulários de inscrição que você cria no painel do Emailit e exibe no seu site. Você monta um formulário visualmente, publica-o e adiciona uma tag de script ao seu site, e o Emailit guarda cada resposta para você.

> **Os formulários estão em acesso antecipado:** Os formulários ainda não estão disponíveis em todos os workspaces. Se **Forms** mostrar um selo **Soon** na barra lateral do painel e não puder ser aberto, o recurso não está ativado no seu workspace. [Fale com o suporte](/contact/) se quiser acesso antecipado.

## Como funciona

1. **Crie um formulário** em **Email Marketing → Forms** e escolha o tipo dele.
2. **Desenhe-o** no editor: adicione textos, imagens, botões e campos de entrada, divida-o em etapas e defina o estilo. Consulte [Criar um formulário](/pt/docs/forms/build/).
3. **Publique-o.** Apenas os formulários publicados aparecem no seu site.
4. **Instale o script** uma vez em todas as páginas do seu site. Pop-ups, slide-ins, banners e formulários de página inteira passam a aparecer sozinhos. Os formulários incorporados também precisam de um elemento placeholder no lugar em que devem ser exibidos. Consulte [Instalar formulários](/pt/docs/forms/install/).
5. **Revise as respostas** na página do formulário.

## Tipos de formulário

| Tipo | Como aparece |
| --- | --- |
| **Popup** | Uma caixa de diálogo no meio da página, sobre um fundo escurecido. Abre alguns segundos depois que a página carrega. |
| **Full page** | Cobre a página inteira. Abre alguns segundos depois que a página carrega. |
| **Flyout** | Desliza no canto inferior direito, no canto inferior esquerdo ou na parte inferior da página. Abre alguns segundos depois que a página carrega. |
| **Banner** | Uma barra no topo ou na parte inferior da página. Aparece assim que a página carrega. |
| **Embed** | É exibido dentro do conteúdo da sua página, onde quer que você coloque o placeholder dele. |

Você escolhe o tipo ao criar o formulário e pode alterá-lo depois no painel **Styles** do editor. Cada carregamento de página mostra no máximo um pop-up, slide-in ou formulário de página inteira, mais os banners e os formulários incorporados publicados.

## Status

| Status | Significado |
| --- | --- |
| **Draft** | O formulário está salvo, mas não aparece no seu site. Os formulários novos começam como rascunho. |
| **Live** | O formulário está publicado e aparece onde quer que o script esteja instalado. |

Para ser publicado, um formulário precisa de pelo menos uma etapa de formulário e uma etapa de sucesso. **Unpublish** volta um formulário publicado para rascunho e o remove do seu site.

## Respostas

Sempre que um visitante envia um formulário, o Emailit guarda a resposta com o valor de cada campo, indexado pelo nome de propriedade do campo, e com detalhes sobre a origem dela, como a URL da página e o referenciador. A página do formulário as lista em **Recent submissions**, das mais recentes para as mais antigas.

As respostas ficam guardadas apenas com o formulário. Elas ainda não criam contatos nem adicionam ninguém a uma lista de contatos, então um formulário não faz as suas listas crescerem sozinho. Para adicionar inscrições a uma lista hoje, use a [URL de inscrição](/pt/docs/audiences/subscribe-url/) de uma lista ou a [API de inscritos](/pt/docs/api-reference/audiences/subscribers/).

Excluir um formulário também exclui as respostas dele permanentemente.

## A página Forms

**Email Marketing → Forms** lista os seus formulários com **Name**, **Type**, **Status** e o horário em **Updated**, com busca.

- **Create form** pede um **Name** e um **Type** e depois abre o novo formulário.
- **Install** mostra a tag de script para o seu site.
- O menu da linha tem **Edit**, **Rename** e **Delete**.

Na página de um formulário, você encontra **Publish** ou **Unpublish**, **Edit form** para abrir o editor, um card **Details** com o número de etapas e o **Public token** do formulário, a tabela **Recent submissions** e um card **Installation** com o código deste formulário.

## Usar a API

A [API de formulários](/pt/docs/api-reference/forms/) permite [criar](/pt/docs/api-reference/forms/create/), [obter](/pt/docs/api-reference/forms/get/), [atualizar](/pt/docs/api-reference/forms/update/), [listar](/pt/docs/api-reference/forms/list/) e [excluir](/pt/docs/api-reference/forms/delete/) formulários, [publicá-los](/pt/docs/api-reference/forms/publish/) e [despublicá-los](/pt/docs/api-reference/forms/unpublish/), e [redefinir o token público](/pt/docs/api-reference/forms/reset-token/). Os formulários têm IDs `frm_`, um `type` (`popup`, `full_page`, `flyout`, `embed` ou `banner`), um `status` (`draft` ou `live`) e a `definition` completa do editor. Publicar um formulário sem uma etapa de formulário e uma etapa de sucesso retorna `422`.

As respostas estão disponíveis apenas no painel.

## Próximos passos

  - [Criar um formulário](/pt/docs/forms/build/): Use o editor para desenhar etapas, campos e estilos.
  - [Instalar formulários](/pt/docs/forms/install/): Adicione o script ao seu site e posicione os formulários incorporados.

---
Fonte: https://emailit.com/pt/docs/forms/