Como usar a API da SafetyMails

O que esta integração faz?

A API da SafetyMails permite criar um código para instalação em suas Landing Pages no RD Station, evitando a entrada de email inválidos de leads em sua Base.

Ativando esta funcionalidade, a SafetyMails gerará um código pronto para instalação em suas Landing Pages.

Requisitos e obsevações

• Ser cliente de qualquer plano do RD Station Marketing;
• Ter uma assinatura de créditos ativada na SafetyMails. Caso não possua uma conta, clique aqui para criá-la;

Passo a passo para a instalação

• Cadastrando uma origem
• Configurações avançadas
• No painel do RD Station

Cadastrando uma origem

1. Acesse a sua conta na SafetyMails;
2. Clique na aba API para Formulários e selecione a opção Cadastrar nova origem;
   
3. Em seguida, procure pela logo da RD Station entre as instalações e clique sobre ela:
   
4. Ao selecionar RD Station, insira as informações básicas da API, conforme as instruções abaixo:
   
   
   • Domínio autorizado: 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.
5. Algumas integrações exigem a inclusão de mais duas informações importantes: o ID do campo email e o ID do botão de envio do formulário (submit):
   • ID campo e-mail: cadastre aqui o ID do campo e-mail;
   • Id botão submit: cadastre o ID do botão de envio do formulário (submit).

Configurações avançadas

1. A API tem funcionamento padrão. Entretanto, se desejar realizar alguma personalização para a sua API, preencha os seguintes campos:
   • Executar após o término da digitação: 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;
   • Status Permitidos: além dos e-mails válidos, é possível permitir o cadastro de e-mails classificados com outros status.
2. Também é possível uma mensagem para emails válidos:
   
   
   • 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);
   • 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.

Exemplo de código

Após cadastrar as informações, clique no botão Salvar e a sua nova origem será cadastrada.

Um código Javascript será liberado para utilização no seu formulário na RD Station Marketing, como o exemplo abaixo:

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

No painel da RD Station Marketing

Para inserir o código na Landing Page do RD Station:

1. Acesse o menu Converter > Landing Pages;
2. Clique na opção de edição da Landing Page em que deseja inserir o código de validação;
   • Para obter o ID botão submit de suas Landing Pages: em seu painel RD Station Marketing, acesse o menu Converter > Landing Pages e clique para editar uma Landing Page. Em seguida, clique sobre o botão de envio do formulário e, no menu que aparece à esquerda, será possível localizar a ID do botão (como na imagem). Basta copiar esta informação e colar na SafetyMails, no campo correspondente em Configurações avançadas:
     
3. Em seguida, clique em Edição Avançada e, na aba Javascript em BODY cole o código copiado da SafetyMails. Aplique as alterações e siga o restante do procedimento para salvar e publicar sua Landing Page:
4. Salve o processo e a API deverá funcionar corretamente.