pedrobachiega/index.markdown

## index.markdown

      
    Raw
  

              index.markdown
            
          
    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.

  
## rdstation-exemplo-integracao-html-puro.html
<!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>
	<!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>