Copy of Precisamos integrar o formulário que o lead preenche, trazendo as informações para o Rd Station (lead) e quando aprovado a venda, a marcação da venda.

Preciso fazer o rd station receber os valores do cookie utmz e passar para c_utmz.

Precisamos integrar o formulário que o lead preenche, trazendo as informações para o RD (lead) e quando aprovado a venda, a marcação da venda.

Integrar sistema próprio para Criação de Leads e registrar conversão (API)
Atualizado em: 19/02/2018


Instruções para realizar a integração:
URL para envio dos dados
https://www.rdstation.com.br/api/1.3/conversions
Método
Requisição http do tipo post
header
o  post deve conter o header "content-type: application/json"
body
no body do post deve vir um json com as seguintes informações (o nome dos atributos, lado esquerdo do json, deve obrigatoriamente seguir a estrutura abaixo):
obs.: O nome do campo personalizado deve ser exato, case sensitive, assim como as opções do campo.
{
  "Token_rdstation": "f1c940384a971f2982c61a5e5f11e6b9", //Obrigatório - Token Publico de autenticação
"identificador": "Nome_do_Evento_de_Conversão", //Obrigatório
"email": "teste@example.org", //Obrigatório
"nome": "Nome do Lead",
"cargo": "Cargo do Lead",
"empresa": "Nome da Empresa",
"numero-de-funcionarios":"100", // numero de funcionarios
"endereco-empresa":"Rua Teste 123", //endereco da empresa
"telefone": "(xx) 99999-9999",
"celular": "(xx) 99999-9999",
"website":"https://www.resultadosdigitais.com.br",
"twitter":"@resdigitais",
"c_utmz":"43135652.1441366582.1.1.utmcsr=(direct)|utmccn=(direct)|utmcmd=(none)", //Cookie __utmz do Google Analytics
"tags": "TAG_DESEJADA",
"nome do campo customizado 1":"valor do campo customizado 1",
"nome do campo customizado 2":"valor do campo customizado 2"
}

Parâmetros obrigatórios no envio dos dados
(token_rdstation, identificador e email: o envio não irá funcionar sem eles)

Parâmetro    Descrição    Variações aceitas
token_rdstation    token da sua conta do RD Station. Você deve utilizar o valor numérico encontrado dentro da sua conta da RD, neste link
-
identificador    será utilizado para identificar o evento de entrada do Lead no RD. Ex: form-contato, pedido-de-demo, pedido-de-trial, form-site     -
email    o email do Lead    email_lead, your-email, e-mail

Os parâmetros abaixo são opcionais no envio e variam de acordo com os campos requisitados no formulário externo.
Esses dados ficarão dispostos nos Detalhes do Lead (entenda melhor) e podem ser interessantes para posterior qualificação e segmentação da base. Alguns parâmetros possíveis:
Parâmetros opcionais

Parâmetro    Descrição    Variações aceitas    Observação
nome    nome do Lead    name, firstname, your-name, primeiro_nome, nombre, nomecompleto    
empresa    empresa do Lead    company    
cargo    cargo do Lead    job_title    
telefone    telefone do Lead    personal_phone    
celular    celular do Lead    mobile_phone    
estado    estado do Lead (Sigla)    uf, estado_    
cidade    cidade do Lead    -    
website    website do Lead    -     
twitter    perfil do twitter do Lead    -    
c_utmz    origem do Lead    -    Deve receber o valor do cookie __utmz
traffic_source    origem do Lead    -    Deve receber o valor do cookie __trf.src
client_id    cookie do lead tracking    -    Deve receber o valor do cookie rdtrk
tags    tag do Lead    -    

Entenda melhor como funciona a origem do lead e como cadastrar o utmz e traffic_source.
Campos Personalizados
Você também pode enviar e atualizar campos personalizados dos seus Leads através da API. Esses dados ficarão dispostos nos Detalhes do Lead (entenda melhor) e podem ser interessantes para posterior qualificação e segmentação da base.
Os campos personalizados funcionam da mesma forma que os outros campos "padrão", portanto a integração ocorre da mesma forma.
Lembre-se que os campos personalizados já devem existir no RD Station para que a integração mapeie os dados a esses campos. Caso o campo não exista, a informação não será enviada para o campo personalizado.
Esses parâmetros precisam ser enviados para a API do RDStation com o nome exato do campo personalizado (sensitive case, assim como as opções do campo). Você pode verificar o nome dos campos personalizados através do menu Converter -> Campos Personalizados.
A informação será apresentada conforme imagem abaixo:

