> ## Documentation Index
> Fetch the complete documentation index at: https://strattumai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart — Data Pipelines

> Conecte sua primeira fonte de dados e comece a ingerir dados na plataforma strattum.ai em minutos.

<Note>
  **Data Pipelines** é a fundação da plataforma strattum.ai. Sem pipelines confiáveis, não existe contexto — e sem contexto, seus agentes operam no escuro.
</Note>

## O que você vai fazer

Em menos de 10 minutos você vai:

1. Conectar uma fonte de dados (PostgreSQL ou Zendesk)
2. Configurar sua primeira pipeline de ingestão
3. Verificar que os dados chegaram limpos e estruturados

***

## Pré-requisitos

Antes de começar, certifique-se que você tem:

<CardGroup cols={2}>
  <Card title="Acesso ao Console" icon="browser">
    Conta ativa no strattum.ai com permissão de administrador no workspace.
  </Card>

  <Card title="Credenciais da fonte" icon="key">
    Credenciais de leitura da fonte de dados que você quer conectar (usuário, senha ou API key).
  </Card>
</CardGroup>

***

## Passo a passo

<Steps>
  <Step title="Acesse a seção Data Pipelines">
    No Console strattum.ai, clique em **Data Engineering** no menu lateral esquerdo e selecione **Data Pipelines**.

    Você verá a lista de conectores disponíveis e o status das pipelines ativas.
  </Step>

  <Step title="Adicione um novo conector">
    Clique em **+ New Connector** no canto superior direito.

    Selecione a fonte de dados que deseja conectar. Os conectores atualmente disponíveis são:

    <CardGroup cols={2}>
      <Card title="PostgreSQL" icon="database">
        Bancos relacionais PostgreSQL hospedados em qualquer ambiente — cloud ou on-premise.
      </Card>

      <Card title="Zendesk" icon="headset">
        Tickets, conversas e histórico de atendimento via Zendesk Support.
      </Card>
    </CardGroup>

    <Note>
      Mais conectores estão chegando: MySQL, HubSpot, Salesforce, Google Drive, Slack e outros. Consulte o [catálogo completo](/data-pipelines/connectors) para ver o roadmap.
    </Note>
  </Step>

  <Step title="Configure a conexão">
    Preencha as credenciais da sua fonte. Cada conector tem campos específicos:

    **PostgreSQL**

    ```
    Host:     seu-host.rds.amazonaws.com
    Port:     5432
    Database: nome_do_banco
    User:     usuario_readonly
    Password: ••••••••
    ```

    **Zendesk**

    ```
    Subdomain: suaempresa   (suaempresa.zendesk.com)
    Email:     admin@suaempresa.com
    API Token: ••••••••••••••••••••••••
    ```

    Clique em **Test Connection** para validar as credenciais antes de salvar.
  </Step>

  <Step title="Selecione os dados a ingerir">
    Após conectar, escolha quais tabelas ou objetos você quer trazer:

    * **PostgreSQL:** selecione schemas e tabelas específicas ou use a opção *sync all*
    * **Zendesk:** selecione entre tickets, users, organizations, comments e satisfaction ratings

    Configure a frequência de sincronização: **tempo real**, **a cada hora** ou **diária**.
  </Step>

  <Step title="Ative a pipeline">
    Clique em **Activate Pipeline** para iniciar a primeira ingestão.

    Você pode acompanhar o progresso em tempo real no painel de status. A primeira carga (full sync) pode levar alguns minutos dependendo do volume de dados.

    <Tip>
      Quando a pipeline estiver ativa, os dados chegam automaticamente ao **Data Catalog** com linhagem e ownership registrados — sem nenhuma configuração adicional.
    </Tip>
  </Step>
</Steps>

***

## Verificando a ingestão

Após a primeira sincronização, acesse **Data Catalog** para confirmar que os dados chegaram:

* Cada tabela ou objeto ingerido aparece como um dataset catalogado
* Metadados de linhagem são registrados automaticamente (fonte, frequência, timestamp do último sync)
* O status de saúde da pipeline fica visível em **Observability → Pipelines**

***

## Próximos passos

Com sua primeira pipeline ativa, você está pronto para estruturar contexto:

<CardGroup cols={3}>
  <Card title="Data Catalog" icon="folder-open" href="/data-catalog/overview">
    Organize, governe e descubra todos os datasets ingeridos na infraestrutura do seu cliente.
  </Card>

  <Card title="Memory" icon="brain" href="/memory/overview">
    Transforme os dados ingeridos em contexto estruturado sobre cada entidade — cliente, empresa, projeto.
  </Card>

  <Card title="Catálogo de conectores" icon="plug" href="/connectors/overview">
    Veja todos os conectores disponíveis e em roadmap.
  </Card>
</CardGroup>

***

## Precisa de ajuda?

Se encontrar algum problema durante a configuração, consulte o guia de [troubleshooting de conectores](/data-pipelines/troubleshooting) ou entre em contato com o time strattum.ai.