Propiedades custom de contactos

Que son las propiedades custom

Las propiedades custom te permiten agregar campos personalizados a tus contactos del CRM mas alla de los campos estandar (email, telefono, empresa). Por ejemplo, puedes crear campos como Ciudad, Fecha de nacimiento, Nivel de experiencia o cualquier dato relevante para tu negocio.

Los valores se guardan en cada contacto y se pueden usar para:

• Filtrar contactos en segmentos dinamicos.
• Personalizar emails con variables (por ejemplo, {ciudad}).
• Recoger datos desde la API externa (Zapier, n8n, formularios).
• Enriquecer la vista 360 del contacto en el CRM.

Tipos de propiedad disponibles

Cada propiedad tiene un tipo que define que valores acepta y como se muestra en la interfaz:

• Texto — campo de texto libre. Ideal para: ciudad, empresa, cargo, URL.
• Numero — valor numerico. Ideal para: edad, ingresos, numero de empleados.
• Fecha — selector de fecha. Ideal para: fecha de nacimiento, fecha de renovacion, aniversario.
• Booleano — si/no (toggle). Ideal para: es cliente VIP, acepto newsletter, tiene descuento.
• Seleccion — opciones predefinidas (dropdown). Ideal para: nivel de experiencia, industria, pais. Tu defines las opciones disponibles.

Crear una propiedad

Ve a Admin > CRM > Propiedades y haz clic en Nueva propiedad:

• Nombre — nombre de la propiedad para mostrar (ej: "Ciudad"). El sistema genera automaticamente un identificador interno en formato slug (ej: ciudad).
• Tipo — selecciona uno de los 5 tipos disponibles.
• Opciones — solo para tipo Seleccion. Agrega las opciones que el usuario podra elegir (ej: "Principiante", "Intermedio", "Avanzado").

La propiedad aparecera inmediatamente en el detalle de cada contacto del CRM.

Editar valores en un contacto

Desde la vista de detalle de un contacto (Admin > CRM > [contacto]), veras la seccion Propiedades en el panel lateral izquierdo, debajo de las listas. Cada propiedad muestra su valor actual (o "Sin valor" si esta vacio).

Para editar:

• Haz clic en el icono de editar (lapiz) junto a la propiedad.
• Modifica el valor en el input que aparece.
• El valor se guarda automaticamente al hacer clic fuera del campo.

Usar propiedades en segmentos

Al crear un segmento dinamico, las propiedades custom aparecen como campos disponibles en el constructor de filtros, bajo el grupo Propiedades custom. Puedes combinarlas con campos estandar para crear segmentos precisos.

Ejemplo: "Contactos donde Ciudad es Bogota Y lead score mayor que 50".

Propiedades via API

Si tu academia tiene la API externa habilitada, puedes enviar valores de propiedades custom al crear o actualizar contactos. Incluye el campo metadata en el body del request con las claves de las propiedades:

{ "email": "juan@ejemplo.com", "metadata": { "ciudad": "Bogota", "nivel_experiencia": "avanzado" } }

Administrar propiedades

• Editar — puedes cambiar el nombre (label), tipo y opciones de una propiedad existente. El identificador interno no cambia.
• Reordenar — arrastra las propiedades en la lista para cambiar el orden en que aparecen en el detalle del contacto.
• Eliminar — al eliminar una propiedad, se limpian automaticamente los valores de esa propiedad en todos los contactos. Esta accion no se puede deshacer.

Preguntas frecuentes

• ¿Cuantas propiedades custom puedo crear?

  No hay limite. Puedes crear tantas propiedades como necesites para tu caso de uso.

• ¿Las propiedades custom funcionan con la importacion de contactos?

  Si envias datos via la API externa con el campo metadata, los valores se guardan en las propiedades correspondientes. Las claves del metadata deben coincidir con los identificadores internos de las propiedades.

• ¿Puedo cambiar el tipo de una propiedad despues de crearla?

  Si, pero ten cuidado: los valores existentes no se convierten automaticamente. Por ejemplo, si cambias de "texto" a "numero", los valores de texto existentes podrian no ser validos.

• ¿Los valores de propiedades custom aparecen en los exports?

  Si. Al exportar contactos, las propiedades custom se incluyen como columnas adicionales en el archivo CSV.