Como criar e instalar a API padrão da SafetyMails em um formulário

Transforme o seu formulário de cadastro em um checador de emails

Este texto mostrará a você como instalar a API da SafetyMails e validar email em tempo real.

Esta opção permitirá a criação de um código padrão Javascript da SafetyMails que servirá para a instalação em diversos formulários e landing pages, a fim de validar email em tempo real e colaborar com a qualidade da sua geração de leads.

Se você estiver buscando como instalar uma API customizada em seu site, acesse este artigo.

Cadastrando uma origem

Para começar a instalação, acesse a sua conta da SafetyMails. Se ainda não tiver, crie uma conta agora mesmo.

Também será necessário ter uma assinatura de créditos ativa.

Para cadastrar uma origem, você precisará inserir um nome para esta Origem e o domínio que ela utilizará.

Se desejar, também poderá realizar configurações opcionais:

  • Bloquear domínios públicos (impedir cadastro de emails Gmail, Yahoo, etc)
  • Determinar o tempo de espera da digitação no campo e-mail,
  • Cadastrar mensagens personalizadas para e-mails válidos, inválidos e públicos (caso estejam bloqueados),
  • Definir status permitidos para cadastro;
  • IDs do campo e-mail e botão de submit, para instalação em em serviços de landing pages, como da RD Station.

Após isso é gerado um código JS o qual deve ser inserido em seu HTML ou sua landing page, dentro do BODY do código.

Ao selecionar “Widget Javascript”, insira as informações básicas da API, conforme as instruções abaixo:

informações básicas da criação de origem widget api javascript safetymails

Nome da origem: Este nome ajudará a identificar a sua API na SafetyMails posteriormente, em telas de consulta e relatórios.
Domínio autorizado: Define qual domínio estará autorizado a realizar conexões através da sua API.

 

configurações avançadas da criação de origem widget api javascript safetymails

Bloquear domínios públicos: Esta opção permite definir se a API impedirá o cadastro de e-mails de domínios de e-mails públicos, como Gmail, Yahoo, Hotmail, entre outros.
Tempo de espera na digitação: Tempo (em segundos) de espera entre o fim da digitação e a verificação do e-mail.
Mensagem para e-mails válidos: Mensagem que será exibida em caso de e-mail válido.
Mensagem para e-mails inválidos: Mensagem que será exibida em caso de e-mail inválido.
Mensagem para e-mails públicos: Mensagem que será exibida nos casos de e-mails de domínios públicos (só será exibida quando solicitar o bloqueio deste tipo de e-mail).
Status Permitidos: Além dos e-mails válidos, é possível permitir o cadastro de e-mails classificados com outros status.
ID campo e-mail: Caso o formulário não atenda aos critérios-padrão da SafetyMails, poderá ser necessário cadastrar o ID do campo e-mail. Nestes casos, cadastre-o aqui.
Id botão submit: Caso o formulário não atenda aos critérios-padrão da SafetyMails, poderá ser necessário cadastrar o ID do botão de envio do formulário (submit). Nestes casos, cadastre-o aqui.

 

Exemplo de código

Após cadastrar as informações, clique no botão “Salvar” e a sua nova origem será criada. Um código Javascript será liberado para utilização.

<script type="text/javascript"
src="https://panel.safetymails.com/assets/js/safetyoptin_v3.0.min.js"></script>
<script type="text/javascript">
	__safetyObj__ = {
	api_key: 'e6d796f06a51fe395a7b35421c779859ee6894fe',
	ticket_origem: '14dc0f8c86963f30dc3b498b413640a3ddd79b3e'
	};
SafetyApi.init();
</script>

Onde instalar o seu código

Após gerar o código da API será possível realizar sua instalação inserindo o código em seu HTML, no arquivo que contém o seu formulário, dentro da tag BODY do seu HTML.

This post is also available in: Español (Espanhol)

Related Articles