Clockify

Adicionando a fonte de dados

Adicionando o conector

Adicionando o conector do Clockify na Kondado, você pode ter acesso aos dados dos seus registros de horas no seu Data Warehouse ou Data Lake - processo também conhecido como ETL ou ELT

Para adicionar o conector do Clockify, siga os passos abaixo:

1) Faça login na sua conta do Clockify

Atenção: O usuário do Clockify utilizado deve ter permissões de WORKSPACE_OWN ou WORKSPACE_ADMIN para os workspaces que quer integrar

2) Clique na sua imagem de perfil na barra lateral esquerda e depois em "Profile settings"

3) Na seção API você encontrará a sua API key (clique em "Generate" caso ainda não tenha a sua API key). Copie este valor

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

5) Na página de preenchimento dos dados do conector, cole o valor obtido no passo (3) em "API key"

6) Agora basta dar um nome para o seu conector e clicar em SALVAR

Pipelines

Diagrama de relacionamento

Clique para expandir

Clients

Tipo de replicacao: Integral

Parametros:

Workspaces: Workspaces de onde os dados serão buscados. Deixe em branco para buscar todos workspaces

Relacionamentos:

workspaceid → Workspaces > id

Cliente do Clockify: empresa ou pessoa à qual os projetos podem ser vinculados.

Campo	Tipo
id	text	[pt] Identificador único do cliente.
archived	boolean	[pt] Indica se o cliente está arquivado.
workspaceid	text	[pt] Identificador do espaço de trabalho ao qual o cliente pertence. Workspaces > > id
address	text	[pt] Endereço do cliente.
name	text	[pt] Nome do cliente.

Projects

Tipo de replicacao: Integral

Parametros:

Workspaces: Workspaces de onde os dados serão buscados. Deixe em branco para buscar todos workspaces

Relacionamentos:

clientid → Clients > id
workspaceid → Workspaces > id

Projeto do Clockify: trabalho ao qual os registros de tempo são associados, normalmente vinculado a um cliente e com taxas e estimativas próprias.

Campo	Tipo
id	text	[pt] Identificador único do projeto.
archived	boolean	[pt] Indica se o projeto está arquivado.
name	text	[pt] Nome do projeto.
color	text	[pt] Cor associada ao projeto, em hexadecimal.
billable	boolean	[pt] Indica se o tempo registrado no projeto é faturável por padrão.
clientid	text	[pt] Identificador do cliente vinculado ao projeto. Clients > > id
timeestimate__active	boolean	[pt] Indica se a estimativa de tempo do projeto está ativa.
timeestimate__estimate	text	[pt] Estimativa de tempo do projeto no formato de duração ISO 8601 (ex.: PT0S).
timeestimate__type	text	[pt] Tipo da estimativa de tempo (ex.: AUTO ou MANUAL).
timeestimate__resetoption	text	[pt] Opção de reinício da estimativa de tempo (ex.: por período); nulo quando não há reinício.
note	text	[pt] Observações ou anotações do projeto.
public	boolean	[pt] Indica se o projeto é público no espaço de trabalho.
workspaceid	text	[pt] Identificador do espaço de trabalho ao qual o projeto pertence. Workspaces > > id
template	boolean	[pt] Indica se o projeto é um modelo (template).
hourlyrate__currency	text	[pt] Moeda da taxa horária do projeto.
hourlyrate__amount	float	[pt] Valor da taxa horária do projeto.
duration	text	[pt] Tempo total já registrado no projeto, no formato de duração ISO 8601.
estimate__estimate	text	[pt] Estimativa total do projeto no formato de duração ISO 8601.
estimate__type	text	[pt] Tipo da estimativa total do projeto (ex.: AUTO ou MANUAL).
clientname	text	[pt] Nome do cliente vinculado ao projeto.
costrate__currency	text	[pt] Moeda da taxa de custo do projeto.
costrate__amount	float	[pt] Valor da taxa de custo (custo por hora) do projeto.

Campo	Tipo
id	text	[pt] Identificador único da tag.
archived	boolean	[pt] Indica se a tag está arquivada.
workspaceid	text	[pt] Identificador do espaço de trabalho ao qual a tag pertence. Workspaces > > id
name	text	[pt] Nome da tag.

Tasks

Tipo de replicacao: Integral

Parametros:

Workspaces: Workspaces de onde os dados serão buscados. Deixe em branco para buscar todos workspaces

Relacionamentos:

assigneeid → Users > id
projectid → Projects > id
assignee_user_id > assignees → Users > id

Objeto principal

Tarefa do Clockify: subdivisão de um projeto à qual o tempo pode ser atribuído.

Campo	Tipo
id	text	[pt] Identificador único da tarefa.
status	text	[pt] Status da tarefa (ex.: ACTIVE, DONE).
name	text	[pt] Nome da tarefa.
assigneeid	text	[pt] Identificador do usuário responsável principal pela tarefa. Users > > id
projectid	text	[pt] Identificador do projeto ao qual a tarefa pertence. Projects > > id
estimate	text	[pt] Estimativa de tempo da tarefa no formato de duração ISO 8601.
duration	text	[pt] Tempo total registrado na tarefa, no formato de duração ISO 8601.

clockify_tasks__assignees

Responsáveis pela tarefa: usuários atribuídos a uma tarefa do Clockify (relação tarefa-usuário).

Campo	Tipo
task_id	text	[pt] Identificador da tarefa à qual o responsável está atribuído.
assignee_user_id	text	[pt] Identificador do usuário atribuído à tarefa. Users > > id

Campo

Tipo

task_id

text

[pt] Identificador da tarefa à qual o responsável está atribuído.

assignee_user_id

text

[pt] Identificador do usuário atribuído à tarefa.

Users > > id

Time entries

Esta integração não captura deleções. Caso um registro seja excluído na ferramenta, ele continuará no seu destino até que a tabela sofra uma edição avançada. Por isso disponibilizamos uma versão integral, que irá sempre ler todos os dados.

Tipo de replicacao: Incremental com janela de atualizacao

Parametros:

Janela de atualização (dias): Durante quantos dias um mesmo período continuará sendo atualizado
Workspaces: Workspaces de onde os dados serão buscados. Deixe em branco para buscar todos workspaces
Data inicial de leitura (Savepoint): A partir de qual data de atualização os registros serão lidos

Relacionamentos:

workspaceid → Workspaces > id
projectid → Projects > id
userid → Users > id
tag_id > tags → Tags > id

Objeto principal

Registro de tempo do Clockify: lançamento de horas trabalhadas, com início, fim e duração, vinculado a usuário, projeto e, opcionalmente, tarefa.

Campo	Tipo
id	text	[pt] Identificador único do registro de tempo.
timeinterval__duration	text	[pt] Duração do registro de tempo no formato de duração ISO 8601 (ex.: PT25M).
timeinterval_start	timestamp	[pt] Data e hora de início do registro de tempo.
timeinterval_end	timestamp	[pt] Data e hora de término do registro de tempo.
islocked	boolean	[pt] Indica se o registro de tempo está bloqueado para edição.
workspaceid	text	[pt] Identificador do espaço de trabalho ao qual o registro pertence. Workspaces > > id
description	text	[pt] Descrição do trabalho realizado no registro de tempo.
taskid	text	[pt] Identificador da tarefa associada ao registro de tempo, quando houver.
billable	boolean	[pt] Indica se o registro de tempo é faturável.
projectid	text	[pt] Identificador do projeto associado ao registro de tempo. Projects > > id
userid	text	[pt] Identificador do usuário que registrou o tempo. Users > > id

clockify_timeentries__tags

Tags do registro de tempo: relação entre um registro de tempo e as tags aplicadas a ele.

Campo	Tipo
timeentry_id	text	[pt] Identificador do registro de tempo ao qual a tag está associada.
tag_id	text	[pt] Identificador da tag aplicada ao registro de tempo. Tags > > id

Campo

Tipo

timeentry_id

text

[pt] Identificador do registro de tempo ao qual a tag está associada.

tag_id

text

[pt] Identificador da tag aplicada ao registro de tempo.

Tags > > id

Time entries [Integral]

Tipo de replicacao: Integral

Parametros:

Workspaces: Workspaces de onde os dados serão buscados. Deixe em branco para buscar todos workspaces

Relacionamentos:

workspaceid → Workspaces > id
projectid → Projects > id
userid → Users > id
tag_id > tags → Tags > id

Objeto principal

Registro de tempo do Clockify: lançamento de horas trabalhadas, com início, fim e duração, vinculado a usuário, projeto e, opcionalmente, tarefa.