Para campos customizados específicos:
•    Campo de seleção-verificação: A informação deve ser passada no formato "0" para Não e "1" para Sim;
•    Campo de múltipla escolha: A informação deve ser passada no formato de um array com todas as opções marcadas. Exemplo: ["Opção Marcada 1", "Opção Marcada 2", "Opção Marcada 3"]
•    Campo de seleção: A informações passada deve corresponder exatamente a opção do RD Station. Exemplo: "Opção Selecionada"
OBSERVAÇÃO: Caso sejam enviadas informações de campos do lead que já estão preenchidos no RD Station, estas informações são sobrescritas com a nova informação.
Ou seja, a informação atual do respectivo campo é sempre a última recebida.

Outros parâmetros
Você pode ainda enviar outros parâmetros que não apresentam campos disponíveis nos Detalhes do Lead, mas que são requisitados no seu formulário. Dessa forma, esses dados serão listados apenas nos dados da conversão, em Atividades do Lead. Visualize aqui como os dados ficarão dentro do RD


Exemplo de chamada a API
curl -v \
      -X POST \
      -H "Content-type: application/json" \
      -d '{ "email": "jules@example.org",
            "name": "Jules Winnfield",
            "identificador": "landing-page-ganhe-royale",
            "token_rdstation": "SEU_TOKEN"
          }' \
      'https://www.rdstation.com.br/api/1.3/conversions'


Outras formas de integrar conversões com o RD Station (clique para ler as orientações correspondentes a cada uma):
Integração Formulário:
•    Instalar JavaScript para integração de formulário
•    Executar apenas o post para a nossa api com os dados do lead

html:
•    html puro
•    html e ajax com jquery

linguagens:
•    php
•    ruby code ou gem

cms:
•    wordpress e plugin contact form 7
•    joomla e plugin form maker lite

e-commerce:
como gerar e instalar o script de integração de formulários?
atualizado em: 30/01/2018
essa configuração só funcionará se o botão do seu formulário for " type submit".

Para gerar o script de integração de formulário deve se acessar a tela de integração de formulários por meio deste link.
Passo 1 - Inserir a URL de sua página que contém o formulário a ser integrado
Após acessar a tela de integrações de formulários insira no campo disponível a URL de seu site que contém o formulário e clique em Buscar Formulários. O gerador de scripts irá buscar todos os formulários que podem ser integrados do link fornecido.


Como gerar e instalar o script de integração de formulários?
Atualizado em: 30/01/2018
Essa configuração só funcionará se o botão do seu formulário for " type submit".
Para gerar o script de integração de formulário deve se acessar a tela de integração de formulários por meio deste link.
Passo 1 - Inserir a URL de sua página que contém o formulário a ser integrado
Após acessar a tela de integrações de formulários insira no campo disponível a URL de seu site que contém o formulário e clique em Buscar Formulários. O gerador de scripts irá buscar todos os formulários que podem ser integrados do link fornecido.

O RDStation irá exibir os formulários que podem ser integrados do link fornecido. Selecione o formulário que você deseja integrar e clique em "Avançar" (no canto direito inferior).
ATENÇÃO: Nem todos os formulários podem ser identificados pelo gerador de script. Formulários que são gerados por meio de scripts, inseridos dentro de iframes ou criados dinamicamente na página provavelmente não serão identificados pelo gerador. Se o formulário que você deseja integrar não for encontrado verifique este artigo para uma alternativa.

Passo 2 - Mapear os campos do formulário com os campos do RDStation
O RDStation irá exibir todos os campos do formulário para que sejam mapeados a campos existentes no RDStation. Selecione na coluna da direita para qual campo do RDStation deve ir cada informação dos campos identificados do formulário.
Certifique-se que pelo menos o campo de email do formulário seja mapeado.
OBSERVAÇÃO:  O mapeamento de campos serve apenas para dizer para qual campo do RDStation a informação deve ir; os campos que não forem mapeados também serão enviados para o RDStation porém o nome do campo do formulário será mantido no RDStation independente se há ou não um campo com o mesmo nome.

Assim que terminar o mapeamento de nomes desejado, clique em "Avançar".
Passo 3 - Nomear o evento de conversão que será gerado no RDStation.
No passo 3 o RDStation irá exibir um campo para que o nome do evento de conversão seja definido. Esse identificador refere-se ao evento que será gerado no RDStation quando os Leads se cadastrarem nos formulários integrados.

Clique em "Avançar" após preencher o campo com o nome do evento desejado.
Passo 4 - Copiar o código gerado para inserção do mesmo no seu site.
O script de integração gerado deve ser inserido no html da página do formulário que deseja-se integrar.
ATENÇÃO: Para funcionar corretamente você deve inserir o código após o fechamento da tag </form> e antes do fechamento da tag </body>.


Passo 5 - Verificar se o script foi instalado corretamente.
Se todos os passos deste artigo foram seguidos corretamente, seu formulário deve estar integrado sem problemas. Porém, como validar? Neste outro artigo você encontra um simples passo a passo para verificar rapidamente se sua integração está funcionando com sucesso!