Instalar formulários no seu site

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 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 Marketing›Forms, selecione Install. O snippet também está na página de cada formulário, no card Installation. 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 connect-src.

Como os formulários sobrepostos aparecem

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 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

Chame emailit("show", token) para abrir um pop-up, slide-in, formulário de página inteira ou banner quando você quiser, por exemplo a partir de um botão:

<button type="button" onclick="emailit('show', 'FORM_TOKEN')">
  Join the newsletter
</button>

• O formulário abre na hora, mesmo que o visitante já o tenha fechado ou enviado.
• O formulário precisa estar publicado, e o script precisa estar na página.
• As chamadas feitas enquanto o script ainda está carregando entram em uma fila e são executadas quando ele estiver pronto.
• Para um formulário incorporado, show procura de novo os placeholders dele na página.

openForm funciona como alias de show.

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 e as chamadas emailit("show", ...) o usam. Para gerar um novo, chame Redefinir o token público:

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 e o seu código 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.

As respostas ainda não são adicionadas aos seus contatos nem às suas listas. Consulte Respostas.

Solução de problemas

Veja também