Campo	Tipo
id	text	[pt] Identificador único do registro de tempo.
timeinterval__duration	text	[pt] Duração do registro de tempo no formato de duração ISO 8601 (ex.: PT25M).
timeinterval_start	timestamp	[pt] Data e hora de início do registro de tempo.
timeinterval_end	timestamp	[pt] Data e hora de término do registro de tempo.
islocked	boolean	[pt] Indica se o registro de tempo está bloqueado para edição.
workspaceid	text	[pt] Identificador do espaço de trabalho ao qual o registro pertence. Workspaces > > id
description	text	[pt] Descrição do trabalho realizado no registro de tempo.
taskid	text	[pt] Identificador da tarefa associada ao registro de tempo, quando houver.
billable	boolean	[pt] Indica se o registro de tempo é faturável.
projectid	text	[pt] Identificador do projeto associado ao registro de tempo. Projects > > id
userid	text	[pt] Identificador do usuário que registrou o tempo. Users > > id

clockify_timeentries__tags

Tags do registro de tempo: relação entre um registro de tempo e as tags aplicadas a ele.

Campo	Tipo
timeentry_id	text	[pt] Identificador do registro de tempo ao qual a tag está associada.
tag_id	text	[pt] Identificador da tag aplicada ao registro de tempo. Tags > > id

Campo

Tipo

timeentry_id

text

[pt] Identificador do registro de tempo ao qual a tag está associada.

tag_id

text

[pt] Identificador da tag aplicada ao registro de tempo.

Tags > > id

User groups

Tipo de replicacao: Integral

Parametros:

Workspaces: Workspaces de onde os dados serão buscados. Deixe em branco para buscar todos workspaces

Relacionamentos:

workspaceid → Workspaces > id

Grupo de usuários do Clockify: agrupamento de usuários dentro de um espaço de trabalho, usado para organizar equipes e permissões.

Campo	Tipo
id	text	[pt] Identificador único do grupo de usuários.
workspaceid	text	[pt] Identificador do espaço de trabalho ao qual o grupo pertence. Workspaces > > id
name	text	[pt] Nome do grupo de usuários.

Campo

Tipo

text

[pt] Identificador único do grupo de usuários.

workspaceid

text

[pt] Identificador do espaço de trabalho ao qual o grupo pertence.

Workspaces > > id

name

text

[pt] Nome do grupo de usuários.

Users

Tipo de replicacao: Integral

Parametros:

Workspaces: Workspaces de onde os dados serão buscados. Deixe em branco para buscar todos workspaces

Objeto principal

Usuário do Clockify: pessoa que faz parte do espaço de trabalho, com suas preferências e configurações pessoais.

Campo	Tipo
id	text	[pt] Identificador único do usuário.
status	text	[pt] Status do usuário no espaço de trabalho (ex.: ACTIVE, INACTIVE).
profilepicture	text	[pt] URL da foto de perfil do usuário.
name	text	[pt] Nome do usuário.
activeworkspace	text	[pt] Identificador do espaço de trabalho atualmente ativo para o usuário.
settings__timetrackingmanual	boolean	[pt] Indica se o usuário registra tempo manualmente em vez de usar o cronômetro.
settings__groupsimilarentriesdisabled	boolean	[pt] Indica se o agrupamento de registros de tempo semelhantes está desabilitado para o usuário.
settings__dashboardviewtype	text	[pt] Tipo de visão padrão do painel do usuário (ex.: PROJECT, TEAM).
settings__dateformat	text	[pt] Formato de data preferido do usuário (ex.: MM/DD/YYYY).
settings__weekstart	text	[pt] Dia em que começa a semana para o usuário (ex.: MONDAY).
settings__iscompactviewon	boolean	[pt] Indica se a visão compacta está ativada para o usuário.
settings__longrunning	boolean	[pt] Indica se o usuário é alertado sobre registros de tempo em andamento por muito tempo.
summaryreportsettingsgroup	text	[pt] Critério principal de agrupamento dos relatórios de resumo do usuário.
summaryreportsettingssubgroup	text	[pt] Critério secundário de agrupamento dos relatórios de resumo do usuário.
settings__dashboardpintotop	boolean	[pt] Indica se o painel é fixado no topo para o usuário.
settings__weeklyupdates	boolean	[pt] Indica se o usuário recebe atualizações semanais por e-mail.
settings__sendnewsletter	boolean	[pt] Indica se o usuário está inscrito na newsletter.
settings__mystartofday	text	[pt] Horário de início do dia configurado pelo usuário (ex.: 09:00).
settings__timeformat	text	[pt] Formato de hora preferido do usuário (ex.: HOUR12, HOUR24).
settings__timezone	text	[pt] Fuso horário do usuário (ex.: America/Sao_Paulo).
settings__dashboardselection	text	[pt] Escopo de dados exibido no painel (ex.: ME para o próprio usuário, TEAM para a equipe).
settings__projectlistcollapse	float	[pt] Quantidade de projetos a partir da qual a lista de projetos é recolhida.
settings__collapseallprojectlists	boolean	[pt] Indica se todas as listas de projetos são recolhidas por padrão.
defaultworkspace	text	[pt] Identificador do espaço de trabalho padrão do usuário.
email	text	[pt] E-mail do usuário.

clockify_users_memberships

Vínculos do usuário: associações do usuário a espaços de trabalho, projetos ou grupos, com status, tipo e taxas correspondentes.

Campo	Tipo
user_id	text	[pt] Identificador do usuário ao qual o vínculo pertence.
costrate	text	[pt] Taxa de custo associada ao vínculo do usuário.
targetid	text	[pt] Identificador do alvo do vínculo (espaço de trabalho, projeto ou grupo).
membershipstatus	text	[pt] Status do vínculo (ex.: ACTIVE, PENDING).
membershiptype	text	[pt] Tipo do vínculo, indicando o alvo (ex.: WORKSPACE, PROJECT).
hourlyrate_amount	float	[pt] Valor da taxa horária associada ao vínculo.
hourlyrate_currency	text	[pt] Moeda da taxa horária associada ao vínculo.

Workspaces

Tipo de replicacao: Integral

Espaço de trabalho do Clockify: unidade que agrupa projetos, clientes, usuários, tags e registros de tempo, com suas próprias configurações de rastreamento e permissões.

Campo	Tipo
id	text	[pt] Identificador único do espaço de trabalho.
canseetimesheet	boolean	[pt] Indica se a visão de planilha de horas (timesheet) está habilitada no espaço de trabalho.
automaticlock__firstday	text	[pt] Dia da semana em que começa o período de bloqueio automático de registros de tempo (ex.: MONDAY).
automaticlock__olderthanvalue	float	[pt] Quantidade de períodos usada na regra que bloqueia automaticamente registros mais antigos que esse valor.
automaticlock__changeday	text	[pt] Dia da semana em que o bloqueio automático passa a valer no modo semanal.
automaticlock__olderthanperiod	text	[pt] Unidade de tempo da regra de bloqueio por idade (ex.: DAYS, WEEKS).
automaticlock__type	text	[pt] Tipo de bloqueio automático de registros de tempo (ex.: WEEKLY, MONTHLY, OLDER_THAN).
automaticlock__dayofmonth	float	[pt] Dia do mês em que ocorre o bloqueio automático no modo mensal.
isprojectpublicbydefault	boolean	[pt] Indica se novos projetos são criados como públicos por padrão.
projectfavorites	boolean	[pt] Indica se o recurso de marcar projetos como favoritos está habilitado.
onlyadminscreatetag	boolean	[pt] Indica se apenas administradores podem criar tags no espaço de trabalho.
forcetags	boolean	[pt] Indica se informar ao menos uma tag é obrigatório ao registrar tempo.
onlyadminscreateproject	boolean	[pt] Indica se apenas administradores podem criar projetos.
tracktimedowntosecond	boolean	[pt] Indica se o rastreamento de tempo considera segundos.
timeroundinginreports	boolean	[pt] Indica se o arredondamento de tempo é aplicado nos relatórios.
hourlyrate__currency	text	[pt] Moeda da taxa horária padrão do espaço de trabalho (ex.: BRL, USD).
hourlyrate__amount	float	[pt] Valor da taxa horária padrão do espaço de trabalho.
timetrackingmode	text	[pt] Modo de rastreamento de tempo do espaço de trabalho (ex.: DEFAULT, STOPWATCH_ONLY).
onlyadminsseebillablerates	boolean	[pt] Indica se apenas administradores podem ver as taxas faturáveis.
onlyadminsseepublicprojectsentries	boolean	[pt] Indica se apenas administradores podem ver os registros de tempo de projetos públicos.
onlyadminscreatetask	boolean	[pt] Indica se apenas administradores podem criar tarefas.
projectpickerspecialfilter	boolean	[pt] Indica se o seletor de projetos usa filtro especial (ex.: filtrar por cliente).
forceprojects	boolean	[pt] Indica se selecionar um projeto é obrigatório ao registrar tempo.
canseetracker	boolean	[pt] Indica se os usuários podem ver o cronômetro (tracker) de tempo.
projectgroupinglabel	text	[pt] Rótulo usado para agrupar projetos no espaço de trabalho (ex.: client).
forcetasks	boolean	[pt] Indica se selecionar uma tarefa é obrigatório ao registrar tempo.
forcedescription	boolean	[pt] Indica se preencher a descrição é obrigatório ao registrar tempo.
defaultbillableprojects	boolean	[pt] Indica se novos projetos são marcados como faturáveis por padrão.
name	text	[pt] Nome do espaço de trabalho.
imageurl	text	[pt] URL da imagem ou logo do espaço de trabalho.
locktimeentries	timestamp	[pt] Data até a qual os registros de tempo estão bloqueados para edição.
onlyadminsseealltimeentries	boolean	[pt] Indica se apenas administradores podem ver os registros de tempo de todos os usuários.
onlyadminsseedashboard	boolean	[pt] Indica se apenas administradores podem ver o painel (dashboard).
round__minutes	float	[pt] Intervalo em minutos usado para arredondar a duração dos registros de tempo.
round__round	text	[pt] Direção do arredondamento da duração (ex.: arredondar para cima, para baixo ou para o mais próximo).
featuresubscriptiontype	text	[pt] Tipo de plano ou assinatura que determina os recursos disponíveis no espaço de trabalho (ex.: FREE, PREMIUM).

