Passar para o conteúdo principal

Atualizar estágio do Lead via API Ramper Marketing - Javascript

Como usar a integração 'leads' via Javascript para atualizar o estágio de um lead no Ramper Marketing, com exemplo de formulário e script.

Escrito por Vinicius Poleti

A integração leads é utilizada para a atualização específica do estágio do lead no Ramper Marketing. Para atualizar o estágio via API por meio de Javascript, siga os passos abaixo.

1. Prepare os campos do formulário

Insira na propriedade class dos elementos do formulário: api-lahar e lahar_[nome_campo_integracao], principalmente no campo de e-mail, pois o e-mail é a chave primária usada para identificar o lead na base de contatos.

Email: <input class="api-lahar lahar_email_contato" type="text" id="campo_email" value="">

Consulte a lista atualizada de campos disponíveis para integração (nome_campo_integracao) no artigo correspondente.

2. Insira o script na página

Adicione o script abaixo antes da tag </body> e substitua as informações:

  • ID_DO_FORMULARIO_COM_AS_INFOS: valor da propriedade id do <form> com os campos usados na integração.

  • TOKEN_DA_API_LAHAR_OBTIDO_EM_CONFIGURACOES: token obtido na área de Configurações do Ramper Marketing.

  • ENDERECO_REDIRECIONAMENTO: URL para redirecionamento após a conversão no formulário.

  • CODIGO_DO_ESTAGIO_DO_LEAD: número de 1 a 4 indicando o estágio a ser atualizado.

Códigos de estágio: 1 = Lead, 2 = Oportunidade, 3 = Cliente, 4 = Lead Qualificado.

<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.10.2/jquery.min.js"></script>
<script src="https://scripts.lahar.com.br/api_parametros.js" type="text/javascript"></script>
<script type="text/javascript">
$(document).ready(function() {
  var integrou = false;
  $("#ID_DO_FORMULARIO_COM_AS_INFOS").submit(function() {
    if (!integrou) {
      efetua_integracao();
      integrou = true;
      return false;
    }
  })
});
function efetua_integracao() {
  var campos = { // campos fixos ou enviados como hidden no formulário
    token_api_lahar: 'TOKEN_DA_API_LAHAR_OBTIDO_EM_CONFIGURACOES',
    estagio_lead: CODIGO_DO_ESTAGIO_DO_LEAD, // 1 lead, 2 oportunidade, 3 cliente, 4 lead qualificado
    url_origem: $(location).attr('href')
  };
  var elementos = [];
  $('.api-lahar').each(function(index, element) {
    elementos.push(element);
  });
  integracao_js(campos, 'redireciona', elementos, 'leads');
}
function redireciona() {
  var form = document.getElementById("ENDERECO_REDIRECIONAMENTO");
  form.submit();
}
</script>

Ainda tem dúvidas?

É só entrar em contato com o nosso time de Suporte pelos canais:

  • Chat: disponível dentro do software, acessando sua conta em Perfil > Atendimento via Chat. O atendimento ocorre em dias úteis (calendário de São Paulo), das 9h às 12h e das 13h às 18h.

Respondeu à sua pergunta?