Skip to main content

Como usar Tabelas de Dados — Estruture informações para consulta por agentes de IA

Updated today

As Tabelas de Dados (Datasets) são tabelas estruturadas acessíveis pelos agentes de IA em tempo real. Diferente das Listas (que referenciam contatos e empresas), uma Tabela de Dados armazena dados livres — como catálogos de produtos, tabelas de preços, políticas comerciais ou qualquer informação estruturada que a IA precisa consultar durante conversas com leads.


Disponível em: todos os planos.

Quem pode fazer: administradores e gestores com acesso ao módulo de Tabelas.

Módulo: Menu lateral > Tabelas

O que você precisa antes de começar

  • Ter acesso ao módulo de Tabelas no menu lateral

  • Saber quais dados a IA precisa consultar durante as conversas (ex: catálogo de produtos, tabela de preços, FAQ estruturado)

  • (Para importação) Ter um arquivo CSV ou Excel com os dados estruturados

Conceitos fundamentais

Conceito

O que é

Quando usar

Tabela de Dados (Dataset)

Tabela de dados livres, sem vínculo a contatos ou empresas

Para armazenar informações estruturadas consultáveis pela IA (produtos, preços, políticas)

Lista

Conjunto de referências a contatos ou empresas

Para organizar leads em grupos reutilizáveis para campanhas

Coluna

Campo da tabela com tipo definido (texto, número, data etc.)

Para estruturar os dados com campos bem definidos

Diferença entre Tabela de Dados e Lista

Característica

Tabela de Dados (Dataset)

Lista

Tipo de dado

Dados livres e estruturados

Referências a contatos ou empresas

Vínculo a registros

Não — dados independentes

Sim — cada linha referencia um contato ou empresa

Uso principal

Consulta pela IA durante conversas

Audiência de campanhas e segmentação

Tipo de objeto

Nenhum (livre)

Contato ou Empresa (obrigatório)

Integração com Campanhas

Não

Sim

Integração com Funis Inteligentes

Sim — como fonte de dados para a IA

Sim — como audiência

Criar uma Tabela de Dados

Criar manualmente

  1. No menu lateral, clique em Tabelas

  2. Clique em Nova tabela

  3. No menu dropdown, selecione Criar tabela manualmente

  4. Preencha:

    • Nome — nome descritivo da tabela (ex: "Catálogo de Produtos", "Tabela de Preços 2026")

    • Descrição — descreva o conteúdo e propósito da tabela. Essa descrição é usada pela IA para entender quando e como consultar a tabela

  5. Defina as colunas da tabela:

    • Nome da coluna — ex: "Produto", "Preço", "Categoria"

    • Tipo — escolha entre os tipos disponíveis:

Tipo

Descrição

Exemplo

Texto (String)

Texto livre

"Plano Enterprise"

Número (Number)

Valor numérico

4999.90

Data (Date)

Data

2026-06-01

Booleano (Boolean)

Verdadeiro/Falso

Sim, Não

E-mail

Endereço de e-mail

URL

Link

Moeda (Currency)

Valor monetário

R$ 1.500,00

  • Descrição da coluna — descreva o que a coluna armazena. A IA usa essa descrição para entender o significado dos dados

  1. Clique em Criar

💡 Dica: Invista tempo nas descrições da tabela e das colunas. Quanto mais claras forem, melhor a IA entenderá como consultar e apresentar os dados durante as conversas.

Importar via CSV/Excel

  1. No menu lateral, clique em Tabelas

  2. Clique em Nova tabela

  3. No menu dropdown, selecione Importar tabela (CSV/Excel)

  4. Faça upload do arquivo

  5. O sistema detectará as colunas e permitirá ajustar os tipos de dado

  6. Revise e confirme a importação

Importar dados via CSV/Excel

Para adicionar dados a uma Tabela de Dados existente, você pode importar um arquivo CSV ou Excel.

  1. Abra a tabela desejada

  2. Use a opção de importação para carregar o arquivo

  3. Mapeie as colunas do arquivo para as colunas da tabela

  4. Confirme a importação

O sistema processará os dados e adicionará as linhas à tabela. Durante o processamento, você pode acompanhar o status:

  • Processing — importação em andamento

  • Completed — importação concluída com sucesso

  • Failed — falha na importação

Editar dados na tabela

Após a criação, você pode editar os dados diretamente na interface:

  1. Abra a tabela no módulo Tabelas

  2. Clique em uma célula para editar o valor

  3. Digite o novo valor e pressione Enter para salvar

  4. Use Escape para cancelar a edição

Você também pode:

  • Adicionar linhas — clique no botão de adicionar linha na tabela

  • Remover linhas — selecione as linhas e use a opção de remoção

  • Reordenar colunas — arraste as colunas para a posição desejada

Conectar a Tabela de Dados a um Funil Inteligente

