Pular para o conteúdo
Docs

Guia prático

Instalar formulários no seu site

Adicione o script do Emailit ao seu site uma única vez, posicione formulários incorporados, abra formulários a partir do seu próprio código e gerencie os tokens, a publicação e as respostas dos formulários.

Atualizado em 26 de out. de 2026

Uma única tag de script mostra todos os formulários publicados do seu workspace no seu site. Esta página explica onde colocá-la, como posicionar formulários incorporados, como abrir um formulário a partir do seu próprio código, como compartilhar um formulário como uma página hospedada e como confirmar que as respostas estão chegando.

Antes de começar

  • Crie e publique pelo menos um formulário. Apenas os formulários publicados aparecem no seu site. Consulte Criar um formulário.
  • Você precisa poder editar o HTML do seu site ou adicionar uma tag HTML personalizada no seu gerenciador de tags.

Adicionar o script

  1. Copie o snippet. Em Email MarketingForms, selecione Install. O snippet também está na página de cada formulário, no card Installation & sharing. Ele tem esta aparência, com a chave pública do seu workspace no caminho:

    HTML
    <script async src="https://js.emailit.com/js/<WORKSPACE_PUBLIC_KEY>/emailit.js"></script>
  2. Adicione-o a todas as páginas. Cole-o uma vez no layout ou template compartilhado do seu site, de preferência logo antes da tag de fechamento </body>. É o mesmo snippet para todos os formulários do workspace, então você só o instala uma vez.

  3. Publique os seus formulários. Os pop-ups, slide-ins, formulários de página inteira e banners publicados passam a aparecer no seu site sem mais código.

O script carrega de forma assíncrona e não bloqueia a sua página. Se algo falhar, como um erro de rede, ele não mostra nada e a sua página continua funcionando. Ele também funciona quando adicionado por um gerenciador de tags.

Se o seu site usa uma Content Security Policy, permita https://js.emailit.com em script-src e https://api.emailit.com em connect-src.

Como os formulários sobrepostos aparecem

Tipo Quando aparece
Banner Assim que a página carrega. Todos os banners publicados são exibidos.
Popup, Flyout, Full page 2,5 segundos depois que a página carrega. Apenas um deles aparece por carregamento de página.

Para alterar o atraso, defina display_delay_seconds nas settings do formulário com Atualizar um formulário.

Depois que um visitante fecha um formulário, ele fica oculto nesse navegador por 7 dias. Depois que o visitante o envia, ele fica oculto por um ano. O Emailit guarda essa informação no armazenamento local do navegador, na chave emailit_forms_v1, e não define cookies. Se o armazenamento local não estiver disponível, os formulários aparecem a cada carregamento de página.

Incorporar um formulário na sua página

Os formulários incorporados são exibidos dentro do seu conteúdo, por exemplo em um rodapé ou na barra lateral de um blog. Além do script, eles precisam de um elemento placeholder:

  1. Copie o placeholder. Abra a página do formulário incorporado. O card Installation & sharing mostra o placeholder com o token público do formulário:

    HTML
    <div data-emailit-form="FORM_TOKEN"></div>
  2. Posicione-o. Cole o placeholder onde o formulário deve aparecer. Você pode usar o mesmo formulário em vários lugares.

  3. Confira o script. Verifique se o script também está na página.

O script preenche todos os placeholders data-emailit-form cujo token corresponde a um formulário incorporado publicado. Ele também observa a página, então os placeholders adicionados depois, por exemplo por uma single-page app, são preenchidos quando aparecem. Os formulários incorporados aparecem sempre, tenha o visitante enviado o formulário antes ou não.

Abrir um formulário a partir do seu código

Adicione a qualquer botão ou link o atributo data-emailit-open com o token público do formulário. Um clique abre o formulário:

HTML
<button type="button" data-emailit-open="FORM_TOKEN">
  Join the newsletter
</button>

No seu próprio JavaScript, chame emailit("show", token) para abrir um formulário e emailit("close", token) para fechá-lo. Mantenha a primeira linha. O script carrega de forma assíncrona, e essa linha coloca suas chamadas em uma fila até ele estar pronto. Sem ela, uma chamada executada antes de o script carregar falha com emailit is not defined.

JavaScript
window.emailit=window.emailit||function(){(window._emailitq=window._emailitq||[]).push(arguments)};

