01. RD Station

Adicionando o conector

Requisitos

O seu plano do RD Station deve ser Light, Basic, Pro ou Advanced
O seu usuário deve ter um perfil de acesso de Dono, Gestor ou Marketing

💡Veja aqui o guia das dúvidas mais comuns sobre as integrações do RD Station

Instruções

Siga os passos abaixo para receber esses dados ao seu Data Warehouse:

1) Faça login na plataforma da Kondado, vá para a seção de adicionar conectores e selecione o conector do RDStation

2) Clique em AUTORIZAR

3) Na página de autorização do RD, selecione a conta que irá utilizar e clique em "Continuar

4) Depois clique em Conectar

5) Você será direcionado de volta à Kondado. Dê um nome ao seu conector e clique em SALVAR

6) Caso esteja utilizando webhook, confira as instruções adicionais para o correto funcionamento do conector e sua carga histórica

Integrações

Gráfico de relacionamento

Clique para ampliar

Contatos

Campo	Tipo
uuid	text	[pt] O uuid exclusivo associado a cada contato do RD Station
created_at	timestamp	[pt] Data de criação do contato
email	text	[pt] Email do contato
last_conversion_date	timestamp	[pt] Data da última conversão do contato
name	text	[pt] Nome do contato

Contatos: campos customizados

Campo	Tipo
uuid	text	[pt] O uuid exclusivo associado a cada contato do RD Station Contatos > > uuid
custom_field_a	text	[pt] Exemplo de custom field
custom_field_b	timestamp	[pt] Exemplo de custom field
custom_field_c	text	[pt] Exemplo de custom field

Contatos: eventos de conversão

Objeto principal

Campo	Tipo
contact_uuid	text	[pt] Código de identificador unico de usuario Contatos > > uuid
event_family	text	[pt] Identificador interno do RDSM
event_identifier	text	[pt] Identificador do evento
event_timestamp	timestamp	[pt] Data/hora de criação do evento
event_type	text	[pt] O tipo de evento (CONVERSION ou OPPORTUNITY)
payload_city	float
payload_company_name	text
payload_email	text
payload_name	text
payload_personal_phone	text
event_number	float	[pt] Identificador do evento criado pela Kondado

rdstation_contatos_eventos_conversoes_traffic_source

