Skip to content

Instantly share code, notes, and snippets.

@jamessom
Forked from pedrobachiega/index.markdown
Last active May 12, 2020 15:55
Show Gist options
  • Save jamessom/457b2b8077b389abcc9014ec80f84ea6 to your computer and use it in GitHub Desktop.
Save jamessom/457b2b8077b389abcc9014ec80f84ea6 to your computer and use it in GitHub Desktop.
Integrações RD Station - HTML puro

Integrações RD Station

HTML Puro

Para quem não tem conhecimento técnico, a integração via HTML Puro é a mais simples de integrar ao RD Station. Mas, infelizmente, ainda é preciso fazer algumas pequenas modificações no seu arquivo HTML.

Usando a API

Quatro coisas são necessárias editar/adicionar na sua página para a integração funcionar:

1. Ter um input (campo de texto) com o nome email ou email_lead:

      <input type="text" name="email" />

2. Ter um input hidden com o nome token_rdstation e valor do seu token RD Station (encontrado em https://www.rdstation.com.br/docs/api )

      <input type="hidden" name="token_rdstation" value="SEU_TOKEN_RD_STATION" />

3. Ter um input hidden com o nome identificador e valor com nome da sua página ou evento que deseje mapear nas conversões.

      <input type="hidden" name="identificador" value="pagina-contato" />

4. Fazer o formulário postar as informações para a API

      <form action="https://www.rdstation.com.br/api/1.2/conversions" method="POST">

Após isso, sua página já está integrada com o RD Station. Recomendamos que a teste e veja se os dados aparecem na ferramenta de CRM.

Direcionamento do visitante após conversão

Muitas vezes, os sites redirecionam o visitante para uma página de obrigado após a submissão de um formulário. Se assim desejar, é possível inserir um input hidden com o nome redirect_to e com o valor da URL da página que se queira enviar o visitante após a conversão.

      <input type="hidden" name="redirect_to" value="http://seusite.com.br/obrigado/" />

Reconhecimento da origem do visitante

Com o Google Analytics, é possível descobrir a fonte da origem de seu visitante na hora que ele converter.

<input type="hidden" name="c_utmz" id="c_utmz" value="" />
<script type="text/javascript">
function read_cookie(a){var b=a+"=";var c=document.cookie.split(";");for(var d=0;d<c.length;d++){var e=c[d];while(e.charAt(0)==" ")e=e.substring(1,e.length);if(e.indexOf(b)==0){return e.substring(b.length,e.length)}}return null}try{document.getElementById("c_utmz").value=read_cookie("__utmz")}catch(err){}
</script>

Outros campos e informações do formulário

Dos dados do usuário, a informação de email ou email_lead é sempre obrigatória. Se não estiver presente, um erro retornará.

Diversos outros campos podem ser utilizados para um chaveamento automática com a ferramenta inteligente de CRM. Segue uma lista:

  • nome
  • telefone
  • empresa
  • cargo
  • twitter
Eles não são obrigatórios e você não precisa inserí-los na sua página se não desejar. Mas se já usar algum parecido, pode ajustar o nome dele conforme a lista acima para uma melhor integração.

Avisos de conversão por email

O RD Station pode lhe enviar um email quando uma nova conversão for realizada em seu site. Para isso, basta colocar o seu email na configuração da página da API https://www.rdstation.com.br/docs/api

Erros

A API pode retornar erro caso:

  • (401) seu token RD Station esteja errado ou inválido;
  • (400) não esteja recebendo um identificador;
  • (400) não esteja recebendo a informação email ou email_lead do formulário;

É importante que se teste a integração após as modificações para evitar esses erros aparecerem para o seu visitante.

Também é interessante usar alguma validação dos campos para requerer o preenchimento do campo de email, mas para isso será preciso algum controle Javascript ou de alguma outra linguagem.

Exemplos completos

Na código HTML abaixo, é possível ver uma página com um formulário simples que envia as informações para a API e depois redireciona o visitante para outra página.

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>HTML Puro | Integrações RD Station</title>
<style type="text/css">
html,body{text-align:center;}
#wrapper{width:600px; margin:0 auto; text-align:center;}
#conversion-form{width:300px; margin:0 auto; border:1px solid silver;text-align:left;}
#conversion-form .field{padding:4px;}
#conversion-form .actions{text-align:center;}
#conversion-form label{display:block;}
#conversion-form input[type=text]{width:90%;}
</style>
</head>
<body>
<div id="wrapper">
<h1>Integrações RD Station</h1>
<h2>HTML Puro</h2>
<form action="https://www.rdstation.com.br/api/1.2/conversions" method="POST">
<input type="hidden" name="token_rdstation" value="f1c940384a971f2982c61a5e5f11e6b9" />
<!--
* Atenção!
* Token de testes - Usar o próprio de sua conta encontrado em: https://www.rdstation.com.br/docs/api
-->
<input type="hidden" name="identificador" value="teste-html-puro" />
<input type="hidden" name="redirect_to" value="http://resultadosdigitais.com.br" />
<div class="field">
<label>E-mail:*</label>
<input type="text" name="email" />
</div>
<div class="field">
<label>Nome:*</label>
<input type="text" name="nome" />
</div>
<div class="field">
<label>Empresa:</label>
<input type="text" name="empresa" />
</div>
<div class="actions">
<input type="hidden" name="c_utmz" id="c_utmz" value="" />
<script type="text/javascript">
function read_cookie(a){var b=a+"=";var c=document.cookie.split(";");for(var d=0;d<c.length;d++){var e=c[d];while(e.charAt(0)==" ")e=e.substring(1,e.length);if(e.indexOf(b)==0){return e.substring(b.length,e.length)}}return null}try{document.getElementById("c_utmz").value=read_cookie("__utmz")}catch(err){}
</script>
<input type="submit" value="Enviar" />
</div>
</form>
</div>
</body>
</html>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment