Experimente nossa plataforma
Freshdesk

Adicionando a fonte de dados

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

Adicionando o conector

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

1) Faça login na sua conta do Freshdesk

Atenção: O usuário do Freshdesk utilizado deve ter permissões de Administrador

2) Clique na sua imagem de perfil no canto superior direito e depois em "Profile Settings"

3) Na barra lateral à direita, você encontrará sua chave de API

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

5) Na página de preenchimento dos dados do conector, faça o seguinte:

  • Em Domínio, cole a primeira parte da sua URL de acesso ao Freshdesk. Por exemplo, se a sua URL de acesso é https://empresa.freshdesk.com, utilize o valor empresa
  • Em API key, cole o valor obtido no passo (3)

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

Pipelines

Resumo

Diagrama de relacionamento

Clique para expandir

Agents

Tipo de replicacao: Integral

Agentes (usuários internos de suporte) da conta Freshdesk, um por linha. Inclui nome, email, telefone, idioma, fuso horário, escopo de permissão de tickets, disponibilidade para atribuição automática e os timestamps de criação, atualização e último login.

Campo Tipo

id

text

[en] User ID of the agent

available

boolean

[en] If the agent is in a group that has enabled Automatic Ticket Assignment, this attribute will be set to true if the agent is accepting new tickets

updated_at

timestamp

[en] Agent updated timestamp

available_since

timestamp

[en] Timestamp that denotes when the agent became available/unavailable (depending on the value of the 'available' attribute)

last_active_at

timestamp

ticket_scope

text

[en] Ticket permission of the agent (1 -> Global Access, 2 -> Group Access, 3 -> Restricted Access)

created_at

timestamp

[en] Agent creation timestamp

occasional

boolean

[en] Set to true if this is an occasional agent (true => occasional, false => full-time)

contact__updated_at

timestamp

[en] Timestamp of the last update

contact__phone

text

[en] Telephone number of the agent

contact__last_login_at

timestamp

[en] Timestamp of the agent's last successful login

contact__active

boolean

[en] Set to true if the agent is verified

contact__name

text

[en] Name of the agent

contact__language

text

[en] Language of the agent. Default language is en

contact__mobile

text

[en] Mobile number of the agent

contact__created_at

timestamp

[en] Creation timestamp

contact__time_zone

text

[en] Time zone of the agent

contact__email

text

[en] Email address of the agent

contact__job_title

text

[en] Job title of the agent

signature

text

[en] Signature of the agent in HTML format

type

text

Contacts

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data de atualização os registros serão lidos

Contatos (solicitantes/clientes finais) da conta Freshdesk, um por linha. Inclui nome, email, telefone, celular, cargo, idioma, fuso horário, empresa associada, descrição, identificadores de redes sociais e os timestamps de criação e atualização.

Campo Tipo

id

text

[en] ID of the contact

preferred_source

text

twitter_followers_count

text

description

text

[en] A short description of the contact

language

text

[en] Language of the contact

twitter_id

text

[en] Twitter handle of the contact

mobile

text

[en] Mobile number of the contact

name

text

[en] Name of the contact

created_at

timestamp

[en] Contact creation timestamp

facebook_id

text

company_id

text

[en] ID of the primary company to which this contact belongs

unique_external_id

text

[en] External ID of the contact

email

text

[en] Primary email address of the contact. If you want to associate additional email(s) with this contact, use the other_emails attribute

updated_at

timestamp

[en] Contact updated timestamp

phone

text

[en] Telephone number of the contact

time_zone

text

[en] Time zone in which the contact resides

twitter_profile_status

boolean

address

text

[en] Address of the contact

active

boolean

[en] Set to true if the contact has been verified

csat_rating

text

job_title

text

[en] Job title of the contact

Tickets

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data de atualização os registros serão lidos

Relacionamentos:

Objeto principal

Tickets de atendimento do helpdesk Freshdesk, um por linha. Inclui assunto, descrição, status, prioridade, canal de origem, solicitante, empresa, agente responsável e os timestamps do ciclo de vida (criação, primeira resposta, resolução, fechamento).

Campo Tipo

id

text

[pt] ID único do ticket

updated_at

timestamp

[pt] Timestamp de atualização do ticket

subject

text

[pt] Assunto do ticket

stats__reopened_at

timestamp

stats__resolved_at

timestamp

stats__first_responded_at

timestamp

stats__closed_at

timestamp

stats__status_updated_at

timestamp

stats__agent_responded_at

timestamp

stats__pending_since

timestamp

stats__requester_responded_at

timestamp

spam

boolean

[pt] TRUE se o ticket foi marcado como spam

due_by

timestamp

[pt] Timestamp que indica quando o ticket deve ser resolvido

responder_id

text

[pt] ID do agente para quem o ticket foi atribuído

    Agents > > id

priority

text

[pt] Prioridade do ticket

source

text

[pt] O canal por onde o ticket foi criado

type

text

[pt] Ajuda a categorizar o ticket de acordo com diferentes níveis de tarefas que o seu time lida

support_email

text

status

text

[pt] Status do ticket

is_escalated

boolean

[pt] Verdadeiro caso o ticket seja escalado por qualquer motivo

email_config_id

text

[pt] ID da configuração de e-mail (caixa de suporte/vendas) utilizada neste ticket.

company__id

text

[pt] ID da empresa à qual este ticket pertence

company__name

text

[pt] Nome da empresa à qual este ticket pertence

