# Criar e incorporar um formulário de inscrição

O Pushwoosh oferece a flexibilidade de criar formulários de inscrição para diferentes cenários de cadastro, personalizar os campos que você coleta e exibir o formulário como um widget modal ou inline em seu site.

## Como criar um formulário

Para criar um novo formulário de inscrição:

1. Vá para **Audience → Subscription forms**.
2. Clique em **Create form**.

<img src="/subscription-forms-1.webp" alt="Página de formulários de inscrição com cartões de Double Opt-In e formulários de inscrição, link Como usar e botão Criar formulário"/>
3. Configure o formulário. Uma pré-visualização ao vivo aparece à direita e é atualizada conforme você altera as configurações.

### Configurar as definições gerais

Configure os seguintes campos.

> **Todos os campos nesta seção são obrigatórios.**

- **Internal form name:** usado apenas dentro do Pushwoosh, não é exibido para os assinantes. Exemplo: "Inscrição na newsletter".
- **Display type:** escolha como o formulário aparece no seu site:
  - **Modal popup:** uma sobreposição de pop-up que aparece sobre a página quando o **Trigger** que você definiu é acionado, por exemplo, **Immediately** ou após alguns segundos (consulte [Definir o tempo do pop-up modal](#set-modal-popup-timing)). Bom para inscrições em newsletters ou ofertas promocionais que você deseja que os visitantes notem.
  - **Embedded inline:** o formulário fica dentro do conteúdo da sua página (por exemplo, em uma barra lateral ou no final de um artigo). Os visitantes o veem como parte do layout da página, não como um pop-up separado.
- **Privacy policy URL:** o formulário exibe uma caixa de seleção de consentimento ("Eu concordo com a Política de Privacidade") que leva a este URL. Exemplo: `https://example.com/policy`.

<img src="/subscription-forms-2.webp" alt="Interface de criação de formulário de inscrição com Nome interno do formulário, Tipo de exibição, URL da política de privacidade e configuração de campos do formulário"/>

#### Definir o tempo do pop-up modal

Apenas para **Modal popup**:

1. Defina quando o pop-up aparece na página. No menu suspenso **Trigger**, selecione:
  - **Immediately** (padrão)
  - After 3 seconds
  - After 5 seconds
  - After 10 seconds
2. No menu suspenso **Frequency**, selecione com que frequência cada visitante vê o pop-up:
  - **Once per visitor** (padrão): uma vez por dispositivo
  - **Once per session**: uma vez por sessão do navegador
  - **Always**: toda vez que visitarem a página

<img src="/subscription-forms-3.webp" alt="Criação de formulário de inscrição com tipo de exibição Pop-up modal, menus suspensos de Gatilho e Frequência e botões de Adicionar campo"/>

### Configurar os campos do formulário

Cada formulário inclui um campo de **Email** por padrão (não pode ser removido). Você pode adicionar até mais quatro campos, para um total de cinco.

Clique em **+ First name**, **+ Last name**, **+ Phone number** ou **+ Custom field** para adicioná-los.

<Aside type="note">
Os valores desses campos integrados são salvos em tags padrão: `first_name`, `last_name` e `phone`. Campos personalizados salvam seus valores nas tags que você seleciona na configuração **Linked tag**.
</Aside>

Para cada campo, marque **Required** se o visitante precisar preenchê-lo (campos obrigatórios mostram um asterisco `*`). Use o ícone da lixeira para remover um campo.

<img src="/subscription-forms-4.webp" alt="Lista de campos do formulário com E-mail, Nome, Número de telefone, Sobrenome, Cidade e configuração de campo para o campo selecionado"/>

#### Criar um campo personalizado

1. Clique em **+ Custom field** na lista de campos.
2. Em **Linked tag**, escolha a tag do Pushwoosh que armazenará o valor enviado deste campo (por exemplo, `birthday`). Você precisa criar a tag com antecedência.
3. Defina o **Field label**: o texto que os visitantes veem ao lado da entrada (por exemplo, `Data de nascimento`).
4. Opcionalmente, defina o **Placeholder (optional)**: texto de dica dentro do campo vazio (por exemplo, `MM/DD/YYYY`).
5. Ative ou desative **Required**.

<img src="/subscription-forms-7.webp" alt="Configuração de campo personalizado com Tag vinculada, Rótulo do campo, Placeholder e caixa de seleção Obrigatório"/>

### Personalizar os rótulos do formulário

Por padrão, todo o texto do formulário está em inglês. Para traduzir o formulário para outro idioma ou alterar qualquer texto, clique em **Customize labels** abaixo da pré-visualização ao vivo.

<img src="/subscription-forms-16.webp" alt="Caixa de diálogo Personalizar rótulos do formulário com os campos Título, Botão, Texto da Política de Privacidade, Texto do Link da Política de Privacidade, Mensagem de Sucesso, Mensagem de Double Opt In, Rótulo do E-mail e Placeholder do E-mail"/>

Na caixa de diálogo **Customize form labels**, você pode editar:

- **Heading**
- **Button**
- **Privacy Policy Text**
- **Privacy Policy Link Text**
- **Success Message**
- **Double Opt In Message** (aplica-se apenas se o double opt-in estiver ativado)
- **Label** e **Placeholder** opcional para cada campo do formulário

Clique em **Save** para aplicar suas alterações. Elas aparecem imediatamente na pré-visualização ao vivo. O formulário publicado é atualizado depois que você salva ou publica o formulário de inscrição.

### Pré-visualizar e salvar o formulário

Uma pré-visualização ao vivo aparece no lado direito da interface de criação de formulário de inscrição e é atualizada conforme você altera as configurações. Use **Reset preview** abaixo da pré-visualização para restaurar o estado padrão da pré-visualização.

<Aside type="note">
Envios de teste da **Preview** não criam assinantes em seu projeto.
</Aside>

<img src="/subscription-forms-5.webp" alt="Criação de formulário de inscrição com pré-visualização ao vivo à direita, Redefinir pré-visualização e botão Criar no canto superior direito"/>

Quando terminar de configurar o formulário, clique em **Create** no canto superior direito.

### Copiar o código de incorporação e adicioná-lo ao seu site

<Aside type="caution" icon="setting" title="Assistência do desenvolvedor necessária">
Você precisará da ajuda da sua equipe de desenvolvimento para adicionar o código de incorporação ao seu site.
</Aside>

Uma caixa de diálogo é aberta com o código de incorporação para o seu formulário. Clique em **Copy code** para copiar o trecho para a área de transferência.

<img src="/subscription-forms-11.webp" alt="Caixa de diálogo de código de formulário modal com trecho de script, instrução para colar antes da tag de fechamento do body e botão Copiar código"/>

#### Onde colar o código de incorporação no seu site

Adicione o script ao HTML da página onde ele deve ser executado.

- Para **Modal popup**, colocar o script antes da tag de fechamento `</body>` é a abordagem usual.

- Para **Embedded inline**, coloque o trecho no local exato em sua marcação onde você deseja que o bloco do formulário apareça.

<Aside type="tip" title="Personalize o widget com CSS">
Você pode substituir o estilo padrão (cores, tipografia, espaçamento e o modal) em seu site definindo propriedades personalizadas de CSS no elemento `pushwoosh-subscribe-widget`. [Saiba mais](/pt/product/audience-data-and-segmentation/subscription-forms/customize-widget/).
</Aside>

### Como os diferentes tipos de exibição aparecem no seu site

Estes exemplos mostram como cada tipo de formulário pode aparecer em uma página ativa. Os rótulos dos campos e os marcadores de obrigatoriedade correspondem ao que você configura no construtor de formulários.

<Tabs>
<TabItem label="Pop-up modal">

<img src="/subscription-forms-14.webp" alt="Sobreposição de inscrição de newsletter modal em uma página da web com campos de e-mail, nome, telefone, caixa de seleção de política de privacidade e botão Inscrever-se"/>

</TabItem>
<TabItem label="Incorporado inline">

<img src="/subscription-forms-15.webp" alt="Formulário de inscrição de newsletter inline no corpo da página com campos de e-mail, nome, telefone, caixa de seleção de privacidade e botão Inscrever-se"/>

</TabItem>
</Tabs>

## Próximos passos

- [Ativar double opt-in](/pt/product/audience-data-and-segmentation/subscription-forms/double-opt-in/) para exigir confirmação por e-mail antes que os assinantes sejam adicionados
- [Personalizar o widget do formulário de inscrição](/pt/product/audience-data-and-segmentation/subscription-forms/customize-widget/) para combinar o formulário com o seu site
- [Analisar o desempenho do formulário e exportar assinantes](/pt/product/audience-data-and-segmentation/subscription-forms/form-analytics-and-export/) para acompanhar os resultados e baixar os dados dos assinantes