SenseData

Adicionando a fonte de dados

Adicionando o conector

Baseado na documentação da API do SenseData (V1) e (V2)

Requisitos

Não há menção de restrição de nível de acesso ou tipo de conta por parte da documentação do conector
Em todos os momentos, utilizamos o ambiente de produção

Instruções

1) Envie um e-mail ao suporte da SenseData pedindo o seu token de ambiente de produção para utilização do 'Sense Connect'

2) Faça login na Kondado, vá para a seção de adicionar conectores e selecione o conector do SenseData

3) No conector, em "Nome" dê um nome para o seu conector e, em Token cole o valor obtido no passo (2)

Agora basta clicar em SALVAR e para começar a receber dados do SenseData no Data Warehouse ou Data Lake

Pipelines

Diagrama de relacionamento

Clique para expandir

Atividades

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
Data inicial de leitura (Savepoint): A partir de qual data de início (start_date) os dados serão lidos

Relacionamentos:

created_by__id → Usuários > id
id_contact → Contatos > id
id_customer → Clientes > id
id_parent → Atividades > id
id_playbook → Playbooks > id
owner__id → Usuários > id

[pt] Atividades/tarefas de Customer Success no SenseData, um registro por atividade. Traz descrição, grupo, datas de previsão e conclusão, horas planejadas e gastas, autor e vínculos com o cliente, o contato, o playbook e a atividade pai que a originaram.

Campo	Tipo
id	text
created_at	timestamp
created_by__id	text	[pt] ID de quem criou a atividade Usuários > > id
custom_value	float
description	text
due_date	date	[pt] Data de previsao para conclusao da atividade
end_date	timestamp	[pt] Data e hora de conclusao da atividade
favorite	boolean	[pt] Se essa atividade deve estar marcada como favorita
group	text	[pt] Grupo da atividade
hours_planned	float
hours_spent	float
id_contact	text	[pt] ID interno do contato referente a atividade Contatos > > id
id_customer	text	[pt] ID interno do cliente Clientes > > id
id_legacy	text	[pt] ID externo da atividade
id_parent	text	[pt] ID interno da atividade pai Atividades > > id
id_playbook	text	[pt] ID do playbook que gerou essa atividade Playbooks > > id
id_rule	text	[pt] ID do regra que gerou essa atividade
notes	text
owner__id	text	[pt] ID do responsavel pela atividade Usuários > > id
priority__description	text
priority__id	text
progress	float
start_date	date	[pt] Data de inicio da atividade
status__description	text
status__id	text	[pt] ID do status da atividade
system_end_date	timestamp
tags	text
type__caption	text
type__description	text
type__enabled	boolean
type__id	text	[pt] ID do tipo da atividade
type__is_default	boolean
updated_at	timestamp

Clientes

Tipo de replicacao: Integral

Objeto principal

[pt] Cadastro das contas/clientes acompanhados no SenseData, um registro por cliente. Reúne dados cadastrais (nome fantasia, razão social, CNPJ, segmento, porte, cidade, UF, grupo), os responsáveis de Customer Success (CS e CSM), o sponsor e contato comercial, datas de registro e cancelamento e a fase e o status atual do cliente.

Campo	Tipo
id	text
cancel_description	text
cancel_tag	text	[pt] Tags do cliente inativo
city	text	[pt] Cidade do cliente
cnpj	text	[pt] CNPJ do cliente
created_at	timestamp
cs__active	boolean
cs__created_at	timestamp
cs__email	text
cs__id	text	[pt] ID do CS do cliente
cs__name	text
cs_profile_name	text
cs_profile_role	text
cs__registered_on	timestamp
cs__updated_at	timestamp
cs__username	text
csm__active	boolean
csm__created_at	timestamp
csm__email	text
csm__id	text	[pt] ID do CSM do cliente
csm__name	text
csm_profile_name	text
csm_profile_editor	text
csm__registered_on	timestamp
csm__updated_at	timestamp
csm__username	text
dt_cancel	date	[pt] Data do cancelamento do cliente
dt_register	date	[pt] Data de registro do cliente
dt_stage	date	[pt] Data de mudana de fase
group	text	[pt] Grupo que o cliente pertence
id_legacy	text	[pt] ID externo do cliente
industry	text	[pt] Segmento do cliente
name	text	[pt] Nome fantasia do cliente
name_contract	text	[pt] Nome do cliente
salesperson	text	[pt] Comercial do cliente
size	text	[pt] Porte do cliente
sponsor	text	[pt] Sponsor do cliente
sponsor_email	text	[pt] E-mail de contato do sponsor
sponsor_phone	text	[pt] Telefone de contato do sponsor
stage	text	[pt] Fase do cliente
state	text	[pt] UF do cliente
status__description	text	[pt] Descricao do status do cliente
status__enabled	boolean
status__id	text	[pt] ID do status do cliente
updated_at	timestamp

