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

O Brainchat tem uma **integração nativa** com o Pipefy. Você informa o token, escolhe a Database ou o Pipe e a tabela é criada com as colunas, os registros e a sincronização já configurados.

***

## Pré-requisitos

* Conta no [Pipefy](https://www.pipefy.com)
* Token de acesso pessoal do Pipefy (em Pipefy → Meu Perfil → Token de acesso pessoal)
* Acesso à Database ou ao Pipe que você quer importar

***

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

***

## Passo a passo

**1. Comece a conexão**

Em **Insights → Tabelas**, clique em **Nova Tabela → Conectar via API → Conectar ao Pipefy**.

**2. Token do Pipefy**

Escolha **Usar conexão existente**, **Usar chave do cofre** ou **Colar token novo**. O token fica em Pipefy → Meu Perfil → Token de acesso pessoal e é guardado criptografado no cofre do canal.

**3. Escolha o recurso**

Em **Tipo de recurso**, selecione **Database** ou **Pipe** e escolha qual. Dê o **Nome da tabela** (opcional).

**4. Opções**

* **Sincronizar comentários e e-mails**: cria mais duas tabelas ligadas ao card, com a conversa e os e-mails de cada registro.
* **Trazer também os pipes e bases conectados**: **Só o primeiro nível** ou **Seguir a trilha inteira**.

**5. Conectar**

Clique em **Conectar ao Pipefy**. A tabela é criada com as colunas do Pipefy e a primeira carga roda em segundo plano.

## 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 Studios e filtros.

***

## Sincronização

* A sincronização é **incremental**: busca só os registros alterados desde a última rodada (com alguns minutos de folga) e atualiza pelo ID do Pipefy, sem duplicar.
* Arquivos anexados nos cards são copiados para o Brainchat, então os links continuam funcionando depois que os do Pipefy expiram.
* Alterações feitas no Brainchat (na tabela, no Studio ou no Flow) são gravadas de volta no Pipefy.

Para acompanhar e ajustar, use **Sincronizar agora** e **Gerenciar tabela → Sincronização** (status, última execução, último erro e agenda). Em **Avançado**, **Re-sincronizar tudo (full reload)** recarrega todos os registros.

## 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 Studio.
> * Se o Pipe tem milhares de cards históricos, faça a primeira carga em horário de baixa atividade.

> [!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.

***

## Próximo passo

> [card] [Tabelas do Sistema](https://docs.brainchat.app/insights/tabelas/sistema.md)
>
> Conheça as tabelas virtuais que o Brainchat cria automaticamente para você.


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