Para que a IA consulte a Tabela de Dados durante conversas, você precisa configurá-la como fonte de dados no Funil Inteligente.

  1. Acesse o módulo Funis Inteligentes

  2. Abra o funil onde quer adicionar a tabela

  3. Na configuração do agente, adicione a Tabela de Dados como ferramenta disponível

  4. Configure:

    • Tabela — selecione a tabela de dados

    • Descrição — descreva quando a IA deve consultar essa tabela (ex: "Consulte esta tabela quando o lead perguntar sobre preços ou planos disponíveis")

    • Colunas de saída — selecione quais colunas a IA pode retornar

    • Filtros — configure filtros opcionais para restringir os dados consultados

    • Limite — defina o número máximo de registros retornados por consulta (máx. 1.000)

Tipos de fonte para filtros

Fonte

Descrição

IA

A IA decide o valor do filtro baseado no contexto da conversa

Variável

Valor fixo predefinido

Contexto

Valor extraído do contexto da conversa (ex: dados do contato)

Operadores de filtro disponíveis

Operador

Significado

eq

Igual a

neq

Diferente de

gt

Maior que

gte

Maior ou igual a

lt

Menor que

lte

Menor ou igual a

contains

Contém o texto

in

Está na lista de valores

💡 Dica: Use o filtro com fonte IA para cenários dinâmicos. Por exemplo: se a tabela contém produtos e o lead pergunta "quanto custa o plano Pro?", a IA identificará automaticamente que precisa filtrar por "Plano Pro" na coluna de nome.

Limites e regras

Regra

Valor

Tipos de coluna

Texto, Número, Data, Booleano, E-mail, URL, Moeda

Máx. registros por consulta da IA

1.000

Tipo de objeto

Nenhum — Tabelas de Dados não referenciam contatos ou empresas

Uso em Campanhas

Não disponível — use Listas para audiência de campanhas

Uso em Funis Inteligentes

Sim — como fonte de dados consultável pela IA

Erros comuns e soluções

Problema

Causa provável

Solução

IA não consulta a tabela durante a conversa

Tabela não configurada como ferramenta no Funil Inteligente

Acesse o Funil Inteligente e adicione a tabela como fonte de dados

IA retorna dados incorretos ou desatualizados

Dados da tabela desatualizados

Atualize os dados na tabela. A IA consulta os dados em tempo real — se a tabela estiver atualizada, as respostas refletirão os dados corretos

Importação falhou

Formato do arquivo incompatível ou colunas não mapeadas

Verifique se o arquivo é CSV ou Excel válido e se as colunas estão corretamente mapeadas

Tabela não aparece na configuração do Funil Inteligente

Tabela criada como Lista em vez de Dataset

Verifique no módulo Tabelas se a tabela está com o tipo Dataset. Listas e Datasets são tipos diferentes

IA retorna muitos resultados irrelevantes

Filtros não configurados ou muito amplos

Configure filtros na integração com o Funil Inteligente para restringir os dados consultados

Perguntas frequentes

Qual a diferença entre uma Tabela de Dados e uma Lista?

Uma Lista referencia contatos ou empresas e é usada como audiência para campanhas. Uma Tabela de Dados (Dataset) armazena dados livres e estruturados (produtos, preços, políticas) que a IA pode consultar durante conversas. Use Listas para organizar leads e Tabelas de Dados para alimentar a IA com informações do negócio.

Posso usar uma Tabela de Dados como audiência de uma campanha?

Não. Apenas Listas (de contatos ou empresas) podem ser usadas como audiência de campanhas. Tabelas de Dados são exclusivas para consulta pela IA nos Funis Inteligentes.

A IA atualiza a Tabela de Dados automaticamente?

Não. A IA apenas consulta os dados — não os modifica. Para atualizar os dados, edite a tabela manualmente ou reimporte um arquivo atualizado.

Posso ter mais de uma Tabela de Dados conectada ao mesmo Funil Inteligente?

Sim. Você pode configurar múltiplas tabelas como fontes de dados no mesmo funil. A IA decidirá qual tabela consultar baseada no contexto da conversa e nas descrições que você configurou.

Como a IA sabe quando consultar a tabela?

A IA usa a descrição da tabela e das colunas para decidir quando uma consulta é relevante. Por isso, investir em descrições claras e específicas é fundamental. Por exemplo: "Consulte esta tabela quando o lead perguntar sobre preços, planos disponíveis ou funcionalidades incluídas em cada plano."

Posso filtrar os dados da tabela no módulo de Tabelas?

Sim. O módulo de Tabelas permite filtrar e visualizar os dados. Use o filtro por tipo (Todos os tipos, Dataset, Lista) para encontrar rapidamente suas Tabelas de Dados.

Posso converter uma Lista em uma Tabela de Dados (ou vice-versa)?

Não. Listas e Tabelas de Dados são tipos distintos com comportamentos diferentes. O tipo é definido no momento da criação e não pode ser alterado depois.

Quantas linhas uma Tabela de Dados pode ter?

Não há limite documentado para o número de linhas em uma Tabela de Dados. Porém, cada consulta da IA retorna no máximo 1.000 registros por vez. Para tabelas muito grandes, configure filtros para que a IA consulte apenas os dados relevantes.

As descrições das colunas são obrigatórias?

Não são obrigatórias tecnicamente, mas são altamente recomendadas. Sem descrições claras, a IA pode não entender o significado dos dados e retornar resultados imprecisos. Descreva cada coluna em linguagem natural, explicando o que ela armazena e quando é relevante.

Did this answer your question?