---
title: "Capturar dados"
description: Configure uma tabela para que seu agente salve dados como nome, e-mail ou telefone durante as conversas.
---

Um agente pode salvar dados estruturados da conversa —por exemplo, o nome e o e-mail de um visitante interessado— em uma tabela do seu workspace. Ativar a captura dá ao agente uma ferramenta para registrar esses dados em todas as conversas.

:::note[Antes de começar]
Você precisa do papel de editor ou administrador no workspace e acesso ao recurso Data store. Se não vir a aba **Data store**, peça acesso a um administrador da sua organização.
:::

## Ativar a captura em uma tabela

1. **Abra o agente**

    Abra **Agentes** no menu lateral e entre no agente que você quer configurar.

2. **Escolha a tabela**

    Vá para a aba **Data store** e escolha a tabela onde os dados serão salvos.

3. **Abra a captura de dados**

    Na tabela, clique em **Captura de dados**.

4. **Ative a captura**

    Ative **Capturar dados das conversas**.

5. **Defina quando registrar**

    Em **Quando registrar**, descreva quando o agente deve salvar dados: por exemplo, "quando o visitante quer ser contatado ou pede um orçamento".

6. **Escolha um registro por**

    Em **Um registro por**, escolha **Conversa** para um registro por conversa, ou uma coluna (como o e-mail) para que contatos repetidos atualizem o mesmo registro sem sobrescrever os dados já preenchidos.

7. **Defina quando estiver completo**

    Em **Completa**, defina quando um registro fica completo. Por padrão, basta ter e-mail ou telefone; você também pode escolher colunas específicas.

8. **Descreva as colunas**

    Em **Colunas**, indique o que cada coluna contém (e-mail, telefone, nome, empresa ou URL) para que o agente valide e normalize os valores.

9. **Ative os avisos**

    Deixe **Avisar os administradores** ativado se quiser que o workspace receba uma notificação quando um registro ficar completo.

10. **Salve a configuração**

    Clique em **Salvar**.

:::tip
No chat de teste e no link de teste, o agente valida os dados mas não os salva. Para testar de verdade, converse com o agente publicado em um canal.
:::

## Retenção opcional

Você pode pedir que registros antigos sejam excluídos automaticamente depois de uma quantidade de dias.

1. **Ative a retenção (opcional)**

    No diálogo **Captura de dados**, ative **Excluir automaticamente registros antigos (opcional)**.

2. **Defina os dias de retenção**

    Em **Retenção em dias (1–3650, dias inteiros)**, digite por quantos dias os registros ficam guardados a partir da data de criação.

3. **Salve a retenção**

    Clique em **Salvar**.

Se você ativar a retenção ou reduzir o prazo, o TukiAssistant pede confirmação, porque a próxima limpeza também pode excluir registros existentes que já tenham passado desse prazo. Revise **Excluir registros antigos existentes?** e confirme com **Confirmar retenção e exclusão**.

A retenção conta a partir da data de criação de cada registro (editá-lo não a renova), fica desativada por padrão e continua funcionando mesmo se você desativar depois a captura de novos dados. Para pará-la, desative-a e salve novamente.

## Próximos passos


**[Revisar e administrar os dados capturados](/pt/conversations/manage-captured-data)**

Consulte, filtre, exporte e exclua os registros que seus agentes salvaram durante as conversas.

**[Receber os dados capturados em um webhook](/pt/conversations/capture-webhook)**

Configure um endereço HTTPS para receber cada registro capturado quando ficar completo.