Campo	Tipo
contact_uuid	text	[pt] Código de identificador unico de usuario
event_number	float	[pt] Identificador do evento criado pela Kondado
traffic_source_param_key	text	[pt] Chave do parâmetro identificado no payload traffic_source. A string original é identificada como __kdd_raw. Caso a string original seja uma URL, também serão enviados os valores __kdd_hostname para o hostname (por exemplo app.kondado.com.br) e __kdd_path para o path da URL (por exemplo /signup para a URL https://app.kondado.com.br/signup)
traffic_source_param_value	text	[pt] Valor do parâmetro identificado do payload traffic_source
traffic_source_session_order	text	[pt] Indica se os parâmetros referem-se à sessão atual (current) ou à primeira (first)

Contatos: eventos de oportunidades

Campo	Tipo
contact_uuid	text	[pt] Código de identificador unico de usuario Contatos > > uuid
event_number	float	[pt] Identificador do evento criado pela Kondado
event_family	text	[pt] Identificador interno do RDSM
event_identifier	text	[pt] Identificador do evento
event_timestamp	timestamp	[pt] Data/hora de criação do evento, utilizando o formato UTC
event_type	text	[pt] O tipo de evento (CONVERSION ou OPPORTUNITY)
payload_funnel_name	text	[pt] Nome do funil

Contatos: funis

Campo	Tipo
contact_uuid	text	[pt] Código de identificador unico de usuario Contatos > > uuid
contact_owner_email	text	[pt] O e-mail do usuário responsável pelo contato
fit	float	[pt] A pontuação de ajuste do contato no funil atual
interest	float	[pt] A pontuação de interesse do contato no funil atual
lifecycle_stage	text	[pt] O estágio no funil ao qual o contato pertence.
opportunity	boolean	[pt] Indica se o contato é uma oportunidade ou não no funil
origin	text

Contatos: tags

Campo	Tipo
uuid	text	[pt] Indentificador unico do contato Contatos > > uuid
tags	text	[pt] Tags do contato

Campo

Tipo

uuid

text

[pt] Indentificador unico do contato

Contatos > > uuid

Email analytics

Esta integração está disponível apenas para contas Pro (limite de 45 dias de histórico) ou Advanced
A API de Estatísticas de E-mail Marketing retorna dados a partir de Agosto de 2021. Os dados são consolidados, sempre até o dia anterior à data da análise (D-1) e disponibilizados no padrão UTC

Campo	Tipo
campaign_id	float	[pt] Id da campanha
campaign_name	text	[pt] Nome da campanha de e-mail
contacts_count	float	[pt] Quantidade de contatos selecionados
email_bounced_count	float	[pt] Total de e-mails de rejeitados
email_clicked_count	float	[pt] Total de cliques únicos por lead
email_clicked_rate	float	[pt] Taxa de cliques em comparação com o número de e-mails entregues
email_delivered_count	float	[pt] Total de e-mails entregues
email_delivered_rate	float	[pt] Taxa de entrega
email_dropped_count	float	[pt] Total de e-mails descartados
email_opened_count	float	[pt] Total de aberturas únicas por lead
email_opened_rate	float	[pt] Taxa de abertura em comparação com o número de e-mails entregues
email_spam_reported_count	float	[pt] Total reportado como spam
email_spam_reported_rate	float	[pt] Taxa de spam em comparação com o número de e-mails entregues
email_unsubscribed_count	float	[pt] Total não inscrito
send_at	timestamp	[pt] Data de envio do e-mail

Emails

Campo	Tipo
id	float	[pt] ID do email
behavior_score_info_disengaged	boolean	[pt] Informa se estão selecionados leads desengajados
behavior_score_info_engaged	boolean	[pt] Informa se estão selecionados leads engajados
behavior_score_info_indeterminate	boolean	[pt] Informa se estão selecionados leads indeterminados
campaign_id	float	[pt] ID da campanha
component_template_id	float	[pt] ID do componente do template de email
created_at	text	[pt] Data da criação do email
is_predictive_sending	boolean	[pt] Informa se a campanha tem envio preditivo
leads_count	float	[pt] Quantidade de leads do email
name	text	[pt] Nome do email
send_at	text	[pt] Data do envio do email
sending_is_imminent	boolean	[pt] Informa se o envio é iminente
status	text	[pt] Status da campanha
type	text	[pt] Tipo do email
updated_at	text	[pt] Data da atualização do email

Forms

Campo	Tipo
id	float	[pt] Identificador único do formulário
conversion_identifier	text	[pt] Identificador da conversão Contatos: eventos de conversão > > event_identifier
created_at	timestamp	[pt] Data de criação do formulário
status	text	[pt] Status de publicação do formulário
title	text	[pt] Título do formulário
updated_at	timestamp	[pt] Data da última atualização do formulário

Landing pages

Campo	Tipo
id	float	[pt] Identificador único da landing page
conversion_identifier	text	[pt] Identificador da conversão Contatos: eventos de conversão > > event_identifier
created_at	timestamp	[pt] Data de criação da landing page
had_experiment	boolean	[pt] Informa se a landing page já possuiu um teste A/B
has_active_experiment	boolean	[pt] Informa se a landing page possui um teste A/B ativo
status	text	[pt] Status de publicação da landing page
title	text	[pt] Título da Landing Page
updated_at	timestamp

Pop Ups

Campo	Tipo
id	float	[pt] Identificador único do pop-up
conversion_identifier	text	[pt] Identificador da conversão Contatos: eventos de conversão > > event_identifier
created_at	timestamp	[pt] Data de criação do pop-up
status	text	[pt] Status de publicação do pop-up
title	text	[pt] Título do Pop-up
trigger	text	[pt] Gatilho para exibição do pop-up
updated_at	timestamp	[pt] Data da última atualização do pop-up

Webhook Leads

Esta integração requer configurações adicionais para funcionamento e carga histórica

Dê preferência para integrações de Contatos, que possuem uma configuração mais simples

Objeto principal

Campo	Tipo
id	text	[pt] ID do lead no RD Station
bio	text	[pt] Anotacoes no perfil do lead
city	text	[pt] Cidade do lead
company	text	[pt] Nome da empresa associada ao lead
created_at	timestamp	[pt] Data em que o lead foi criado
email	text	[pt] Email do lead
first_conversion_conversion_origin_campaign	text
first_conversion_conversion_origin_channel	text
first_conversion_conversion_origin_medium	text
first_conversion_conversion_origin_source	text
first_conversion_conversion_origin_value	text
first_conversion_created_at	timestamp
first_conversion_cumulative_sum	float
first_conversion_source	text
fit_score	text	[pt] Perfil do Lead Scoring do lead
interest	float	[pt] Interesse do Lead Scoring do lead
job_title	text	[pt] Cargo
last_conversion_conversion_origin_campaign	text
last_conversion_conversion_origin_channel	text
last_conversion_conversion_origin_medium	text
last_conversion_conversion_origin_source	text
last_conversion_conversion_origin_value	text
last_conversion_created_at	timestamp
last_conversion_cumulative_sum	float
last_conversion_source	text
last_marked_opportunity_date	timestamp
lead_stage	text	[pt] Estagio do lead
mobile_phone	text	[pt] Celular do lead
name	text	[pt] Nome do lead
number_conversions	float	[pt] Numero de conversoes
opportunity	boolean	[pt] Se o lead e uma oportunidade
personal_phone	text	[pt] Telefone do lead
public_url	text	[pt] URL publica do lead
state	text	[pt] Estado do lead
user	text	[pt] Email do dono do lead
uuid	text
website	text	[pt] Site do lead
__kdd_request_id	text	[pt] ID do request feito ao endpoint de wehbook da Kondado - retornado para a aplicacao que fez o POST
__kdd_request_unix_timestamp	float	[pt] UNIX timestamp do request feito ao endpoint de wehbook da Kondado - retornado para a aplicacao que fez o POST
__kdd_requester_key	text	[pt] Chave utilizada para autenticar o POST feito ao endpoint de webhook da Kondado

rdstation_leads_tags

Campo	Tipo
lead_id	text	[pt] ID do lead ao qual o registro se refere
tag	text	[pt] Tag associada ao lead_id

rdstation_leads_first_conversion_content

Campo	Tipo
lead_id	text	[pt] ID do lead ao qual o registro se refere
key	text	[pt] Chave do campo da primeira conversao
val	text	[pt] Valor preenchido na primeira conversao pelo lead_id para o campo representado pela chave da coluna key

rdstation_leads_last_conversion_content

Campo	Tipo
lead_id	text	[pt] ID do lead ao qual o registro se refere
key	text	[pt] Chave do campo da ultima conversao
val	text	[pt] Valor preenchido na ultima conversao pelo lead_id para o campo representado pela chave da coluna key

rdstation_leads_custom_fields

Campo	Tipo
lead_id	text	[pt] ID do lead ao qual o registro se refere
key	text	[pt] Chave do campo customizado
val	text	[pt] Valor preenchido na pelo lead_id para o campo representado pela chave da coluna key

Workflow email analytics

Esta integração está disponível apenas para contas Pro (limite de 45 dias de histórico) ou Advanced
A API de Estatísticas de Fluxo de Automação retorna dados a partir de Janeiro de 2022. Os dados são consolidados e disponibilizados no padrão UTC

Campo	Tipo
metric_start_date	timestamp
workflow_action_id	text	[pt] Id do email de automação
contacts_count	float
count_processed	float
created_at	timestamp
email_bounced_unique_count	float	[pt] Total de e-mails de rejeitados
email_clicked_rate	float	[pt] Taxa de cliques em comparação com o número de e-mails entregues
email_clicked_unique_count	float	[pt] Total de cliques únicos por lead
email_delivered_count	float	[pt] Total de e-mails entregues
email_delivered_rate	float	[pt] Taxa de entrega
email_dropped_count	float	[pt] Total de e-mails descartados
email_name	text	[pt] Nome da campanha enviada pela automação
email_opened_rate	float	[pt] Taxa de abertura em comparação com o número de e-mails entregues
email_opened_unique_count	float	[pt] Total de aberturas únicas por lead
email_spam_reported_count	float	[pt] Total reportado como spam
email_spam_reported_rate	float	[pt] Taxa de spam em comparação com o número de e-mails entregues
email_unsubscribed_count	float	[pt] Total não inscrito
metric_end_date	timestamp
updated_at	timestamp
workflow_id	text	[pt] Id da automação
workflow_name	text	[pt] Nome da automação

Notas

Configuração do webhook

Para finalizar a configuração desta integração, siga os passos abaixo

1) Será necessário criar um token na plataforma da Kondado para que o RD possa nos enviar dados de forma segura. Na parte superior à direita, clique no seu email e depois em Configurações

