Campos personalizados en CRM, API, chat y MCP - Relaticle         

Campos personalizados que funcionan en todas partes sin código por campo
========================================================================

Cómo Relaticle hace que los campos personalizados estén disponibles en formularios, API, chat y MCP, con normalización compartida, semántica clara de valores vacíos y límites explícitos.

 Manuk Minasyan · 22 de septiembre de 2026 · 12 min de lectura

 ![Campos personalizados que funcionan en todas partes sin código por campo](https://relaticle.com/storage/ink/01M7T4K1A46GQZWMVA6VMW0NH0.png) 

Creamos los atributos personalizados para usarlos en la aplicación web, la API REST, Rela, el asistente de IA integrado, y las herramientas MCP. Basta con definir el atributo en Relaticle, sin un despliegue ni código de integración por atributo. La clave no es una integración distinta para cada superficie. Es una sola ruta de escritura que acepta `custom_fields`, valida los valores con la definición vigente del espacio de trabajo y los guarda junto con el registro. Eso parece corriente hasta que un agente necesita etiquetas en lugar de ID de opciones. Un consumidor de la API necesita valores tipados. Además, un valor vacío debe significar algo distinto de una clave omitida.

El resultado es un contrato deliberadamente pequeño. Usted define el campo en la interfaz. Lo envía junto con los demás atributos escribibles del registro. La aplicación hace el resto. Esta entrada explica el mecanismo y un límite de permisos. Desactivar un campo bloquea las escrituras, pero no oculta su existencia al chat. No hay controles de visibilidad por superficie.

[](#una-definición-cuatro-superficies "Permalink")Una definición, cuatro superficies
------------------------------------------------------------------------------------

Los atributos personalizados no son una carga adicional que cada integración deba interpretar por su cuenta. El modelo del registro es responsable del comportamiento mediante `UsesCustomFields`. El trait incorpora `custom_fields` a los atributos escribibles y guarda los valores cuando se guarda el registro. Las acciones pasan `custom_fields` tal cual. No extraen campos individuales ni tratan sus nombres como casos especiales.

Esa decisión hace que el comportamiento de las superficies sea aburrido en el buen sentido. Un campo sigue al registro por la misma ruta de acción cuando una persona edita un formulario o un cliente de la API envía una actualización. Lo mismo ocurre cuando un asistente propone un cambio o una herramienta MCP escribe el valor. Por eso, un campo agregado desde la interfaz queda disponible de inmediato en la API y en el chat. No hay despliegue. Ningún desarrollador agrega una rama condicional para ese campo.

| Superficie | Qué recibe |
|---|---|
| Formulario de la aplicación web | La entrada del campo como parte de la edición del registro |
| API REST | `custom_fields` junto con los atributos nativos |
| Rela | Códigos de campo y etiquetas de opciones en el esquema de sus herramientas |
| Herramientas MCP | La misma superficie de escritura de registros |

| Superficie | Qué aporta la ruta compartida |
|---|---|
| Formulario de la aplicación web | Un valor de atributo personalizado guardado al guardar |
| API REST | Validación dinámica y la ruta de escritura normal |
| Rela | Traducción de etiquetas, validación y una propuesta de aprobación |
| Herramientas MCP | Atributos personalizados disponibles sin cambiar las herramientas por campo |

La diferencia importa porque las alternativas fallan de forma previsible. Un esquema de API estático queda obsoleto en cuanto un espacio de trabajo define un campo. Una herramienta de IA a medida para cada campo convierte la configuración en trabajo de despliegue. Una ruta de persistencia aparte puede hacer que un campo funcione en una pantalla y desaparezca sin avisar en otra. Pusimos el comportamiento común del modelo en el centro y mantuvimos al mínimo la lógica específica de cada superficie.

[](#el-conjunto-de-campos-va-más-allá-de-un-cuadro-de-texto "Permalink")El conjunto de campos va más allá de un cuadro de texto
-------------------------------------------------------------------------------------------------------------------------------

Relaticle ofrece campos de texto, número, moneda, fecha, selección, contacto, editor enriquecido y vínculo a registros. FileUpload y MarkdownEditor son tipos retirados. Use RichEditor para contenido con formato y adjuntos compatibles.

Esta lista explica por qué un simple mapa de cadenas no bastaría. Una selección necesita opciones. Una selección múltiple necesita más de una opción. Una fecha y una moneda tienen requisitos distintos de validación y presentación. La implementación debe conservar esas diferencias sin obligar a cada llamador a conocer los detalles de cada tipo.

El trait del modelo ofrece el punto de integración para la persistencia. La solicitud REST y el esquema del chat ofrecen puntos de integración que tienen en cuenta los tipos de datos. Así hay un único lugar donde se define qué valores son válidos, y cada superficie sigue pudiendo presentarlos en la forma con la que trabaja su usuario.

![El constructor de atributos personalizados con atributos de oportunidad definidos por el usuario junto a atributos del sistema](https://relaticle.com/storage/ink/01M0YZS17J66XVASD4PG1S4H7P.png)

Para ver la lista completa de campos y la ayuda de configuración, consulte [la referencia de tipos de atributos personalizados](https://relaticle.com/es/help/custom-fields/field-types-you-can-add).

[](#la-validación-rest-se-arma-con-el-esquema-vigente "Permalink")La validación REST se arma con el esquema vigente
-------------------------------------------------------------------------------------------------------------------

La API REST no puede tratar los atributos personalizados como metadatos sin verificar. Cada solicitud de creación y de actualización incorpora de forma dinámica las reglas de validación de atributos personalizados del espacio de trabajo. Por eso, un atributo personalizado se valida y se escribe como un atributo nativo, aunque su definición no existiera cuando se desplegó el código de la API.

Esta es la dirección importante de la dependencia. La solicitud no trae su propia idea de qué campos existen. La aplicación lee la definición vigente del campo y luego amplía la validación antes de aceptar la escritura. Un campo nuevo está disponible porque la definición son datos, no porque haya cambiado una ruta.

La capa de respuesta tampoco entrega a los clientes un detalle de implementación. Los valores de selección y de selección múltiple se devuelven como objetos `{id, label}` y no como ID de opciones sin procesar. El ID identifica la opción. La etiqueta da sentido al valor en la respuesta al cliente. Devolver ambos evita que un cliente de la API tenga que inventar una segunda consulta solo para mostrar una opción guardada.

Eso hace que la API REST sea útil para integraciones que necesitan un contrato de escritura estable. Estas no quieren una capa de correspondencia aparte para el esquema de cada espacio de trabajo. También da a la API y a la aplicación web el mismo límite de validación. No tenemos que decidir si un atributo personalizado es un "campo de la API" o un "campo del formulario". Es un campo del registro.

La [documentación de la API REST](https://relaticle.com/developers/api) es el lugar donde empezar cuando un sistema externo necesita leer o escribir estos registros.

[](#el-chat-necesita-un-puente-de-etiquetas "Permalink")El chat necesita un puente de etiquetas
-----------------------------------------------------------------------------------------------

Rela no recibe una referencia estática para desarrolladores de la que deba deducir el resto. Recibe un esquema construido con los campos activos del espacio de trabajo. Un servicio descriptor del esquema inserta los códigos de campo y las etiquetas de opciones en el esquema de herramientas que ve el modelo.

Esa formulación es intencional. Un modelo debe ver la etiqueta que usa una persona, en lugar de tener que inventar o recordar un ID de opción. Puede formar una solicitud con el código del campo y una etiqueta de opción. En el momento de la validación, una capa de traducción convierte la etiqueta en el ID de opción que espera la persistencia.

| Paso del chat | Representación |
|---|---|
| Descripción del esquema | Códigos de campo y etiquetas de opciones |
| Validación | Etiquetas traducidas a ID de opciones |
| Tarjeta de propuesta | Diferencia entre el valor anterior y el nuevo según el tipo de campo |

| Paso del chat | Motivo |
|---|---|
| Descripción del esquema | El modelo puede usar el vocabulario del espacio de trabajo |
| Validación | El valor guardado coincide con la opción configurada |
| Tarjeta de propuesta | Una persona puede revisar el cambio previsto |

El último paso forma parte del contrato del producto y no es una vista previa cosmética. Las escrituras del chat se convierten en tarjetas de aprobación pendientes. Una persona las aprueba o las descarta. Mostrar la diferencia entre el valor anterior y el nuevo por tipo de campo permite a esa persona evaluar el cambio propuesto real antes de que se guarde.

Eso hace que el chat sea más seguro que suponer que una solicitud en lenguaje natural se explica sola. "Cambia el estado" no es información suficiente para una revisión. La propuesta debe mostrar qué atributo personalizado cambia y cuál es el valor nuevo.

![Una tarjeta de propuesta del chat que muestra cambios del valor anterior al nuevo en cuatro atributos personalizados de una oportunidad](https://relaticle.com/storage/ink/01M0YZRTZSHZ02FV9MJ9F2ZJHR.png)

MCP tiene un comportamiento de escritura distinto. Las escrituras de las herramientas MCP se confirman directamente, sin paso de aprobación. Se aplican la misma definición de campo y la misma ruta de escritura, pero quien llama debe elegir su límite de control en consecuencia. Para conocer las lecciones de diseño relacionadas con la superficie de herramientas, lea [Cómo diseñar herramientas MCP para un CRM](https://relaticle.com/es/blog/disenar-herramientas-mcp-para-un-crm). Para configurar el cliente, lea [cómo conectar Claude a su CRM con MCP](https://relaticle.com/es/blog/como-conectar-claude-a-su-crm-con-mcp).

[](#ausente-no-es-vacío "Permalink")Ausente no es vacío
-------------------------------------------------------

Una regla pesa más para los agentes de lo que parece a primera vista: en un campo opcional, un `null` explícito borra su valor. Los campos de varios valores también aceptan `[]`. Las claves omitidas dejan los valores sin cambios. La validación de campos obligatorios puede rechazar el borrado.

| Estado de la carga | Resultado |
|---|---|
| La clave del campo está ausente | Se deja intacto el valor existente |
| La clave de un campo opcional tiene `null` | Se borra el campo |
| Un campo opcional de varios valores tiene `[]` | Se borra el campo |
| La clave del campo tiene un valor | Se valida y se guarda el valor |

Esta distinción evita que un agente convierta un contexto incompleto en una actualización destructiva. Un agente suele saber que debe cambiar una propiedad. Puede que no conozca el valor actual de todas las demás. Si una clave ausente significara "borrar", una actualización parcial eliminaría datos ajenos al cambio. Si un valor vacío explícito significara "dejar sin cambios", un agente no podría realizar de forma fiable una eliminación solicitada.

El contrato da a cada acción un único significado claro. Omitir significa que no hay instrucción. Un `null` explícito borra un campo opcional. Un arreglo vacío también borra un campo de varios valores. Un valor concreto lo reemplaza. Eso es lo bastante simple para expresarse en un esquema de herramienta y lo bastante preciso para razonar con seguridad sobre las actualizaciones parciales de registros.

Además, el comportamiento se mantiene alineado entre la aplicación web, la API, el chat y las herramientas MCP. La validación de campos obligatorios sigue aplicándose cuando una integración intenta borrar un valor. La forma de la entrada cambia según la superficie. La semántica de escritura no cambia.

[](#el-límite-de-permisos-que-aún-no-hemos-construido "Permalink")El límite de permisos que aún no hemos construido
-------------------------------------------------------------------------------------------------------------------

Hay una limitación real. La desactivación bloquea las escrituras, pero el chat sigue recibiendo los códigos y tipos de los campos inactivos. No es un control de confidencialidad. No ofrecemos permisos de visibilidad independientes para cada superficie.

Un equipo no puede usar la desactivación para garantizar que un campo desaparezca de todas las respuestas de un agente. La visibilidad de los campos necesita su propia política de control de acceso.

La restricción se deriva directamente de la fortaleza del diseño. Una definición viaja por varias superficies porque estas comparten el mismo modelo de campos. Cuando un equipo necesita políticas de exposición de campos distintas, esa política necesita una representación propia. Una colección de excepciones en las solicitudes de la API, los esquemas de IA y las definiciones de herramientas no basta.

Por ahora, desactive un campo cuando deba rechazar escrituras nuevas. Trate los controles de visibilidad por superficie como un requisito de producto aparte.

[](#qué-significa-realmente-definir-una-vez "Permalink")Qué significa realmente "definir una vez"
-------------------------------------------------------------------------------------------------

"Definir una vez" no significa que cada superficie presente el campo de forma idéntica. La API devuelve las opciones de selección como objetos `{id, label}`. El asistente del chat ve etiquetas de opciones y luego las traduce de vuelta a ID. Las tarjetas de propuesta muestran cambios del valor anterior al nuevo según el tipo. Son interfaces deliberadamente distintas para usuarios distintos.

Significa que la definición del campo sigue siendo la fuente de verdad. La aplicación web la usa para mostrar y guardar. La API la usa para validar. El chat la usa para describir una acción permitida. Las herramientas MCP la heredan sin una ruta de código por campo. Eso es lo que elimina el ciclo de despliegue después de que un administrador agrega un campo.

Creemos que este es el límite de ingeniería correcto para un CRM nativo de IA. Los datos configurables deben seguir siendo configurables cuando los toca un asistente o una integración. La aplicación no debe obligar a los equipos a elegir entre atributos personalizados y automatización.

Si desea conectar un cliente externo a esa misma superficie de registros, empiece por [la documentación de la API REST](https://relaticle.com/developers/api). Si va a definir el campo mismo, use [la guía de tipos de campos](https://relaticle.com/es/help/custom-fields/field-types-you-can-add).

 Etiquetas [ #mcp ](https://relaticle.com/es/blog/tag/mcp) 

 En esta página

 Siga leyendo

 Artículos relacionados. 
-------------------------

- [  2 de nov. de 2026  Ingeniería 

    ###  Abusaron de una prueba gratuita de modelos de IA premium: qué cambiamos 

    Una prueba sin tarjeta que desbloqueaba modelos de IA premium atrajo cuentas que nunca tocaron el CRM. En lugar de pedir una tarjeta, vinculamos los modelos premium con el primer registro real.

     ![](https://relaticle.com/storage/ink/01M7T5522BJSGFB1CXDCPP1CFP.png) 

     ](https://relaticle.com/es/blog/prueba-gratuita-de-modelos-de-ia-premium-abusada-que-cambiamos)
- [  21 de oct. de 2026  Ingeniería 

    ###  php2shell: cómo parcheamos Relaticle y cómo parchear su instalación 

    php2shell son dos fallas críticas de PHP que permiten a un atacante ejecutar código en un servidor web. Qué parcheamos en Relaticle Cloud y qué debe hacer hoy una instalación autoalojada.

     ![](https://relaticle.com/storage/ink/01M7T57XDGVV1RD8HF8DQTQDKH.png) 

     ](https://relaticle.com/es/blog/php2shell-parchear-php-en-docker-y-forge)
- [  11 de sep. de 2026  Ingeniería 

    ###  Diseñar herramientas MCP para un CRM: cuatro lecciones 

    Lo que nos enseñó construir el MCP server de Relaticle sobre esquemas, validación compartida de campos personalizados, autorización y descubrimiento por parte de los clientes.

     ![](https://relaticle.com/storage/ink/01M7T44F7DRPQY5A1ESYYX2WJE.png) 

     ](https://relaticle.com/es/blog/disenar-herramientas-mcp-para-un-crm)
