Adicionando o conector
Requisitos
- Siga os passos com um acesso de Owner/Administrador
- Caso a sua conta do Zendesk tenha habilitado o bloqueio de IPs para acesso, libere também os IPs da Kondado
Instruções
- Entre na sua conta do zendesk com um acesso de Owner/Administrator
- Uma vez na sua conta, selecione na barra lateral esquerda o ícone da engrenagem (configurações), depois vá em Canais e depois API
- Em APIs, habilite o acesso por token e, depois, clique em adicionar novo
- Na página de edição do novo token, dê um nome para ele (por exemplo, integração Kondado), copie o valor gerado e clique em Salvar
- Na plataforma da Kondado, clique em CRIAR+> Conector > e selecione o conector do Zendesk
- Preencha as informações da imagem abaixo da seguinte forma

- Nome: o nome da sua integração, por exemplo, “Zendesk”
- E-mail (Owner) o e-mail do Owner da conta do Zendesk
- Token: O token gerado no passo (4)
- Sub-domínio: o seu subdomínio do zendesk. Por exemplo, se o seu endereço no zendesk é empresa.zendesk.com, o seu subdomínio é empresa
Caso a sua conta do Zendesk tenha habilitado o bloqueio de IPs para acesso, libere também os IPs da Kondado
Integrações
Índice
Gráfico de relacionamento
Clique para ampliar
Closed and Deleted Tickets
Tipo de replicacao: Incremental
Tickets excluídos do Zendesk com autor, status e datas.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador único do ticket. |
|
|
text |
[pt] Identificador do ator (agente ou usuário) que realizou a exclusão. |
|
|
text |
[pt] Nome exibido do ator que excluiu o ticket. |
|
|
timestamp |
[pt] Data e hora em que o ticket foi excluído. |
|
|
text |
[pt] Descrição ou conteúdo principal do ticket excluído. |
|
|
text |
[pt] Status do ticket antes da exclusão (ex.: solved, closed). |
|
|
text |
[pt] Assunto/título do ticket excluído. |
Comentários dos tickets
Tipo de replicacao: Incremental
Comentários dos tickets com informações de autor e criação.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do ticket ao qual o comentário pertence. |
|
|
text |
[pt] Identificador do comentário. |
|
|
text |
[pt] Identificador do usuário que escreveu o comentário. |
|
|
timestamp |
[pt] Quando o comentário foi criado. |
|
|
boolean |
[pt] Indica se o comentário é público. |
|
|
text |
[pt] Corpo do comentário em texto. |
Eventos das métricas dos tickets
Tipo de replicacao: Incremental
Histórico de eventos de métricas de SLA de tickets (aplicar, pausar, violar, atualizar status).
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador único do evento de métrica. |
|
|
boolean |
[pt] Disponível em eventos de violação; ignore quando verdadeiro. |
|
|
boolean |
[pt] Indica se o SLA de grupo usa horário comercial. |
|
|
text |
[pt] Descrição da política de SLA de grupo aplicada. |
|
|
text |
[pt] Título da política de SLA de grupo aplicada. |
|
|
text |
[pt] Para eventos apply_group_sla: ID da política de SLA de grupo aplicada. |
|
|
float |
[pt] Alvo de SLA de grupo aplicado (eventos apply_group_sla). |
|
|
text |
[pt] Número da instância do evento de métrica (incrementa por ticket). |
|
|
text |
[pt] Métrica rastreada (ex.: agent_work_time, reply_time, requester_wait_time). |
|
|
boolean |
||
|
text |
[pt] Descrição da política de SLA aplicada. |
|
|
text |
[pt] Título da política de SLA aplicada. |
|
|
text |
[pt] Disponível em eventos apply_sla: ID da política de SLA aplicada. |
|
|
float |
[pt] Alvo de SLA aplicado (eventos apply_sla). |
|
|
float |
[pt] Para eventos update_status: minutos em aberto em horário comercial. |
|
|
float |
[pt] Para eventos update_status: minutos em aberto em horas corridas. |
|
|
text |
[pt] Identificador do ticket associado. |
|
|
timestamp |
[pt] Timestamp em que o evento ocorreu. |
|
|
text |
[pt] Tipo do evento de métrica (activate, pause, fulfill, apply_sla, breach, update_status, measure). |
Grupos
Tipo de replicacao: Integral
Grupos do Zendesk com informações de status e associação.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador único do grupo. |
|
|
timestamp |
[pt] Quando o grupo foi atualizado pela última vez. |
|
|
boolean |
[pt] Indica se este é o grupo padrão da conta. |
|
|
text |
[pt] Nome do grupo. |
|
|
text |
[pt] URL do registro do grupo. |
|
|
timestamp |
[pt] Quando o grupo foi criado. |
|
|
boolean |
[pt] Indica se o grupo está marcado como excluído. |
|
|
text |
[pt] Descrição do grupo. |
Histórico dos tickets
Tipo de replicacao: Incremental
Objeto principal
Auditorias de alterações de tickets com metadados de canal e autor.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador único do evento de auditoria. |
|
|
text |
[pt] Identificador do ticket associado à auditoria. |
|
|
text |
[pt] Nome de destino capturado nos metadados do canal. |
|
|
text |
[pt] Endereço de destino capturado nos metadados do canal. |
|
|
text |
[pt] Receptores originais listados nos metadados do canal. |
|
|
text |
[pt] Nome da origem capturado nos metadados do canal. |
|
|
text |
[pt] Endereço de origem capturado nos metadados do canal. |
|
|
text |
[pt] Indicador de relação nos metadados de origem. |
|
|
text |
[pt] Canal pelo qual a ação auditada ocorreu. |
|
|
timestamp |
[pt] Quando o evento de auditoria foi criado. |
|
|
text |
[pt] Usuário que gerou o evento de auditoria. |
|
|
float |
[pt] Latitude registrada nos metadados do sistema, quando disponível. |
|
|
text |
[pt] User agent do cliente registrado nos metadados do sistema. |
|
|
text |
[pt] Endereço IP registrado nos metadados do sistema. |
|
|
text |
[pt] Localização derivada dos metadados do sistema. |
|
|
float |
[pt] Longitude registrada nos metadados do sistema, quando disponível. |
zendesk_ticket_audits__events
Eventos que compõem cada auditoria de ticket, incluindo tipo e conteúdo.
Links Jira
Tipo de replicacao: Integral
Vínculos entre tickets do Zendesk e issues do Jira.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do registro de vínculo. |
|
|
text |
[pt] ID do ticket relacionado no Zendesk. |
|
|
text |
[pt] ID da issue correspondente no Jira. |
|
|
text |
[pt] Chave da issue vinculada no Jira. |
|
|
text |
[pt] URL do registro de vínculo. |
|
|
timestamp |
[pt] Quando o vínculo foi criado. |
|
|
timestamp |
[pt] Quando o vínculo foi atualizado pela última vez. |
Marcas
Tipo de replicacao: Integral
Objeto principal
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] O identificador único da marca no Zendesk. |
|
|
boolean |
[pt] Especifica se a marca está atualmente ativa no Zendesk. |
|
|
text |
[pt] A URL pública da marca, normalmente usada pelos clientes para acessar o help center ou site de suporte. |
|
|
boolean |
[pt] Indica se esta marca está configurada como a marca padrão da conta Zendesk. |
|
|
boolean |
[pt] Indica se a marca possui um Help Center ativo. |
|
|
text |
[pt] O estado atual do Help Center da marca (ex.: habilitado, desabilitado). |
|
|
text |
[pt] O mapeamento de host personalizado (CNAME) usado para vincular o site de suporte da marca a um domínio customizado. |
|
|
boolean |
[pt] Especifica se a marca foi excluída do Zendesk. |
|
|
text |
[pt] O tipo MIME do arquivo do logotipo (ex.: image/png). |
|
|
text |
[pt] A URL direta onde a imagem do logotipo pode ser acessada. |
|
|
boolean |
[pt] Especifica se o arquivo do logotipo foi excluído. |
|
|
text |
[pt] O nome do arquivo da imagem do logotipo. |
|
|
float |
[pt] A altura da imagem do logotipo em pixels. |
|
|
text |
[pt] O identificador único do anexo do logotipo. |
|
|
boolean |
[pt] Indica se o logotipo deve ser exibido inline. |
|
|
text |
[pt] A URL mapeada da imagem do logotipo, geralmente igual à content_url. |
|
|
float |
[pt] O tamanho do arquivo do logotipo em bytes. |
|
|
text |
[pt] A URL do endpoint da API para recuperar os detalhes do anexo do logotipo da marca. |
|
|
float |
[pt] A largura da imagem do logotipo em pixels. |
|
|
text |
[pt] O nome da marca (ex.: Torra). |
|
|
text |
[pt] O subdomínio do Zendesk associado à marca. |
|
|
text |
[pt] A URL do endpoint da API para recuperar os detalhes da marca no Zendesk. |
|
|
text |
||
|
text |
||
|
timestamp |
||
|
timestamp |
zendesk_brands_logo_thumbnails
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] O identificador único da marca no Zendesk. |
|
|
text |
[pt] O identificador único do anexo da miniatura do logotipo. |
|
|
text |
[pt] O tipo MIME do arquivo da miniatura (ex.: image/png). |
|
|
text |
[pt] A URL direta onde a imagem em miniatura pode ser acessada. |
|
|
boolean |
[pt] Especifica se o arquivo da miniatura foi excluído. |
|
|
text |
[pt] O nome do arquivo da imagem em miniatura. |
|
|
float |
[pt] A altura da imagem em miniatura em pixels. |
|
|
boolean |
[pt] Indica se a miniatura deve ser exibida inline. |
|
|
text |
[pt] A URL mapeada da imagem em miniatura, geralmente igual à content_url. |
|
|
float |
[pt] O tamanho do arquivo da imagem em miniatura em bytes. |
|
|
text |
[pt] A URL do endpoint da API para recuperar uma versão em miniatura do logotipo. |
|
|
float |
[pt] A largura da imagem em miniatura em pixels. |
Métricas dos tickets
Tipo de replicacao: Incremental
Métricas de tickets do Zendesk Chat com tempos de espera, respostas e reaberturas.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador do ticket associado. |
|
|
text |
[pt] Identificador do registro de métricas do ticket. |
|
|
timestamp |
[pt] Quando o registro de métricas foi atualizado pela última vez. |
|
|
timestamp |
[pt] Quando o ticket foi resolvido. |
|
|
int |
[pt] Quantidade de respostas públicas adicionadas por agentes. |
|
|
float |
[pt] Minutos até a resolução total (horas corridas). |
|
|
float |
[pt] Minutos até a resolução total (horário comercial). |
|
|
float |
[pt] Minutos em espera em horas corridas. |
|
|
float |
[pt] Minutos em espera em horário comercial. |
|
|
timestamp |
[pt] Quando o status do ticket foi atualizado pela última vez. |
|
|
float |
[pt] Quantidade de responsáveis diferentes que o ticket teve. |
|
|
timestamp |
[pt] Quando o solicitante atualizou o ticket pela última vez. |
|
|
timestamp |
[pt] Quando o ticket foi atribuído pela primeira vez. |
|
|
float |
[pt] Quantidade de grupos pelos quais o ticket passou. |
|
|
float |
[pt] Minutos até a primeira resolução (horas corridas). |
|
|
float |
[pt] Minutos até a primeira resolução (horário comercial). |
|
|
timestamp |
[pt] Quando o ticket foi atribuído. |
|
|
timestamp |
[pt] Quando o comentário mais recente foi adicionado. |
|
|
float |
[pt] Minutos até a primeira resposta (horas corridas). |
|
|
float |
[pt] Minutos até a primeira resposta (horário comercial). |
|
|
text |
[pt] URL do registro de métricas do ticket. |
|
|
timestamp |
[pt] Quando o registro de métricas foi criado. |
|
|
timestamp |
[pt] Quando o responsável atualizou o ticket pela última vez. |
|
|
float |
[pt] Quantidade de vezes que o ticket foi reaberto. |
|
|
float |
[pt] Minutos de espera do solicitante (horas corridas). |
|
|
float |
[pt] Minutos de espera do solicitante (horário comercial). |
|
|
float |
[pt] Minutos de espera do agente (horas corridas). |
|
|
float |
[pt] Minutos de espera do agente (horário comercial). |
Organizações
Tipo de replicacao: Integral
Organizações do Zendesk com domínios, configurações de compartilhamento, campos personalizados e datas.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador único da organização. |
|
|
boolean |
[pt] Permite que usuários da organização vejam comentários de outros em tickets. |
|
|
timestamp |
[pt] Quando a organização foi atualizada pela última vez. |
|
|
text |
[pt] Domínios de e-mail vinculados à organização. |
|
|
boolean |
[pt] Permite que usuários da organização vejam os tickets uns dos outros. |
|
|
text |
[pt] Nome único da organização. |
|
|
text |
[pt] URL do registro da organização. |
|
|
text |
[pt] Campos personalizados armazenados para a organização. |
|
|
timestamp |
[pt] Quando a organização foi criada. |
|
|
text |
[pt] Tags associadas à organização. |
|
|
text |
[pt] Detalhes adicionais sobre a organização (ex.: endereço). |
|
|
text |
[pt] Grupo atribuído automaticamente a novos tickets desta organização. |
|
|
text |
[pt] ID externo para vincular a organização a outro sistema (não diferencia maiúsculas/minúsculas). |
|
|
text |
[pt] Anotações internas sobre a organização. |
Pesquisas de satisfação (notas)
Tipo de replicacao: Incremental
Avaliações de satisfação de tickets, com solicitante, responsável e datas.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador único da avaliação de satisfação. |
|
|
text |
[pt] Comentário enviado com a avaliação, quando disponível. |
|
|
text |
[pt] Agente atribuído no momento da avaliação. |
|
|
text |
[pt] Valor da avaliação (offered, unoffered, good, bad). |
|
|
text |
[pt] Identificador do ticket avaliado. |
|
|
text |
[pt] Solicitante que enviou a avaliação. |
|
|
text |
[pt] URL do registro da avaliação. |
|
|
timestamp |
[pt] Quando a avaliação de satisfação foi criada. |
|
|
text |
[pt] Grupo atribuído ao ticket no momento da avaliação. |
|
|
timestamp |
[pt] Quando a avaliação de satisfação foi atualizada pela última vez. |
Tickets
Tipo de replicacao: Incremental
Objeto principal
Tickets do Zendesk com detalhes da requisição, roteamento e vínculos.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador único do ticket. |
|
|
text |
[pt] Status do ticket (new, open, pending, hold, solved, closed). |
|
|
text |
[pt] Identificadores dos agentes que seguem o ticket. |
|
|
text |
[pt] Nome do destino nos metadados da origem do ticket. |
|
|
text |
[pt] Endereço de destino nos metadados da origem do ticket. |
|
|
text |
[pt] Nome da origem capturado para o ticket. |
|
|
text |
[pt] Endereço de origem capturado para o ticket. |
|
|
text |
[pt] Indicador de relação nos metadados da origem do ticket. |
|
|
text |
[pt] Canal pelo qual o ticket foi criado. |
|
|
text |
[pt] Primeiro comentário/conteúdo do ticket (somente leitura). |
|
|
text |
[pt] Tags aplicadas ao ticket. |
|
|
text |
[pt] Para tickets do tipo incidente, ID do ticket de problema relacionado. |
|
|
boolean |
[pt] Indica se o channelback é permitido para este ticket. |
|
|
timestamp |
[pt] Quando o ticket foi atualizado pela última vez. |
|
|
text |
[pt] Usuário que submeteu o ticket (autor do primeiro comentário). |
|
|
text |
[pt] Agente atualmente atribuído ao ticket. |
|
|
text |
[pt] Identificador da marca vinculada a este ticket. |
|
|
timestamp |
[pt] Data/hora de vencimento para tickets do tipo tarefa. |
|
|
text |
[pt] Avaliação de satisfação ou estado (oferecida/não oferecida), quando disponível. |
|
|
boolean |
[pt] Verdadeiro quando o ticket tem comentários públicos. |
|
|
text |
[pt] Usuário que solicitou o ticket. |
|
|
text |
[pt] Tópico do fórum de origem do ticket (quando aplicável). |
|
|
text |
[pt] Endereço do destinatário original usado para notificações. |
|
|
text |
[pt] Título/assunto do ticket. |
|
|
text |
[pt] Organização vinculada ao solicitante. |
|
|
text |
[pt] URL do registro do ticket. |
|
|
text |
[pt] Tipo do ticket (problem, incident, question, task). |
|
|
timestamp |
[pt] Quando o ticket foi criado. |
|
|
text |
[pt] Identificadores de acordos de compartilhamento aplicados ao ticket. |
|
|
boolean |
[pt] Indica se agentes podem adicionar anexos aos comentários. |
|
|
text |
[pt] IDs de follow-ups criados a partir deste ticket (visíveis após o fechamento). |
|
|
text |
[pt] Identificadores dos usuários atualmente em cópia no ticket. |
|
|
text |
[pt] Nível de prioridade (urgent, high, normal, low). |
|
|
text |
[pt] Placeholder de conteúdo dinâmico para o assunto, ou o próprio texto do assunto. |
|
|
text |
[pt] IDs de agentes ou usuários finais atualmente em cópia no ticket. |
|
|
boolean |
[pt] Indica se um ticket do tipo problema possui incidentes vinculados. |
|
|
text |
[pt] Grupo ao qual o ticket está atribuído. |
|
|
text |
[pt] Identificador externo para vincular o ticket a outro sistema. |
zendesk_tickets__fields
Valores de campos personalizados detalhados por ticket.
Usuários
Tipo de replicacao: Incremental
Usuários do Zendesk com dados de perfil, função e acesso.
| Campo | Tipo | |
|---|---|---|
|
text |
[pt] Identificador único do usuário. |
|
|
text |
[pt] Tags atribuídas ao usuário quando a marcação está habilitada. |
|
|
text |
[pt] Idioma/região configurados para o usuário. |
|
|
boolean |
[pt] Indica se o agente é compartilhado de outra instância do Zendesk (compartilhamento de tickets). |
|
|
timestamp |
[pt] Quando o cadastro do usuário foi atualizado pela última vez. |
|
|
boolean |
[pt] Indica se o agente possui restrições (falso para admins/agentes sem restrições). |
|
|
text |
[pt] Identificador da organização do usuário. |
|
|
text |
[pt] Telefone principal do usuário. |
|
|
text |
[pt] ID de função personalizada para agentes em planos Enterprise ou superiores. |
|
|
timestamp |
[pt] Data/hora do último acesso autenticado do usuário. |
|
|
text |
[pt] Tipo numérico de função (0 agente custom, 1 agente light, 2 agente de chat, 3 colaborador de chat, 4 admin, 5 admin financeiro). |
|
|
text |
[pt] Identificador do grupo padrão do usuário. |
|
|
boolean |
[pt] Indica se o usuário está suspenso; usuários suspensos não podem acessar. |
|
|
boolean |
[pt] Permite acesso a relatórios CSV na área de relatórios (apenas planos com esse recurso). |
|
|
boolean |
[pt] Indica se o usuário está ativo (não excluído). |
|
|
boolean |
[pt] Indica se a autenticação em duas etapas está habilitada. |
|
|
text |
[pt] Anotações internas armazenadas sobre o usuário. |
|
|
text |
[pt] Fuso horário IANA definido para o usuário. |
|
|
boolean |
[pt] Indica se o usuário pode moderar fóruns. |
|
|
boolean |
[pt] Indica se alguma identidade do usuário está verificada. |
|
|
text |
[pt] Nome completo do usuário. |
|
|
boolean |
[pt] Se verdadeiro, o usuário só pode criar comentários privados. |
|
|
text |
[pt] URL para o registro do usuário. |
|
|
timestamp |
[pt] Quando o cadastro do usuário foi criado. |
|
|
text |
[pt] Fuso horário configurado para o usuário. |
|
|
text |
[pt] Indica se o número de telefone é compartilhado. |
|
|
text |
[pt] Nome alternativo exibido para usuários finais. |
|
|
text |
[pt] Rótulo de função do usuário (end-user, agent, admin). |
|
|
text |
[pt] Detalhes adicionais armazenados sobre o usuário (ex.: endereço). |
|
|
text |
[pt] Assinatura configurada para o usuário (somente agentes/admins). |
|
|
boolean |
[pt] Indica se o usuário é compartilhado de outra instância (compartilhamento de tickets). |
|
|
text |
[pt] Identificador externo de outro sistema (sensível a maiúsculas/minúsculas). |
|
|
text |
[pt] E-mail principal do usuário. |
|
|
boolean |
[pt] Indica se o usuário é um agente apenas de chat. |
|
|
text |
[pt] Escopo de acesso aos tickets (organization, groups, assigned, requested ou null). |
Notas
- Parte desta documentacao foi gerada automaticamente por IA e pode conter erros. Recomendamos verificar informacoes críticas