2) Na página de configurações, clique no menu de TOKENS e depois em Novo token

3) Dê um nome ao Novo token (por exemplo, Token RD) e depois clique em CRIAR

4) Após clicar em CRIAR, serão exibidos apenas desta vez Chave do token e Token. Copie estes valores em um editor de texto e clique em OK para seguirmos com o tutorial

Caso não tenha copiado o valor do Token, ele não será exibido novamente. Neste caso, desative a chave gerada anteriormente e recomece o tutorial do passo (4) em diante

5) Agora, vamos primeiro criar a integração e depois continuar o processo. Vá para a seção de integrações na plataforma da Kondado e clique em Nova integração

6) Selecione seu destino de dados, e como conector utilize aquele criado no passo (2)

7) Depois selecione Leads (webhook) como objeto a ser integrado

8) Siga o fluxo normal de criação e adicione uma nova integração

9) Uma vez que a integração esteja criada, observe que a URL que estará na barra de endereço do seu navegador será algo como

https://app.kondado.com.br/pipelines/123456

Copie e valor após "pipelines/", neste exemplo será o valor 123456 - este é o id da sua integração (pipeline_id) e será usado em seguida

10) Agora, faça login no RDStation marketing que deseja integrar

11) No menu superior à direita, clique em "Minha conta" e depois em "Integrações"

