> ## Documentation Index
> Fetch the complete documentation index at: https://docs.strattum.ai/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.

## 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:

> **Acesso ao Console**
>
> Conta ativa no strattum.ai com permissão de administrador no workspace.

> **Credenciais da fonte**
>
> Credenciais de leitura da fonte de dados que você quer conectar (usuário, senha ou API key).

***

## Passo a passo

**1. 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.

**2. 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:

> **PostgreSQL**
>
> Bancos relacionais PostgreSQL hospedados em qualquer ambiente — cloud ou on-premise.

> **Zendesk**
>
> Tickets, conversas e histórico de atendimento via Zendesk Support.

> [!NOTE]
>
> Mais conectores estão chegando: MySQL, HubSpot, Salesforce, Google Drive, Slack e outros. Consulte o [catálogo completo](https://docs.strattum.ai/data-pipelines/connectors) para ver o roadmap.

**3. 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.

**4. 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**.

**5. 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.

***

## 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:

> **[Data Catalog](https://docs.strattum.ai/data-catalog/overview.md)**
>
> Organize, governe e descubra todos os datasets ingeridos na infraestrutura do seu cliente.

> **[Memory](https://docs.strattum.ai/memory/overview.md)**
>
> Transforme os dados ingeridos em contexto estruturado sobre cada entidade — cliente, empresa, projeto.

> **[Catálogo de conectores](https://docs.strattum.ai/connectors/overview.md)**
>
> Veja todos os conectores disponíveis e em roadmap.

***

## Precisa de ajuda?

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.