Notas

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

Integrar dados do Clockify via Kondado

Configure o conector do Clockify na Kondado para extrair registros de horas e enviá-los ao seu Data Warehouse ou Data Lake.

Obtenha a API key no Clockify

Faça login no Clockify com um usuário que tenha permissões WORKSPACE_OWN ou WORKSPACE_ADMIN. Acesse "Profile settings" pela imagem de perfil, vá até a seção API e clique em "Generate" para criar sua API key.

Adicione o conector na Kondado

Acesse a Kondado e vá para a seção de adicionar conectores. Selecione o conector do Clockify e cole a API key obtida no campo correspondente.

Configure e salve o conector

Dê um nome identificável ao seu conector, clique em SALVAR e escolha um destino (Data Warehouse ou Data Lake) para receber os dados de workspaces, projetos, usuários e time entries.

Monitore os dados integrados

Após a integração, utilize os dados no seu destino para análises. Caso precise de visualizações, explore as dashboards prontas ou ferramentas de BI conectadas à Kondado.

Perguntas frequentes

Quais permissões são necessárias no Clockify para integrar com a Kondado?▼

O usuário do Clockify precisa ter permissões de WORKSPACE_OWN ou WORKSPACE_ADMIN para os workspaces que deseja integrar. Sem esses privilégios, a API key gerada não terá acesso aos dados necessários.

O que acontece se um registro for excluído no Clockify?▼

Esta integração não captura deleções. Se um registro for excluído na ferramenta Clockify, ele continuará presente no seu destino até que a tabela sofra uma edição avançada. Por isso, disponibilizamos uma versão integral que sempre lê todos os dados.

Quais tabelas são disponibilizadas pela integração do Clockify?▼

O conector disponibiliza dados de Workspaces, Projects, Clients, Users (com memberships), User groups, Tags e Time entries (com tags associadas). Cada tabela contém campos específicos como IDs, timestamps, flags booleanas e valores monetários.

Posso enviar os dados do Clockify diretamente para uma planilha?▼

Sim, após configurar o conector, você pode direcionar os dados para diferentes destinos disponíveis na Kondado, incluindo opções para atualização de planilhas.

Como funciona a versão integral da integração?▼

A versão integral sempre lê todos os dados do Clockify, garantindo que seu destino reflita o estado completo da ferramenta. Isso é útil para compensar o fato de que a integração padrão não captura deleções de registros.

Escrito por

Thassyo Pereira·Publicado em 2021-03-04·Atualizado em 2026-06-01