FormFlow
FormFlow
Sistema inteligente de captura dinâmica de dados estruturados a partir de conversas
O FormFlow captura dados estruturados de conversas, armazena valores por escopo e disponibiliza essas informações para decisões.
Conceitos fundamentais
- Variável (
form_variables): campo tipado para capturar um dado (ex: email, telefone, nome) - Formulário (
form_catalog): agrupa variáveis em um schema JSON para captura coordenada - Valor (
form_items_values): estado corrente de uma variável capturada para um lead ou conversa - Resposta (
form_responses): percentual de completude de um formulário para um lead/conversa - Escopo: define onde o valor é armazenado —
lead,conversation,globalouform
Base URL
https://api.tolky.to/api/externalAPIs/public/formFlow
Endpoints de leitura usam POST (filtros via JSON). Mutações usam PUT.
Autenticação
Authorization: Bearer {TOKEN}
O hostId é derivado do token. Para multi-host, envie hostId no body.
Endpoints disponíveis
Consultas
- Buscar campos — retorna variáveis disponíveis para o host
- Buscar catálogos — lista formulários cadastrados
- Schema de um catálogo — schema JSON completo de um formulário
- Buscar valores capturados — valores atuais de leads especificados
- Schema de captura para conversa — campos pendentes de captura em uma conversa
Mutações
- Criar variável — registra um novo campo tipado
- Criar catálogo — cria um formulário com variáveis associadas
- Atualizar variável — modifica uma variável existente
- Atualizar catálogo — modifica um formulário existente
Captura com IA
- Capturar a partir de conversas — extrai dados estruturados de conversas usando LLM
CRUD Conversacional
- Gerar plano de etapas — planeja ações via linguagem natural
- Retomar execução — recupera planos e resultados anteriores
- Referência de ações — ações disponíveis e referências dinâmicas
Tempo real
- WebSocket — eventos de captura, valores e respostas em tempo real
Raciocínio guiado
- Sequential Thinking — uso do MCP de raciocínio sequencial com o FormFlow