Gerenciando registros
- Como adicionar, editar e excluir registros de um Tipo Personalizado
- Como filtrar e pesquisar registros
- Como a edição da definição do tipo afeta registros existentes
Depois de criar um Tipo Personalizado (veja Criando um Tipo Personalizado), gerenciar os registros funciona como nas entidades nativas.
Onde encontrar os registros
Tipos Personalizados → nome do tipo no menu lateral abre a página de listagem daquele tipo. Cada Tipo Personalizado ganha sua própria entrada no menu assim que é criado.
A partir da lista de Tipos Personalizados, clique em qualquer linha para ir direto aos registros daquele tipo.
Adicionando um registro
- Na página de listagem, clique no botão + no canto superior direito (a dica de ferramenta mostra "Add new ct:seu-slug").
- Preencha o formulário. Campos com asterisco são obrigatórios.
- Clique em Salvar.
O novo registro aparece na lista e já fica disponível para o resto do AutoTalk (API, agentes de IA, Workflows).
Editando um registro
- Clique no botão de lápis da linha (ou use clique direito / toque longo na linha) para abrir o formulário de edição.
- Clique em Salvar para persistir as alterações.
Clicar em uma linha abre uma visão Detalhes somente leitura; a edição acontece pelas ações da linha, não por essa visão.
A edição faz merge nas alterações — campos que você não mexeu mantêm o valor anterior.
Excluindo um registro
- Use as ações da linha para clicar em Excluir e confirme.
- A exclusão é lógica (tombstone): o registro some das listas, mas não é removido imediatamente. Uma rotina diária de retenção remove permanentemente os registros tombstoned após 30 dias.
Filtros e busca
- Use o botão Filtrar na página de listagem para refinar os resultados por qualquer campo. A ordenação é configurada no mesmo diálogo de Filtro — não há ordenação por clique no cabeçalho da coluna.
- A caixa de busca rápida pesquisa automaticamente nos primeiros campos de Texto do tipo (até 6) — se o tipo não tiver campos de texto, a caixa de busca fica oculta. Isso é separado dos caminhos indexados definidos ao criar o tipo, que aceleram a filtragem.
Operações em lote
- Abra o menu Ações na página de listagem e escolha Atualização em massa ou Exclusão em massa. Ambas se aplicam a todos os registros que atendem às condições definidas — não há seleção por linha.
Editando a definição do tipo
Você pode voltar a Tipos Personalizados e editar a definição a qualquer momento.
Edições seguras
- Adicionar um novo campo (ele fica opcional a menos que você marque como obrigatório)
- Acrescentar novos valores permitidos em um campo Seleção
- Afrouxar restrições (ex.: subir o
maxLength) - Mudar o Nome ou Descrição do tipo
Os registros existentes continuam válidos e editáveis.
Edições arriscadas
Estas podem deixar registros existentes inválidos. Cuidado:
- Renomear um campo — os registros antigos continuam guardando o valor com o nome antigo, então você perde acesso até migrar.
- Tornar um campo obrigatório quando antes não era — registros sem esse campo vão falhar a validação na próxima gravação.
- Encolher uma restrição de campo (ex.: baixar o
maxLength) — registros acima do novo limite vão falhar ao salvar. - Mudar o tipo de um campo — trate como um rename. Migre os dados antes.
Se precisar renomear um campo ou mudar o tipo, considere adicionar um novo campo ao lado do antigo, migrar os dados pela interface ou pela API e só então remover o antigo.
Controle de acesso
- Por padrão, qualquer funcionário da empresa pode ler e escrever registros de um Tipo Personalizado.
- Donos podem restringir quem pode ler, criar, atualizar ou excluir os registros de cada tipo por função na página Acesso a tipos em Empresa → Equipe — veja Funções e Permissões.
- Apenas donos criam ou editam a definição do tipo.
- Registros nunca vazam entre empresas — a ACL é aplicada em cada leitura e escrita.
Próximos passos
- Usando com MCP — deixar agentes de IA lerem e escreverem os registros
- Tokens de API — chamar o Tipo Personalizado a partir de sistemas externos