> For the complete documentation index, see [llms.txt](https://docs.chatlayer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/tables/create-a-table-with-records.md).

# Crie uma tabela com registros

{% hint style="info" %}
Alterações nas tabelas, como adicionar ou excluir uma tabela, serão aplicadas tanto aos ambientes ao vivo quanto aos de rascunho. No entanto, qualquer dado adicionado às tabelas será refletido apenas no ambiente em que os dados foram originalmente adicionados.

Se você quiser popular dados de um ambiente para outro, a melhor abordagem é exportar os dados do ambiente de origem e depois importá-los no ambiente de destino.
{% endhint %}

{% hint style="danger" %}
Observe que Tabelas não podem ser exportadas em[ exportação do bot](/chatlayer-documentation-pt-br/navegacao/settings/import-export.md) ainda.
{% endhint %}

\
Vamos imaginar um cenário em que um bot está ajudando os usuários a reservar sua aula favorita de yoga ou Zumba. Você quer usar a tabela para verificar a aula disponível e, em seguida, ajudar os clientes a reservar sua aula favorita. Siga estas etapas para começar a usar Tabela.

## Criar uma tabela

Para adicionar uma tabela às suas Tabelas:

1. Navegue até a **Tabelas** seção no menu principal.

<figure><img src="/files/86d2d80f47ee65ad2f8a5f505b66eeb781e1d1a1" alt="" width="122"><figcaption><p>Tabelas no menu lateral</p></figcaption></figure>

2. Clique no **+** botão no topo da tela.
3. Dê à tabela um nome descritivo e forneça uma breve explicação sobre sua finalidade. Neste exemplo, nossa tabela serve para armazenar informações sobre as datas, nomes e horários de um sistema de agendamento de aulas de yoga/Zumba.
4. Defina as colunas da sua tabela. Especifique o nome de cada coluna e selecione o [tipo de variável para sua coluna](/chatlayer-documentation-pt-br/navegacao/tables/column-types.md). Para este exemplo, teremos apenas colunas de texto para:
   * `nomeDaAula`
   * `classDay`
   * `classTime`
   * `professorDaAula`
   * `estáReservado`

<figure><img src="/files/fd42d406e0f01ef3bacdfa270526ff02aea65ed3" alt="" width="375"><figcaption><p>Crie uma tabela e adicione colunas a ela.</p></figcaption></figure>

5. Clique em **Criar**.

Saiba mais sobre os tipos de coluna no artigo dedicado 👇

{% content-ref url="/pages/71459e13998d458a0f03e1ef5c923a3643b99af0" %}
[Tipos de coluna](/chatlayer-documentation-pt-br/navegacao/tables/column-types.md)
{% endcontent-ref %}

Você criou uma tabela com sucesso! Por enquanto, ela ainda está vazia.

<figure><img src="/files/09f3293ebcebf12b618eaa590a17fe195475eddf" alt=""><figcaption><p>Tabela vazia criada.</p></figcaption></figure>

## Excluir uma tabela

1. Clique no botão de três pontos

<figure><img src="/files/9f41c4a263cae28de9b10ee029186bb955bc1ec7" alt="" width="375"><figcaption><p>Selecione excluir</p></figcaption></figure>

2. Selecione **Excluir**
3. Confirmar **Excluir**<br>

<figure><img src="/files/5d7eaa591aa9ddb6ceeeb071f3454592ac6a0495" alt=""><figcaption><p>Confirmação em modal antes de excluir uma tabela</p></figcaption></figure>

\
\
Vamos agora adicionar registros à tabela.

## Criar um novo registro

Um registro é uma linha de dados na sua tabela.

Para popular sua tabela com dados, você pode:

* [Inserir registro manualmente](#insert-record-manually).
* [Importar dados](#import-record) que já existem em outro lugar.

### Adicionar um novo registro manualmente

1. Na sua tabela, clique em **Inserir registro** no canto superior direito da sua tela.
2. Preencha o valor de cada coluna.

<figure><img src="/files/c5ec9d1271d27009a077daa12fbd3f2ee7285ca1" alt="" width="375"><figcaption><p>Insira um registro na sua tabela manualmente.</p></figcaption></figure>

3. Clique em **Adicionar**.

Agora você pode ver seu registro dentro da tabela!

<figure><img src="/files/3474edaadbe216ba76b060ed22645d82c6b65cff" alt=""><figcaption><p>Tabela preenchida com um registro.</p></figcaption></figure>

### Editar registro

1. Clique no botão de três pontos no lado esquerdo da tabela
2. Selecione **Editar**
3. Editar registros<br>

<figure><img src="/files/0c7247c7e739e711702039450d70d6ea9fe0655d" alt=""><figcaption><p>Editar registros</p></figcaption></figure>

4. Clique em **Salvar**

### Importar um registro

{% hint style="info" %}
Para importar mais de 100 registros, é recomendável usar uma API em vez da importação manual de dados. Encontre a documentação [aqui](/chatlayer-documentation-pt-br/navegacao/tables/api.md).
{% endhint %}

1. Na sua tabela, clique na seta ao lado do **Inserir registro** botão.
2. Selecione **Importar dados**.

<figure><img src="/files/7733a6730c77d82237e9762e470e3be564760af3" alt="" width="296"><figcaption><p>botão Importar dados</p></figcaption></figure>

3. Arraste e solte um arquivo CSV.
4. Se seus dados forem incompatíveis, você verá um alerta vermelho ao lado de **Pré-visualizar dados a serem importados**. Clique nesta seção.

<figure><img src="/files/edc7e326f4ed97ee4ce7e6a75054c706f892532b" alt="" width="375"><figcaption><p>Verifique se seus dados são válidos antes de importar registros para sua tabela.</p></figcaption></figure>

5. Os detalhes se expandem para que você possa revisar os problemas que precisam ser resolvidos. Neste exemplo, o problema é que temos algumas incompatibilidades nos cabeçalhos das colunas.

<figure><img src="/files/37787eb5efa183270293410f9029f64428a37b51" alt="" width="375"><figcaption><p>Revise os dados antes que eles sejam importados para sua tabela.</p></figcaption></figure>

6. Depois de identificar todos os problemas, vá para **Configurar dados de importação** para resolver esse&#x73;**.** Neste exemplo, como foi mencionado que algumas colunas não estão presentes na tabela, desmarque as colunas que não devem ser importadas.

{% hint style="info" %}
As colunas selecionadas em verde serão importadas, enquanto as brancas não serão importadas.
{% endhint %}

<figure><img src="/files/49d4b12370976b682e238c47bf650c043f39a064" alt="" width="375"><figcaption><p>Desmarcando colunas a serem importadas</p></figcaption></figure>

7. Depois de resolver os problemas, a **Dados incompatíveis** etiqueta desaparecerá, indicando que os dados agora estão prontos para importação.
8. Clique em **Importar** como a etapa final.

Sua tabela agora está preenchida com os dados que estavam no seu arquivo .csv!

<figure><img src="/files/4d9ec342b808e2d2ab9b6c3ee9b3bc88aaf119f2" alt=""><figcaption><p>Tabela preenchida com uma importação de CSV.</p></figcaption></figure>

***

{% hint style="success" %}
Procurando um template de bot rápido e fácil para brincar com Tabelas? O [bot Gym](/chatlayer-documentation-pt-br/comece-rapido/bot-templates/gym.md) é um caso de uso representativo.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.chatlayer.ai/chatlayer-documentation-pt-br/navegacao/tables/create-a-table-with-records.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.