requester__mobile

text

[pt] Celular do solicitante

requester__email

text

[pt] Email do solicitante

requester__id

text

[pt] ID de usuário do solicitante

    Contacts > > id

requester__phone

text

[pt] Telefone do solicitante

requester__name

text

[pt] Nome do solicitante

product_id

text

[pt] ID do produto ao qual o ticket está associado

fr_due_by

timestamp

[pt] Timestamp que denota quando a primeira resposta'deve ser dada

fr_escalated

boolean

[pt] Verdadeiro se o ticket foi escalado como resultado de violação do tempo de primeira resposta

created_at

timestamp

[pt] Timestamp de criação do Ticket

group_id

text

[pt] ID do grupo para qual o ticket foi atribuído

description

text

[pt] Conteúdo HTML do ticket

description_text

text

[pt] Conteúdo do ticket em texto puro

freshdesk_tickets__tags

Tabela filha de freshdesk_tickets que detalha as tags associadas a cada ticket, uma linha por tag. Ligada ao ticket pai pela coluna ticket_id.

Campo Tipo

ticket_id

text

[pt] ID único do ticket

tag

text

[pt] Tag associada ao ticket

freshdesk_tickets__emails

Tabela filha de freshdesk_tickets que detalha os endereços de email vinculados a cada ticket, uma linha por email, com o tipo de envolvimento (cc, reply_cc, fwd, to). Ligada ao ticket pai pela coluna ticket_id.

Campo Tipo

ticket_id

text

[pt] ID único do ticket

email_type

text

[pt] Tipo de endereço de email associado com o ticket. Por exemplo: cc, reply_cc, to

email_address

text

[pt] Endereço de email de dado type para um dado ticket_id

Tickets: custom fields

Tipo de replicacao: Incremental

Parametros:

  • Data inicial de leitura (Savepoint): A partir de qual data de atualização os registros serão lidos

Relacionamentos:

Valores dos campos personalizados (custom fields) configurados na conta Freshdesk para os tickets, uma linha por ticket. Cada coluna corresponde a um campo personalizado definido pela empresa; relaciona-se a freshdesk_tickets pelo id.

Campo Tipo

id

text

[pt] ID único do ticket

    Tickets > > id

updated_at

timestamp

[pt] Timestamp de atualização do ticket

cf_custom_field_x

text

[pt] Exemplo de custom field x

cf_custom_field_y

text

[pt] Exemplo de custom field x

cf_custom_field_z

text

[pt] Exemplo de custom field x

Notas

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

Conectar Freshdesk à Kondado

Configure o conector do Freshdesk na Kondado para extrair dados de tickets, agents e contacts para seu Data Warehouse ou Data Lake.

1
Obtenha sua API key no Freshdesk

Faça login no Freshdesk com um usuário de permissão de Administrador. Clique na imagem de perfil no canto superior direito, acesse "Profile Settings" e copie a chave de API exibida na barra lateral à direita.

2
Configure o conector na Kondado

Acesse a página de conectores da Kondado, selecione o Freshdesk e preencha o domínio (primeira parte da URL, ex: "empresa" para empresa.freshdesk.com) e a API key obtida no passo anterior.

3
Salve e valide a conexão

Dê um nome ao conector e clique em SALVAR. A Kondado fará a extração dos dados de tickets, agents, contacts e custom fields para o destino configurado.

4
Explore os dados disponíveis

Utilize os dados extraídos — como status de tickets, tempos de resposta, prioridade e informações de agents — para montar análises de performance do helpdesk em sua ferramenta de BI ou Data Warehouse.

Perguntas frequentes

Quais permissões são necessárias no Freshdesk para configurar o conector?▼
O usuário do Freshdesk utilizado na configuração deve ter permissões de Administrador. Sem esse nível de acesso, não será possível obter a API key necessária para autenticação na Kondado.
Quais dados do Freshdesk são extraídos pela Kondado?▼
O conector extrai dados de Tickets (incluindo status, prioridade, tempos de resposta e custom fields), Agents (disponibilidade, escopo de tickets, informações de contato), Contacts (dados de solicitantes) e tabelas relacionadas como tags e e-mails dos tickets.
Como encontro o domínio correto para configurar o conector?▼
O domínio é a primeira parte da URL de acesso ao seu Freshdesk. Por exemplo, se sua URL é https://empresa.freshdesk.com, você deve utilizar apenas empresa no campo Domínio da configuração do conector.
Para quais destinos posso enviar os dados do Freshdesk?▼
Os dados extraídos do Freshdesk podem ser enviados para Data Warehouses, Data Lakes, planilhas ou ferramentas de BI. Consulte as opções de destinos disponíveis na Kondado para escolher o mais adequado à sua necessidade.
É possível visualizar dashboards prontos com os dados do Freshdesk?▼
Sim, você pode utilizar os dados do Freshdesk para criar visualizações. A Kondado oferece dashboards prontos e integrações com diversas ferramentas de BI para acelerar sua análise de métricas de helpdesk.
O que são os campos custom fields nos tickets do Freshdesk?▼
Os custom fields são campos personalizados configurados no seu Freshdesk para categorizar tickets de acordo com necessidades específicas do seu negócio. A Kondado extrai esses campos com o prefixo cf_ (ex: cf_custom_field_x) para que você possa incluí-los em suas análises.
Escrito por·Publicado em 2021-03-01·Atualizado em 2026-08-26