12) Na página de integrações, acesse a aba "Minhas Integrações", busque a seção "Webhooks" e clique em "Configurar

13) Na nova tela, clique em "Criar Webhook"

14) No popup que irá abrir, preencha as informações da seguinte forma:

Nome: Um nome para utilização interna, por exemplo "Novo Webhook"
URL: Preencha a URL substituindo valores conforme instruções abaixo:
- Utilize como base https://k1.kondado.com.br?pipeline_id={pipelineidaqui}&token={oseutokenaqui}&key={achavedoseutokenaqui} substituíndo os valores da seguinte forma:
  - Em {pipelineidaqui} substitua pelo valor obtido no passo 11 (por exemplo, 123456)
  - Em {oseutokenaqui} substitua pelo valor do Token obtido no passo 6 (será um valor alfa-numérico grande e sem hífens)
  - Em {achavedoseutokenaqui} substitua pelo valor da Chave do token obtido no passo 6 (será um valor menor que o token, e possui hífens)
Gatilho: Selecione o gatilho que fará os dados serem enviados ao webhook:
- Ao enviar dados de Conversão, serão enviados leads que realizaram alguma conversão no RDStation Marketing, além disso você poderá escolher abaixo os Eventos de Conversão que serão considerados ou deixar em branco para enviar todas as conversões:
  - Segundo o site do RD Station: "Se as conversões forem realizadas em uma Landing Page, Formulário ou Pop-up do RD Station Marketing, o identificador vai ser o título da página/nome do elemento criado; se for integrado (formulários integrados, API, etc), eles podem ser identificados pelo identificador da conversão"
- Ao enviar dados de Oportunidade, serão enviados os leads marcados como Oportunidade - apenas após serem marcados como oportunidade (estrelinha) manualmente ou por um fluxo de automação

Em cada execução da integração, dados de leads com mesmo id serão lidos apenas uma vez. Isso quer dizer que se você utilizar o mesmo pipeline_id na URL de webhooks diferentes - por exemplo um para Conversão e outro para Oportunidade, caso um lead seja enviado 2 vezes, apenas um destes eventos será considerado. Dessa forma, recomendamos que você crie integrações diferentes para Conversão e Oportunidade - basta que você repita o passo a passo a partir do passo 7 para cada Gatilho, não é necessário criar outro token ou outro conector

15) Agora basta clicar em "Salvar Webhook" e você verá o seu novo webhook que começará a enviar os dados para o seu data warehouse!

Carga histórica

Os dados de webhook são enviados ao seu destino apenas a partir do momento em que o webhook é salvo.

Para enviar os leads que já estão cadastrados na sua conta do RD Station (carga histórica), basta clicar aqui e seguir nosso tutorial

Apenas eventos de conversão no RD Station fazem com que os leads sejam enviados para o webhook e assim integrados ao seu destino. Caso deseje que as informações dos leads sejam atualizadas no seu destino quando são feitos outros tipos de alterações no lead, como por exemplo, mudanças de estágio que não configurem eventos de conversão, siga esse tutorial aqui.

Dicas sobre divergências entre os dados da integração e da ferramenta RD Station

Caso note que algum contato não está sendo enviado para sua tabela de destino, recomendamos verificar se todos os eventos de conversão estão sendo corretamente enviados à URL da integração (verificar passo 16 do tutorial desta página).
Apenas eventos de conversão no RD Station fazem com que os leads sejam enviados para o webhook e assim integrados ao seu destino. Caso deseje que as informações dos leads sejam atualizadas no seu destino quando são feitos outros tipos de alterações no lead, como por exemplo, mudanças de estágio que não configurem eventos de conversão, siga esse tutorial aqui.
Os dados de webhook são enviados ao seu destino apenas a partir do momento em que o webhook é salvo. Para enviar os contatos que já estão cadastrados na sua conta do RD Station (carga histórica), basta clicar aqui e seguir nosso tutorial.
Alguns indicadores do dashboard do RD são calculados de forma diferente. Por exemplo, o número de Leads do dashboard traz todos os visitantes que tiverem pelo menos uma conversão no período, podendo ser a primeira ou não. O entendimento do que cada métrica nos relatórios da ferramenta significa é importante para a identificação de possíveis divergências com as visões criadas a partir dos dados da integração da Kondado. Recomendamos a leitura das páginas de documentação do RD Station indicadas abaixo para compreensão dessas diferenças:
Significado de cada métrica nos relatórios do RD Station
Explicação sobre os indicadores do dashboard do RD Station