sensedata_customers__custom_fields

[pt] Campos personalizados dos clientes do SenseData, um registro por par chave/valor. Cada linha detalha um campo customizado de um cliente da tabela de clientes (referenciado por customer_id), trazendo o nome do campo e seu valor convertido para texto.

Campo	Tipo
customer_id	text
custom_fields__key	text	[pt] Nome do campo customizado
custom_fields__value	text	[pt] Valor do campo customizado (convertido para texto)

Contatos

Tipo de replicacao: Integral

Relacionamentos:

id_customer → Clientes > id

Objeto principal

[pt] Contatos das contas no SenseData, um registro por contato. Reúne nome, e-mail, telefones, cargo, endereço e indicadores como contato ativo, favorito e sponsor principal do cliente, vinculados à conta correspondente.

Campo	Tipo
id	text
address	text	[pt] Endereco do contato
email	text	[pt] E-mail do contato
email_unsubscribe	boolean	[pt] Se o contato nao deve receber e-mails
id_customer	text	[pt] ID interno do cliente Clientes > > id
id_legacy	text	[pt] ID externo do contato
is_active	boolean	[pt] Se o contato esta ativo
is_favorite	boolean	[pt] Se o contato e o favorito para aquele cliente
is_main_sponsor	boolean	[pt] Se o contato e o sponsor do cliente
name	text	[pt] Nome do contato
nickname	text	[pt] Apelido para o contato
obs_info	text
occupation	text	[pt] Cargo do contato
phone	text	[pt] Telefone do contato
phone2	text	[pt] Telefone secundario do contato
skype	text	[pt] Usuario do skype
unsubscribe_reason	text
updated_at	timestamp	[pt] Data da ultima atualizacao do contato

sensedata_contacts_custom_fields

[pt] Campos personalizados dos contatos do SenseData, um registro por par chave/valor. Cada linha detalha um campo customizado de um contato da tabela de contatos (referenciado por contact_id), com o nome do campo e seu valor convertido para texto.

Campo	Tipo
contact_id	text
custom_fields_key	text	[pt] Nome do campo customizado
custom_fields_value	text	[pt] Valor do campo customizado (convertido para texto)

sensedata_contacts_types

[pt] Tipos atribuídos aos contatos do SenseData, um registro por tipo de cada contato. Filha da tabela de contatos (referenciada por contact_id), traz o id e a descrição de cada tipo associado ao contato.

Campo	Tipo
contact_id	text
types_id	text	[pt] id do tipo do contato
types_name	text	[pt] descricao do tipo do contato

Contratos

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

