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? 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
Iniciar conexão
Em Tabelas , clique em Nova Tabela → Conectar via API → Conectar ao Pipefy .
Escolher o tipo
Selecione Database ou Pipe .
Informar token e ID
Token de API pessoal — cole o token do PipefyID do recurso — Database ID ou Pipe IDNome da tabela — como ela aparecerá no Brainchat
Conectar
Clique em Conectar . O Brainchat:
Valida o token
Cria a tabela com schema automático
Configura sincronização incremental por updated_at
Roda a primeira carga em background
Schema importado automaticamente Database Campo Origem idID do registro no Pipefy titleTítulo do registro created_at, updated_atDatas de criação e atualização finished_atData de conclusão (se aplicável) due_dateData de vencimento doneBooleano de conclusão created_byNome e e-mail de quem criou record_fieldsTodos os campos customizados do registro
Pipe Inclui tudo do Database mais :
Campo Origem current_phaseNome da fase atual do card started_current_phase_atQuando o card entrou na fase atual lateBooleano: o card está atrasado? ageIdade total do card (segundos) current_phase_ageTempo na fase atual (segundos) assigneesLista de responsáveis labelsEtiquetas aplicadas fieldsCampos do formulário do Pipe
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 :
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
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ê.
