Creando un Tipo Personalizado
- Cómo abrir el constructor de Tipos Personalizados
- Qué hace cada campo del formulario de definición
- Cómo agregar campos, elegir tipos y definir reglas de validación
Crear un Tipo Personalizado es un proceso en dos etapas: primero defines la plantilla (qué campos tendrán los registros) y después tú y tu equipo pueden agregar registros usando esa plantilla.
Paso 1 — Abrir la página de Tipos Personalizados
- En el menú lateral de AutoTalk, haz clic en Tipos Personalizados. Verás la lista de tipos que tu empresa ya definió (vacía en una cuenta nueva).
- Haz clic en el botón + en la esquina superior derecha (su tooltip muestra "Add new custom_types").
Paso 2 — Llenar los campos superiores
| Campo | Descripción |
|---|---|
| Slug | Identificador único del tipo, como leads o helpdesk_tickets. Debe empezar con una letra minúscula, seguida de letras minúsculas, dígitos y guiones bajos; de 3 a 41 caracteres. Los slugs que coinciden con colecciones integradas de AutoTalk (contacts, messages, support_tickets, …) están reservados y serán rechazados. El slug no se puede cambiar después, así que elige con cuidado. Forma parte de cada URL y llamada a la API para este tipo. |
| Nombre | Etiqueta legible que aparece en los menús y títulos de página (ej.: "Leads"). Se puede cambiar en cualquier momento. |
| Descripción | Resumen de una oración que se muestra en los listados. Opcional. |
| Propósito | Párrafo más largo explicando para qué sirve el tipo. Muy útil cuando los agentes de IA deciden si leer o escribir en tu tipo — trátalo como una nota de traspaso a un colega. Opcional pero recomendado. |
Paso 3 — Agregar campos
La sección Campos es donde describes la forma de cada registro. Haz clic en "+ Agregar campo" para crear una fila nueva.
Cada campo tiene:
- Nombre — la clave usada en el registro (ej.:
email,status,priority). Usa camelCase o snake_case de forma consistente. - Tipo — el tipo de dato que guarda el campo:
- Texto — strings cortos o largos
- Número — enteros o decimales, con min/max opcionales
- Booleano — casilla true/false
- Fecha — día del calendario (sin hora)
- Fecha y hora — día del calendario con hora/minuto
- Selección (enum) — lista desplegable; lista los valores permitidos, uno por línea
- Lista — una lista de ítems repetidos
- Referencia — enlace a otro registro (un Contacto, un Empleado u otro Tipo Personalizado)
- Ubicación — un punto geográfico
- JSON — objeto JSON libre para casos avanzados
- Imagen — una imagen subida
- Archivo — un archivo subido (imagen, video, audio o documento)
- Requerido — si el usuario tiene que llenarlo antes de guardar
- Descripción — texto de ayuda que aparece en el formulario
Opciones por tipo
- Texto — define un tamaño máximo para limitar strings grandes (ej.:
maxLength: 256). - Número — define límites min y max.
- Selección — lista los valores permitidos, uno por línea, en el campo Valores permitidos. Por ejemplo:
new
contacted
qualified
won
lost - Referencia — indica el tipo de destino. Usa un nombre nativo como
contactsoemployees, u otro Tipo Personalizado con el prefijoct:— ej.:ct:leads. - Imagen / Archivo — opcionalmente restringe la subida con Archivos aceptados (MIME) (ej.:
image/*) y Tamaño máximo (bytes). Para los campos Archivo, elige el Tipo de archivo (imagen, video, audio o documento). Un campo de tipo Array cuyos ítems sean Imagen o Archivo se muestra como una galería de subida.
Reordenar y eliminar
Cada fila tiene las flechas ↑ y ↓ para cambiar la posición (esto controla el orden de los campos en el formulario), más los botones Editar y Eliminar.
Paso 4 — Pestañas y secciones (opcional)
Para tipos con muchos campos, agrúpalos en Pestañas y Secciones para mantener el formulario legible.
- Una pestaña es una agrupación superior (ej.: "General", "Facturación", "Notas").
- Una sección es un grupo colapsable dentro de una pestaña (ej.: dentro de "General" puedes tener una sección "Contacto" y otra "Puntuación").
Agrégalas en los campos de Pestañas / Secciones. Para asignar un campo a una pestaña o sección, edita el JSON cel de ese campo y define cel: { tab: "general", section: "scoring" } — no hay un selector visual para esto en el editor de campos.
Paso 5 — Rutas indexadas (opcional, por rendimiento)
Si tu equipo va a filtrar por el mismo campo con frecuencia (ej.: buscar leads siempre por email o status), agrega el nombre de ese campo en Rutas indexadas. Hasta 5 por tipo. Esto acelera las búsquedas cuando la colección pasa de miles de registros.
Paso 6 — Consejos para MCP (opcional)
Si planeas dejar que agentes de IA o clientes MCP externos lean/escriban en este tipo, agrega uno o dos consejos cortos en Consejos para MCP. El LLM los verá junto con la definición del tipo. Ejemplo: "Siempre completa status al crear un lead."
Paso 7 — Guardar
Haz clic en Guardar. El tipo aparece en el menú dentro de Tipos Personalizados y tu equipo ya puede empezar a agregar registros.
Empieza con una lista mínima de campos. Puedes agregar más después editando la definición, y los registros existentes se mantienen intactos. Eliminar o renombrar campos es más complicado — planifica lo esencial desde el inicio.
Qué pasa después de guardar
- AutoTalk crea la página de listado en Tipos Personalizados → nombre del tipo.
- El tipo queda expuesto en la API en
/v1/dynadata/type/ct:<slug>/{list,create,update,...}(POST) para cualquier integración que tú o un agente construyan. - El servidor MCP descubre automáticamente el nuevo tipo para que los agentes de IA lean y escriban registros.
Próximos pasos
- Gestionando registros — agregar, editar, filtrar y eliminar registros
- Usando con MCP — entregando el tipo a un agente de IA