Actualizado el Aug 4, 2026

Gestionando registros

Qué vas a aprender

• Cómo agregar, editar y eliminar registros de un Tipo Personalizado
• Cómo filtrar y buscar registros
• Cómo la edición de la definición afecta a los registros existentes

Una vez que creaste un Tipo Personalizado (ver Creando un Tipo Personalizado), gestionar sus registros funciona como con las entidades nativas.

Dónde encontrar los registros

Tipos Personalizados → nombre del tipo en el menú lateral abre la página de listado de ese tipo. Cada Tipo Personalizado obtiene su propia entrada en el menú una vez creado.

Desde la lista de Tipos Personalizados, haz clic en cualquier fila para ir directo a los registros de ese tipo.

Agregar un registro

1. En la página de listado, haz clic en el botón + en la esquina superior derecha (su tooltip dice "Add new ct:tu-slug").
2. Completa el formulario. Los campos con asterisco son requeridos.
3. Haz clic en Guardar.

El nuevo registro aparece en la lista y ya está disponible para el resto de AutoTalk (API, agentes de IA, Workflows).

Editar un registro

• Haz clic en el botón de lápiz de la fila (o usa clic derecho / pulsación larga en la fila) para abrir el formulario de edición.
• Haz clic en Guardar para persistir tus cambios.

Hacer clic en una fila abre una vista Detalles de solo lectura; la edición ocurre desde las acciones de la fila, no desde esa vista.

La edición hace merge de tus cambios — los campos que no tocaste conservan su valor anterior.

Eliminar un registro

• Usa las acciones de la fila para hacer clic en Eliminar y confirma.
• La eliminación es lógica (tombstone): el registro desaparece de las listas pero no se borra de inmediato. Una rutina diaria de retención elimina permanentemente los registros tombstoned después de 30 días.

Filtros y búsqueda

• Usa el botón Filtrar en la página de listado para refinar resultados por cualquier campo. El orden se configura en el mismo diálogo de Filtro — no hay orden por clic en la cabecera de la columna.
• El cuadro de búsqueda rápida busca automáticamente en los primeros campos de Texto del tipo (hasta 6) — si el tipo no tiene campos de texto, el cuadro de búsqueda se oculta. Esto es distinto de los paths indexados que defines al crear el tipo, que aceleran el filtrado.

Operaciones en lote

• Abre el menú Acciones en la página de listado y elige Actualización masiva o Eliminación masiva. Ambas se aplican a todos los registros que cumplan las condiciones que definas — no hay selección por fila.

Editando la definición del tipo

Puedes volver a Tipos Personalizados y editar la definición en cualquier momento.

Ediciones seguras

• Agregar un campo nuevo (queda opcional a menos que lo marques como requerido)
• Sumar nuevos valores permitidos a un campo Selección
• Aflojar restricciones (ej.: subir el maxLength)
• Cambiar el Nombre o Descripción del tipo

Los registros existentes siguen siendo válidos y editables.

Ediciones riesgosas

Estas pueden dejar registros existentes inválidos. Ten cuidado:

• Renombrar un campo — los registros antiguos siguen guardando el valor bajo el nombre viejo, así que pierdes acceso hasta migrar.
• Hacer un campo requerido cuando antes no lo era — los registros sin ese campo fallarán la validación al guardar.
• Achicar una restricción (ej.: bajar el maxLength) — los registros que excedan el nuevo límite fallarán al guardar.
• Cambiar el tipo de un campo — trátalo como un rename. Migra los datos primero.

tip

Si necesitas renombrar un campo o cambiar el tipo, considera agregar un campo nuevo junto al viejo, migrar los datos desde la interfaz o la API y recién después eliminar el viejo.

Control de acceso

• Por defecto, cualquier empleado de la empresa puede leer y escribir registros de un Tipo Personalizado.
• Los dueños pueden restringir quién puede leer, crear, actualizar o eliminar los registros de cada tipo por rol desde la página Acceso por tipo, en Empresa → Equipo — consulta Roles y Permisos.
• Solo los dueños crean o editan la definición del tipo.
• Los registros nunca se filtran entre empresas — la ACL se aplica en cada lectura y escritura.

Próximos pasos

• Usando con MCP — dejar que los agentes de IA lean y escriban los registros
• Tokens de API — llamar al Tipo Personalizado desde sistemas externos