Janela de atualização (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados
Data inicial de leitura (Savepoint): A partir de qual data de emissão (created_on) os dados serão lidos

Relacionamentos:

id_customer → Clientes > id

[pt] Contratos dos clientes no SenseData, um registro por item de contrato. Traz plano, modelo de cobrança (ARR, MRR, OTR), valores e mensalidade, parcelas, quantidade de licenças, ciclo, vigência (início e fim), renovação automática e status, vinculados ao cliente.

Campo	Tipo
id	text
auto_renewal	boolean	[pt] Se o contrato tem renovacao automatica
created_on	timestamp	[pt] Data que o contrato foi emitido
cycle	float	[pt] Ciclo do contrato
description	text	[pt] Descricao do contrato
end_date	date	[pt] Data de fim da vigencia
id_customer	text	[pt] ID interno do cliente Clientes > > id
id_legacy	text	[pt] ID externo do contrato
instalments	float
is_subscription	boolean	[pt] Se o contrato e do tipo assinatura
item_sequence	float
license_qty	float
model	text	[pt] Modelo de cobranca (ARR, MRR, OTR)
monthly_payment	float
paper_contract	text	[pt] Codigo ou ID do contrato
plan	text	[pt] Plano do contrato
start_date	date	[pt] Data de inicio da vigencia
status__description	text
status__enabled	boolean
status__id	text
type	text	[pt] Tipo do contrato

Financeiro

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

Data inicial de leitura (Savepoint): A partir de qual data de competência (invoice_date) os dados serão lidos
Janela de atualização posterior (dias): Quantidade de dias posteriores ao savepoint que atualizaremos os dados
Janela de atualização anterior (dias): Quantidade de dias anteriores ao savepoint que atualizaremos os dados

Relacionamentos:

id_customer → Clientes > id

[pt] Títulos financeiros (faturamento/cobranças) dos clientes no SenseData, um registro por título. Contém valor, datas de vencimento, faturamento e pagamento, status, tipo e códigos de documento, item e nota fiscal, vinculados ao cliente correspondente.

Campo	Tipo
id	text
amount	float
created_at	timestamp
due_date	date	[pt] Data de vencimento do titulo
id_customer	text	[pt] ID interno do cliente Clientes > > id
id_legacy	text	[pt] ID externo do titulo
invoice_date	date	[pt] Data de faturamento do titulo
legacy_status	text
payment_date	date	[pt] Data de pagamanto do titulo
ref_doc	text	[pt] Codigo do titulo
ref_invoice	text	[pt] Codigo da nota fiscal do titulo
ref_item	text	[pt] Codigo do item referente ao titulo
status__billing_factor	float
status__description	text
status__enabled	boolean
status__id	text
type	text	[pt] Tipo do titulo
updated_at	timestamp

Playbooks

Tipo de replicacao: Integral

[pt] Playbooks configurados no SenseData, um registro por playbook. Reúne o nome, a data de criação e indicadores de status (ativo) e de exclusão de cada playbook usado para automatizar ações de Customer Success.

Campo	Tipo
id	text
name	text
created_on	date
status	boolean
deleted	boolean

Usuários

Tipo de replicacao: Integral

[pt] Usuários da plataforma SenseData, um registro por usuário. Contém nome, login, e-mail, perfil de acesso (nome e papel), indicador de usuário ativo e datas de cadastro e atualização.

Campo	Tipo
id	text
active	boolean	[pt] Se o usuario esta ativo
created_at	timestamp
email	text	[pt] E-mail do usuario
name	text	[pt] Nome completo do usuario
profile__name	text	[pt] Nome do perfil do usuario
profile__role	text	[pt] Perfil do usuario
registered_on	timestamp
updated_at	timestamp
username	text	[pt] Nome de usuario

Notas

Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas

Adicionar o conector SenseData na Kondado

Configure a integração do SenseData com seu Data Warehouse ou Data Lake em poucos passos, obtendo o token de produção e salvando o conector na plataforma.

Solicitar token de produção ao SenseData

Envie um email para suporte@sensedata.com.br solicitando o token do ambiente de produção para utilização do "Sense Connect". Este token é obrigatório para autenticar a integração.

Acessar a seção de conectores na Kondado

Faça login na Kondado e vá para a seção de conectores para visualizar todas as opções disponíveis, incluindo o conector do SenseData nas versões V1 e V2.

Selecionar e configurar o conector SenseData

Selecione o conector do SenseData, defina um nome identificável no campo "Nome" e cole o token de produção obtido no passo anterior no campo "Token".

Salvar e iniciar a integração

Clique em SALVAR para ativar o conector. A partir daí, você poderá direcionar os dados do SenseData para um destino como Data Warehouse ou Data Lake e começar a analisar informações de clientes, contratos, financeiro e atividades.

Perguntas frequentes

Preciso de algum nível específico de acesso na SenseData para usar o conector?▼

Não. Segundo a documentação do conector, não há restrição de nível de acesso ou tipo de conta necessária para a integração. Em todos os momentos, utilizamos o ambiente de produção.

Como obtenho o token de autenticação para o Sense Connect?▼

Você deve enviar um email para suporte@sensedata.com.br solicitando explicitamente o token do ambiente de produção para utilização do "Sense Connect". Este token será usado na configuração do conector na Kondado.

Quais dados do SenseData posso integrar através da Kondado?▼

O conector permite extrair dados de múltiplos objetos do SenseData, incluindo Clientes (com informações de CS e CSM), Contatos, Usuários, Playbooks, Atividades, além de módulos Financeiro e Contratos com seus respectivos campos e relacionamentos.

Para quais destinos posso enviar os dados do SenseData?▼

Após configurar o conector, você pode enviar os dados do SenseData para diversos destinos suportados pela Kondado, como Data Warehouses, Data Lakes, BI tools e planilhas, permitindo centralizar sua análise de métricas de Customer Success.

O conector suporta quais versões da API do SenseData?▼

O conector da Kondado é baseado na documentação da API do SenseData nas versões V1 e V2, garantindo compatibilidade com os endpoints disponibilizados pela plataforma.

Escrito por

Thassyo Pereira·Publicado em 2021-08-16·Atualizado em 2026-06-01