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

# Sincronizar com Pipefy

> Integração nativa entre Brainchat e Pipefy — importe Databases e Pipes em poucos cliques.

# Sincronizar com Pipefy

O Brainchat tem uma **integração nativa** com o Pipefy. Você informa o token da sua conta e o ID do recurso, e a tabela é criada automaticamente — schema, primeiros registros e sincronização incremental, tudo configurado.

***

## Pré-requisitos

* Conta no [Pipefy](https://www.pipefy.com)
* **Token de API pessoal** (obtenha em **Pipefy → Configurações → Tokens de API pessoais**)
* ID do recurso que você quer importar (Database ou Pipe)

***

## Database vs Pipe — qual escolher?

| Tipo         | O que é                                            | Quando usar                                          |
| ------------ | -------------------------------------------------- | ---------------------------------------------------- |
| **Database** | Lista flexível de registros (similar a uma tabela) | Catálogos, listas de referência, registros sem fluxo |
| **Pipe**     | Cards organizados em fases (workflow)              | Processos com etapas: vendas, RH, suporte, contratos |

***

## Como descobrir o ID do recurso

Abra o recurso no Pipefy e veja a URL:

| Recurso      | URL                                            | ID                             |
| ------------ | ---------------------------------------------- | ------------------------------ |
| **Database** | `https://app.pipefy.com/apollo_databases/<ID>` | trecho final (ex: `301234567`) |
| **Pipe**     | `https://app.pipefy.com/pipes/<ID>`            | trecho final (ex: `301234567`) |

***

## Passo a passo

<Steps>
  <Step title="Iniciar conexão">
    Em **Tabelas**, clique em **Nova Tabela → Conectar via API → Conectar ao Pipefy**.
  </Step>

  <Step title="Escolher o tipo">
    Selecione **Database** ou **Pipe**.
  </Step>

  <Step title="Informar token e ID">
    * **Token de API pessoal** — cole o token do Pipefy
    * **ID do recurso** — Database ID ou Pipe ID
    * **Nome da tabela** — como ela aparecerá no Brainchat
  </Step>

  <Step title="Conectar">
    Clique em **Conectar**. O Brainchat:

    1. Valida o token
    2. Cria a tabela com schema automático
    3. Configura sincronização incremental por `updated_at`
    4. Roda a primeira carga em background
  </Step>
</Steps>

***

## Schema importado automaticamente

### Database

| Campo                      | Origem                                   |
| -------------------------- | ---------------------------------------- |
| `id`                       | ID do registro no Pipefy                 |
| `title`                    | Título do registro                       |
| `created_at`, `updated_at` | Datas de criação e atualização           |
| `finished_at`              | Data de conclusão (se aplicável)         |
| `due_date`                 | Data de vencimento                       |
| `done`                     | Booleano de conclusão                    |
| `created_by`               | Nome e e-mail de quem criou              |
| `record_fields`            | Todos os campos customizados do registro |

### Pipe

Inclui tudo do Database **mais**:

| Campo                      | Origem                             |
| -------------------------- | ---------------------------------- |
| `current_phase`            | Nome da fase atual do card         |
| `started_current_phase_at` | Quando o card entrou na fase atual |
| `late`                     | Booleano: o card está atrasado?    |
| `age`                      | Idade total do card (segundos)     |
| `current_phase_age`        | Tempo na fase atual (segundos)     |
| `assignees`                | Lista de responsáveis              |
| `labels`                   | Etiquetas aplicadas                |
| `fields`                   | Campos do formulário do Pipe       |

<Tip>
  Os campos customizados (`record_fields` ou `fields`) são expandidos como colunas individuais para facilitar uso em dashboards e filtros.
</Tip>

***

## Sincronização incremental

A integração usa **modo incremental** por padrão:

* Filtra `updated_at >= última_sync - 10min`
* Carrega apenas os registros modificados
* Atualiza pelos IDs do Pipefy (não duplica)

Isso reduz drasticamente o número de chamadas à API do Pipefy.

***

## Manutenção da sincronização

Após criada, a sync pode ser administrada em **Configurar sync**:

| Ação                     | O que faz                                                                |
| ------------------------ | ------------------------------------------------------------------------ |
| **Otimizar query**       | Atualiza a query GraphQL para a versão mais recente da integração        |
| **Executar backfill**    | Recarrega todos os registros desde o início (útil após mudanças no Pipe) |
| **Retomar sync parcial** | Continua de onde parou em caso de interrupção                            |
| **Pausar/Reativar**      | Liga ou desliga a sincronização automática                               |
| **Trocar token**         | Atualize o token sem recriar a tabela                                    |

***

## Boas práticas

<Tip>
  * Use **Database** para dados de referência (catálogos, listas) que o Agente de IA precisa consultar.
  * Use **Pipe** quando precisa monitorar o status atual dos cards num dashboard.
  * Se o Pipe tem milhares de cards históricos, faça um backfill inicial em horário de baixa atividade.
</Tip>

<Warning>
  Mantenha o **token do Pipefy** seguro. Ele dá acesso a todos os Pipes da sua conta. Use um token dedicado para cada integração quando possível.
</Warning>

***

## Próximo passo

<Card title="Tabelas do Sistema" icon="database" href="/dados/tabelas-sistema">
  Conheça as tabelas virtuais que o Brainchat cria automaticamente para você.
</Card>