Skip to main content

​
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
  • 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?

​
Como descobrir o ID do recurso

Abra o recurso no Pipefy e veja a URL:

​
Passo a passo

1

Iniciar conexão

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

Escolher o tipo

Selecione Database ou Pipe.
3

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
4

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

​
Schema importado automaticamente

​
Database

​
Pipe

Inclui tudo do Database mais:
Os campos customizados (record_fields ou fields) são expandidos como colunas individuais para facilitar uso em dashboards e filtros.

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

​
Boas práticas

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

Tabelas do Sistema

Conheça as tabelas virtuais que o Brainchat cria automaticamente para você.