01. Plataforma

01. Começando

01. Conceitos Básicos

02. Adicionando destinos

03. Adicionando conectores

02. Integrações

01. Criando integrações

02. Funções

01. Conceito

02. Chaves

03. Utilizando funções

04. Funções disponíveis

Cast to boolean

Cast to float

Cast to int

Cast to text

Hash SHA-512 com chave

JSONify

Remove EOL

UUID

03. Modelos

01. Criando modelos

02. Documentando modelos

04. Configurações

IPs Kondado

Planos e Limites

Tokens de acesso

Usuários

Gerenciamento de usuários

05. Metadados

Metadados na Kondado

06. Changelog

01. Changelog (2025)

02. Arquivo changelog (2021-2024)

02. Destinos

BigQuery (destino)

BigQuery (Service Account) (destino)

Excel (destino)

Google Sheets

Microsoft SQL Server

MySQL (destino)

MySQL SSH (destino)

PostgreSQL

PostgreSQL SSH

Redshift

Redshift SSH

Via Kondado

03. Conectores

55PBX

ActiveCampaign

Api4com

Apple App Store

ASAAS

Azure Table Storage

BigQuery (conector)

Bitrix24 CRM

Bling!

Blip (Take)

Brasil.io

ClickUp

Clockify

ContaAzul

Criteo

E-goi

EADBOX

Exact Sales

Facebook

01. Facebook

02. Facebook: Métricas de Páginas

03. Pivotando os dados das tabelas Actions do Facebook

Fatura Simples

Freshdesk

FTP

Google Ads (Adwords)

01. Google Ads (Adwords)

02. Criando uma integração de relatório customizado do Google Ads

03. Exemplo de como criar um relatório de estatísticas de anúncios do Google Ads

04. Referência de relatórios, métricas e dimensões

05. Melhores práticas para relatórios do Google Ads

Google Analytics 4 (GA4)

01. Google Analytics

02. Custom Report: métricas e dimensões

Google Cloud Storage

Google Play Store

Google Search Console (Google Webmasters)

Google Sheets

Granatum

Hi Platform

Hotmart

HubSpot

Huggy

Infusionsoft (Keap)

Instagram

Jira

Kondado

MailChimp

Mandrill

Meetime

Mercado Livre

Microsoft Advertising

01. Microsoft Advertising (Bing)

02. Referência de relatórios, métricas e dimensões

Microsoft SQL Server (conector)

Microsoft SQL Server SSH (conector)

Mixpanel

Monday.com

MongoDB

Movidesk

MySQL (conector)

MySQL SSH (conector)

NectarCRM

Omie

Oracle (conector)

Pagar.me

Pipedrive

Pipefy

PipeRun

Ploomes

PostgreSQL (conector)

Pushwoosh

RD Station

01. RD Station

02. Fazendo a carga histórica na integração do RD Station (exclusivo Webhook)

03. Integrando leads ou oportunidades que mudaram de estágio no RD Station (exclusivo Webhook)

RDStation CRM

Recruiterbox

S3 (conector)

Salesforce

Salesforce Marketing Cloud

SenseData

Shopify

Stilingue

Superlógica

Sympla

Taboola

Tangerino

TikTok Ads

Tiny ERP

Toggl

Tray

Trello

Twilio

VNDA

VTEX

Wake Commerce (antigo Tray Corp by FBits)

Webhook

Wootric

YouTube

Zeeng

Zendesk

Zendesk Chat

Índice de Conectores Kondado

04. API

Começando com a API da Kondado

Logs

Models

Parent Collections

Parent Pipelines

Pipelines

05. Visualização

Conexão Looker Studio Via Kondado

Conexão Power BI Via Kondado

Resolvendo o problema de “Contagem distinta” no Looker Studio via Kondado

Templates

Como integrar seus dados ao template de Dashboard da Kondado.

Dashboard Bling! (Looker Studio)

Dashboard Bling! (Power BI)

Dashboard Facebook Ads (Looker Studio)

Dashboard Facebook Ads (Power BI)

Dashboard Google Ads (Looker Studio)

Dashboard Google Ads (Power BI)

Dashboard Google Ads e Facebook Ads (Looker Studio)

Dashboard Google Analytics (GA4) Looker Studio

Dashboard Google Analytics (GA4) Power BI

Dashboard Instagram Looker Studio

Dashboard Instagram Power BI

Dashboard Olist Tiny (Looker Studio)

Dashboard Olist Tiny (PowerBI)

Dashboard Omie Looker Studio

Dashboard RD Station CRM (Looker Studio)

Dashboard VTEX (Looker Studio)

Dashboard VTEX (Power BI)

Usando o Google Data Studio com o BigQuery e a Kondado

Usando o Google Data Studio com o PostgreSQL e a Kondado

Usando o Power BI com o BigQuery e a Kondado

Usando o Power BI com o PostgreSQL e a Kondado

06. Central de Ajuda

01. Guia de dúvidas mais comuns dos conectores

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

Estatísticas de campanhas de e-mails

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
metric_start_date	timestamp
campaign_id	text	[pt] Id da campanha Emails > > campaign_id
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
metric_end_date	timestamp

Emails

Campo	Tipo
id	text	[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	text	[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	text	[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	text	[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	text	[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

Estatísticas de fluxos de automação

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
email_name	text	[pt] Nome da campanha enviada pela 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_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

Estatísticas de ativos de marketing

Campo	Tipo
metric_start_date	timestamp
asset_id	text	[pt] Identificador único do "Asset Landing pages > > id Pop Ups > > id Forms > > id
account_id	text	[pt] Identificador único da conta do RD Station relacionada aos dados retornados
asset_identifier	text	[pt] Nome ou identificador textual do ativo
asset_type	text	[pt] Tipo do ativo (exemplo: Landing Page)
asset_created_at	timestamp	[pt] Data em que o ativo foi criado
asset_updated_at	timestamp	[pt] Data da última atualização no ativo
visits_count	float	[pt] Número total de visitas ao ativo durante o período solicitado
conversion_count	float	[pt] Número total de conversões geradas pelo ativo no período solicitado
conversion_rate	float	[pt] Taxa de conversão do ativo
metric_end_date	timestamp

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