Skip to main content
Este guia cobre a configuração do conector Zendesk para desenvolvimento local. Para ativar o conector via Console strattum.ai, consulte o Quickstart de Data Pipelines.

​
Visão geral

O conector Zendesk extrai dados do Zendesk Support e os carrega na infraestrutura strattum.ai de forma incremental. A sincronização ocorre automaticamente a cada 15 minutos.

​
Pré-requisitos

Conta Zendesk ativa

Acesso a uma instância Zendesk Support com login funcional.

Perfil Agent ou Admin

O usuário associado ao token precisa ter perfil Agent ou Admin — perfis Light Agent não têm acesso à API.

​
Variáveis de ambiente

Adicione as variáveis abaixo ao arquivo .env (veja o guia de configuração local):
Nunca comite o arquivo .env no repositório. Certifique-se que ele está listado no .gitignore.

​
Como obter o API Token

1

Faça login no Zendesk

Acesse https://suaempresa.zendesk.com com um usuário com perfil Agent ou Admin.
2

Abra o Admin Center

Clique no ícone de engrenagem na barra lateral esquerda para abrir o Admin Center.
3

Navegue até Apps and Integrations → APIs → Zendesk API

No menu do Admin Center, acesse Apps and Integrations → APIs → Zendesk API.
4

Acesse a aba Settings

Na página da Zendesk API, clique na aba Settings.
5

Ative Token Access

Habilite a opção Token Access. Se já estiver ativa, pule esta etapa.
6

Crie o token

Clique em Add API token, dê um nome descritivo (ex: strattum-data) e confirme.
O token é exibido apenas uma vez. Copie-o agora e salve em local seguro antes de fechar a janela.
Após copiar o token, adicione-o ao .env e reinicie o worker se ele estiver em execução.

​
Dados extraídos

Os dados ingeridos ficam disponíveis no Data Catalog com linhagem registrada automaticamente — sem nenhuma configuração adicional.

​
Próximos passos

Guia de desenvolvimento local

Configure o ambiente local completo com Prefect, worker e Docker Compose.

Quickstart — Data Pipelines

Ative conectores via Console strattum.ai sem precisar de ambiente local.