emailit("show", "FORM_TOKEN");  // open the form
emailit("close", "FORM_TOKEN"); // close it
  • O formulário abre na hora, mesmo que o visitante já o tenha fechado ou enviado. A segmentação e os limites de frequência não se aplicam.
  • O formulário precisa estar publicado, e o script precisa estar na página.
  • Um formulário incorporado abre como pop-up. Se a página tiver o placeholder dele, a página rola até ele.
  • emailit("close") sem token fecha todos os pop-ups, slide-ins, formulários de página inteira e banners abertos.
  • Um link para uma página do seu site que termine em #emailit-FORM_TOKEN também abre o formulário.

openForm funciona como alias de show.

Compartilhar uma página hospedada

Uma página hospedada mostra um formulário em uma página própria, em https://forms.emailit.com/<public token>, para que as pessoas possam se inscrever sem visitar o seu site: pela bio de uma rede social, por um e-mail, por um anúncio ou por um QR code impresso. As páginas hospedadas estão incluídas nos planos Pay as you goProBusinessCustom.

  1. Publique o formulário. A página hospedada mostra a versão publicada do formulário, assim como o seu site.

  2. Abra o link. Na página do formulário, abra a aba Link & QR code do card Installation & sharing. Copie o link, selecione Open hosted page para testá-lo ou selecione Download QR para baixar o QR code em SVG. O menu Actions do formulário também tem Open hosted page.

A página mostra só o formulário, centralizado, sem botão de fechar e sem regras de exibição: a segmentação, os gatilhos e os limites de frequência valem apenas no seu site. As respostas funcionam da mesma forma que no seu site. No editor, o mesmo link fica em Share & preview, na aba Settings.

O link usa o token público do formulário, então redefinir o token dá um novo endereço à página, e o link antigo para de funcionar. Quando o formulário é despublicado, ou quando o workspace passa para o Pay as you go, a página mostra “Este formulário não está disponível no momento.” no idioma do visitante, em vez do formulário.

Gerenciar um formulário publicado

Atualizar ou despublicar

As alterações salvas em um formulário publicado, ou a despublicação dele, chegam ao seu site em cerca de um minuto. Para tirar um formulário do seu site, abra a página dele e selecione Unpublish. Ele volta para rascunho e você pode publicá-lo de novo depois.

Redefinir o token público

Cada formulário tem um token público, exibido como Public token na página dele. Os placeholders de incorporação, as chamadas emailit("show", ...) e o link da página hospedada o usam. Para gerar um novo, chame Redefinir o token público:

Terminal
curl https://api.emailit.com/v2/forms/frm_8Lq2Wx5nVb3Tk/reset-token \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

O token antigo para de funcionar imediatamente, então atualize os seus placeholders, o seu código e os links compartilhados com o novo token da resposta. Os formulários sobrepostos que aparecem automaticamente não são afetados.

Conferir as respostas

Envie o formulário no seu site com os seus próprios dados e abra a página do formulário no painel. Recent submissions lista cada resposta com o horário em Created e o Payload: os valores enviados, indexados pelo nome de propriedade de cada campo. Filtre a lista pela data de criação.

Junto com os valores, o Emailit guarda com cada resposta a URL da página, o referenciador, o endereço IP do visitante e o user agent do navegador dele. Mencione isso no seu aviso de privacidade.

Uma resposta com um endereço de e-mail também cria ou atualiza o contato e o adiciona às listas do formulário. Consulte Respostas.

Solução de problemas

O formulário não aparece

Verifique se o formulário está Live e se o script está na página, com a chave do seu workspace na URL. Se você já fechou ou enviou o formulário, ele fica oculto no seu navegador: abra a página em uma janela anônima ou remova a entrada emailit_forms_v1 do armazenamento local. Lembre-se de que apenas um pop-up, slide-in ou formulário de página inteira aparece por carregamento de página.

Um formulário incorporado não é exibido

Verifique se o tipo do formulário é Embed, se ele está publicado e se o valor data-emailit-form do placeholder corresponde ao token público atual do formulário. Se você redefiniu o token, atualize o placeholder.

Desenhe etapas, campos e estilos.
Crie, publique e gerencie formulários pelo código.

Esta página foi útil?

Obrigado pelo feedback.

Obrigado, lemos todas as mensagens.