Skip to content

Instantly share code, notes, and snippets.

@pedrobachiega

pedrobachiega/index.markdown

Created August 8, 2012 21:34
Show Gist options
  • Save pedrobachiega/3298970 to your computer and use it in GitHub Desktop.
Save pedrobachiega/3298970 to your computer and use it in GitHub Desktop.
Download ZIP
Integrações RD Station - HTML puro
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.

Raw
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>
@netinho-flavio
Copy link

Boa tarde, amigos, tudo bem?
Estou iniciando com uma demanda de corrigir a origem do lead, mesmo enviando uma informação no campo de origem não consigo resolver esse problema, poderiam me ajudar?
image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment