​

Atributos personalizados

​

Acceso a atributos personalizados

1. En el menú de la barra lateral izquierda, haga clic en Configuración.
2. En la lista de opciones de configuración, seleccione Atributos personalizados.

​

Categorías de atributos

• Conversaciones: Atributos aplicados a las conversaciones
• Contactos: Atributos aplicados a los contactos
• Pipeline: Atributos aplicados a pipelines, etapas o artículos

​

Búsqueda de atributos personalizados

​

Cómo buscar

1. En la parte superior de la pantalla, ubique el campo “Buscar atributos personalizados…” con el ícono de búsqueda.
2. Escriba el nombre, descripción o clave del atributo deseado.
3. La tabla de atributos se actualizará automáticamente a medida que escriba, mostrando solo los atributos que coincidan con la búsqueda.

​

Ver atributos personalizados en la tabla

​

Columnas de tabla

• Nombre: Nombre para mostrar del atributo personalizado
• Muestra el nombre definido durante la creación (por ejemplo, “Prioridad del cliente potencial”, “Posición”, “Motivo del contacto”)
• La columna se puede ordenar (indicada por flechas arriba/abajo)
• Descripción: Descripción completa del atributo
• Muestra la descripción definida durante la creación.
• Ayuda a comprender el propósito del atributo.
• Tipo: Tipo de datos del atributo
• Se muestra en una etiqueta azul (por ejemplo, “Texto”, “Número”, “Fecha”)
• Indica el formato de datos aceptado por el atributo
• Clave: Clave técnica del atributo
• Se muestra en una etiqueta gris (por ejemplo, “cliente potencial_prioridad”, “posición”, “contacto_razón”)
• Se utiliza para identificar el atributo en el API.
• Valores: Valores predefinidos (si corresponde)
• Muestra valores predefinidos para atributos de tipo lista o selección
• Muestra ”-” cuando no corresponde
• Regex: Indica si el atributo tiene validación por expresión regular
• Se muestra en una etiqueta verde con “Sí” cuando se configura la expresión regular
• Se muestra como ”-” cuando no hay validación de expresiones regulares
• Creado en: Fecha de creación del atributo
• Muestra la fecha en formato DD/MM/AAAA (por ejemplo, “23/01/2026”)
• La columna se puede ordenar (indicada por flechas arriba/abajo)
• Modelo: Modelo al que aplica el atributo (solo para Pipeline)
• Muestra “Elemento”, “Etapa” o “Pipeline” para los atributos de pipeline
• No se muestra para los atributos de Conversaciones o Contactos
• Acciones: Menú de acciones para gestionar el atributo.
• Icono de tres puntos horizontales (...) que abre un menú desplegable con opciones

​

Características de la mesa

• Clasificación: Las columnas Nombre y Creado en se pueden ordenar haciendo clic en el encabezado
• Búsqueda integrada: La barra de búsqueda situada encima de la tabla filtra los resultados en tiempo real.
• Filtro de categorías: Use pestañas (Conversaciones, Contactos, Canalización) para filtrar atributos por categoría
• Contador: El número total de atributos en la categoría actual se muestra debajo del título.

​

Atributos para conversaciones

​

Crear un atributo de conversación

1. En la pantalla Atributos personalizados, haga clic en la pestaña “Conversaciones” para filtrar solo los atributos de la conversación.
2. Haga clic en el botón verde ”+ Nuevo atributo personalizado” en la esquina superior derecha de la pantalla.
3. Se mostrará un modal con el título “Nuevo atributo personalizado”

​

Completando el formulario

• Seleccione “Conversaciones” en el menú desplegable
• Se mostrará el texto de ayuda: “Atributos aplicados a las conversaciones”

• Escriba un nombre descriptivo que se mostrará a los usuarios.
• Ejemplo: “Motivo del contacto”

• La clave técnica se generará automáticamente a partir del nombre para mostrar
• Utilice sólo letras minúsculas, números y guiones bajos
• Ejemplo: contact_reason

• Explicar el propósito del atributo.
• Ejemplo: “Identifique el motivo principal por el cual el cliente se comunicó con usted”.

• Seleccione el tipo de datos (Texto, Número, Fecha, Booleano, Lista)
• Para el ejemplo “Motivo del contacto”, seleccione “Texto”

• Activa el interruptor si quieres validar el formato del texto.
• Ejemplo de patrón de expresiones regulares: ^.{5,}$ (mínimo 5 caracteres)
• Ejemplo de señal de expresión regular: “Describa el motivo por el que se comunica con nosotros (mínimo 5 caracteres)”.

​

Finalizando la creación

1. Revisa la información ingresada
2. Verifique que la validación de expresiones regulares esté configurada correctamente (si corresponde)
3. Haga clic en el botón verde “Crear” para crear el atributo.
4. El atributo se creará y aparecerá en la tabla de atributos de Conversaciones.

​

Editar un atributo de conversación

1. En la tabla de atributos, asegúrese de que la pestaña “Conversaciones” esté seleccionada
2. Localiza el atributo que deseas editar.
3. En la columna Acciones, haga clic en el ícono de tres puntos (...)
4. En el menú desplegable, haga clic en Editar (icono de lápiz)
5. Se abrirá un modal con el título “Editar atributo personalizado” y los campos ya completados.
6. Modifique los campos deseados:

• Nombre para mostrar
• Descripción
• Tipo (tenga cuidado al cambiar, ya que puede afectar los datos existentes)
• Validación de expresiones regulares (activar/desactivar o modificar patrón y señal)

7. Haga clic en el botón verde “Actualizar” para guardar los cambios.

​

Eliminar un atributo de conversación

1. En la tabla de atributos, ubique el atributo que desea eliminar.
2. En la columna Acciones, haga clic en el ícono de tres puntos (...)
3. En el menú desplegable, haga clic en Eliminar (icono de papelera en rojo)
4. Confirme la eliminación en el cuadro de diálogo que aparece.

​

Atributos para contactos

​

Crear un atributo de contacto

1. En la pantalla Atributos personalizados, haga clic en la pestaña “Contactos” para filtrar solo los atributos de contacto.
2. Haga clic en el botón verde ”+ Nuevo atributo personalizado” en la esquina superior derecha de la pantalla.
3. Se mostrará un modal con el título “Nuevo atributo personalizado”

​

Completando el formulario

• Seleccione “Contactos” en el menú desplegable
• Se mostrará el texto de ayuda: “Atributos aplicados a los contactos”

• Escriba un nombre descriptivo que se mostrará a los usuarios.
• Ejemplo: “Posición”

• La clave técnica se generará automáticamente a partir del nombre para mostrar
• Utilice sólo letras minúsculas, números y guiones bajos
• Ejemplo: position

• Explicar el propósito del atributo.
• Ejemplo: “Indica el puesto o rol del contacto dentro de la empresa”.

• Seleccione el tipo de datos (Texto, Número, Fecha, Booleano, Lista)
• Para el ejemplo de “Posición”, seleccione “Texto”

• Activa el interruptor si quieres validar el formato del texto.
• Ejemplo de patrón de expresiones regulares: ^.{2,}$ (mínimo 2 caracteres)
• Ejemplo de señal de expresión regular: “Proporcione el puesto de trabajo del contacto (mínimo 2 caracteres)”.

​

Finalizando la creación

1. Revisa la información ingresada
2. Verifique que la validación de expresiones regulares esté configurada correctamente (si corresponde)
3. Haga clic en el botón verde “Crear” para crear el atributo.
4. El atributo se creará y aparecerá en la tabla de atributos de Contactos.

​

Editar un atributo de contacto

1. En la tabla de atributos, asegúrese de que la pestaña “Contactos” esté seleccionada.
2. Localiza el atributo que deseas editar.
3. En la columna Acciones, haga clic en el ícono de tres puntos (...)
4. En el menú desplegable, haga clic en Editar (icono de lápiz)
5. Se abrirá un modal con el título “Editar atributo personalizado” y los campos ya completados.
6. Modifique los campos deseados.
7. Haga clic en el botón verde “Actualizar” para guardar los cambios.

​

Eliminar un atributo de contacto

1. En la tabla de atributos, ubique el atributo que desea eliminar.
2. En la columna Acciones, haga clic en el ícono de tres puntos (...)
3. En el menú desplegable, haga clic en Eliminar (icono de papelera en rojo)
4. Confirme la eliminación en el cuadro de diálogo que aparece.

​

Atributos para canalización

​

Creando un atributo de canalización

1. En la pantalla Atributos personalizados, haga clic en la pestaña “Pipeline” para filtrar solo los atributos del pipeline.
2. Haga clic en el botón verde ”+ Nuevo atributo personalizado” en la esquina superior derecha de la pantalla.
3. Se mostrará un modal con el título “Nuevo atributo personalizado”

​

Completando el formulario

• Seleccione “Pipeline” en el menú desplegable
• Se mostrará el texto de ayuda: “Atributos aplicados a canalizaciones, etapas o elementos”
• Importante: Cuando se selecciona “Tubería”, se mostrará un campo adicional “Tipo de tubería”

• Pipeline: Atributos aplicados al pipeline en su conjunto
• Etapa: Atributos aplicados a las etapas del pipeline
• Artículo: Atributos aplicados a los elementos del embudo (acuerdos/clientes potenciales)
• Ejemplo: Para “Prioridad de clientes potenciales”, seleccione “Artículo”
• El texto de ayuda mostrará: “Atributos aplicados a los elementos (acuerdos/clientes potenciales) del embudo”

• Escriba un nombre descriptivo que se mostrará a los usuarios.
• Ejemplo: “Prioridad de clientes potenciales”

• La clave técnica se generará automáticamente a partir del nombre para mostrar
• Utilice sólo letras minúsculas, números y guiones bajos
• Ejemplo: lead_priority

• Explicar el propósito del atributo.
• Ejemplo: “Defina la prioridad de la oportunidad en el proceso de ventas”.

• Seleccione el tipo de datos (Texto, Número, Fecha, Booleano, Lista)
• Para el ejemplo de “Prioridad de clientes potenciales”, seleccione “Texto”

• Activa el interruptor si quieres validar el formato del texto.
• Ejemplo de patrón de expresión regular: `^(Low|Medium|High)* Ejemplo de patrón de expresión regular: (solo acepta “Bajo”, “Medio” o “Alto”)
• Ejemplo de señal de expresión regular: “Usar solo: Bajo, Medio o Alto”

​

Finalizando la creación

1. Revise la información ingresada, especialmente el Tipo de tubería.
2. Verifique que la validación de expresiones regulares esté configurada correctamente (si corresponde)
3. Haga clic en el botón verde “Crear” para crear el atributo.
4. El atributo se creará y aparecerá en la tabla de atributos de Pipeline.

​

Editar un atributo de canalización

1. En la tabla de atributos, asegúrese de que la pestaña “Pipeline” esté seleccionada.
2. Localiza el atributo que deseas editar.
3. En la columna Acciones, haga clic en el ícono de tres puntos (...)
4. En el menú desplegable, haga clic en Editar (icono de lápiz)
5. Se abrirá un modal con el título “Editar atributo personalizado” y los campos ya completados.
6. Modifique los campos deseados:

• Tipo de Tubería (si es necesario)
• Nombre para mostrar
• Descripción
• Tipo (tenga cuidado al cambiar, ya que puede afectar los datos existentes)
• Validación de expresiones regulares (activar/desactivar o modificar patrón y señal)

7. Haga clic en el botón verde “Actualizar” para guardar los cambios.

​

Eliminación de un atributo de canalización

1. En la tabla de atributos, ubique el atributo que desea eliminar.
2. En la columna Acciones, haga clic en el ícono de tres puntos (...)
3. En el menú desplegable, haga clic en Eliminar (icono de papelera en rojo)
4. Confirme la eliminación en el cuadro de diálogo que aparece.

​

Campos de formulario en detalle

​

Aplicar a - Requerido

• Campo: Aplicar a (marcado con un asterisco * que indica el campo obligatorio)
• Tipo: Desplegable (menú de suspensión)
• Descripción: Define dónde se aplicará el atributo.
• Opciones disponibles:
• Conversaciones: Atributos aplicados a las conversaciones
• Contactos: Atributos aplicados a los contactos
• Pipeline: Atributos aplicados a pipelines, etapas o artículos
• Texto de ayuda: Muestra una descripción que explica el contexto seleccionado.
• Ubicación: Primer campo del formulario

​

Tipo de canalización: obligatorio (solo para canalización)

• Campo: Tipo de tubería (marcado con un asterisco * que indica el campo obligatorio)
• Tipo: Desplegable (menú de suspensión)
• Descripción: Define si el atributo se aplica a la canalización, etapa o elemento.
• Opciones disponibles:
• Pipeline: Atributos aplicados al pipeline en su conjunto
• Etapa: Atributos aplicados a las etapas del pipeline
• Artículo: Atributos aplicados a los elementos del embudo (acuerdos/clientes potenciales)
• Texto de ayuda: “Seleccione si este atributo se aplica a la canalización, etapa o elemento”.
• Ubicación: Segundo campo del formulario, que se muestra solo cuando se selecciona “Pipeline” en “Aplicar a”

​

Nombre para mostrar: obligatorio

• Campo: Nombre para mostrar (marcado con un asterisco * que indica el campo obligatorio)
• Tipo: Campo de texto simple
• Descripción: Nombre descriptivo que se mostrará a los usuarios
• Ejemplos: “Prioridad del cliente potencial”, “Posición”, “Motivo del contacto”
• Recomendación: Utilizar nombres descriptivos y claros que faciliten la identificación de atributos
• Ubicación: Tercer campo del formulario (o segundo, si no es Pipeline)

​

Clave de atributo: obligatoria

• Campo: Clave de atributo (marcado con un asterisco * que indica el campo obligatorio)
• Tipo: Campo de texto simple
• Descripción: Clave técnica utilizada para identificar el atributo en el API
• Texto de ayuda: “La clave se utilizará para identificar este atributo en API. Utilice únicamente letras minúsculas, números y guiones bajos”.
• Normas:
• Utilice sólo letras minúsculas, números y guiones bajos
• No utilice espacios ni caracteres especiales
• Generalmente se genera automáticamente a partir del nombre para mostrar
• Ejemplos: lead_priority, position, contact_reason
• Ubicación: Cuarto campo del formulario (o tercero, si no es Pipeline)

​

Descripción - Requerido

• Campo: Descripción (marcado con un asterisco * que indica el campo obligatorio)
• Tipo: Área de texto (área de texto)
• Descripción: Explicación detallada del propósito del atributo.
• Ejemplos:
• “Definir la prioridad de la oportunidad en el pipeline de ventas”.
• “Indica el cargo o rol del contacto dentro de la empresa.”
• “Identifique el motivo principal por el cual el cliente se comunicó con usted.”
• Recomendación: Sea claro y objetivo sobre lo que representa el atributo.
• Ubicación: Quinto campo del formulario (o cuarto, si no es Pipeline)

​

Tipo - Requerido

• Campo: Tipo (marcado con un asterisco * que indica el campo obligatorio)
• Tipo: Desplegable (menú de suspensión)
• Descripción: Define el tipo de datos que aceptará el atributo.
• Opciones disponibles:
• Texto: Campo de texto simple
• Descripción: “Campo de texto simple”
• Permite cualquier texto libre
• Número: Campo numérico
• Fecha: Campo de fecha
• Booleano: Campo verdadero/falso
• Lista: Lista de valores predefinidos
• Texto de ayuda: Muestra una descripción del tipo seleccionado
• Ubicación: Sexto campo del formulario (o quinto, si no es Pipeline)

​

Validación de expresiones regulares: opcional

• Sección: “Validación de expresiones regulares”
• Descripción: “Agregue un patrón de expresiones regulares para validar los valores de este atributo”
• Interruptor de palanca: Cambia en la esquina superior derecha de la sección
• Desactivado: No se aplicará la validación de expresiones regulares
• Activado: Se aplicará la validación Regex (indicada por el color verde/turquesa)

​

Patrón de expresiones regulares

• Campo: Patrón de expresiones regulares
• Tipo: Campo de texto simple
• Descripción: Expresión regular que define el patrón de validación.
• Ejemplos:
• ^(Low|Medium|High)$ - Acepta sólo “Bajo”, “Medio” o “Alto”
• ^.{2,}$ - Acepta cualquier texto con al menos 2 caracteres
• ^.{5,}$ - Acepta cualquier texto con al menos 5 caracteres
• Recomendación: Pruebe el patrón de expresiones regulares antes de guardar para asegurarse de que funcione como se esperaba

​

Señal de expresión regular

• Campo: Regex Cue
• Tipo: Área de texto (área de texto)
• Descripción: Mensaje de ayuda que se muestra a los usuarios cuando completan el campo
• Texto de ayuda: “Esta señal se mostrará a los usuarios cuando completen el campo”
• Ejemplos:
• “Usar sólo: Bajo, Medio o Alto”
• “Proporcione el puesto de trabajo del contacto (mínimo 2 caracteres)”.
• “Describe el motivo por el que nos contactas (mínimo 5 caracteres)”.
• Recomendación: Sea claro y específico sobre el formato esperado

​

Tipos de atributos disponibles

​

Texto

• Descripción: Campo de texto simple
• Uso: Permite ingresar cualquier texto libre
• Ejemplos de uso:
• Puesto de trabajo del contacto
• Motivo de contacto
• Notas generales
• Validación: Se puede combinar con expresiones regulares para restringir el formato o el tamaño

​

Número

• Descripción: Campo numérico
• Uso: Permite ingresar valores numéricos
• Ejemplos de uso:
• Valor estimado de una oportunidad *Número de empleados de la empresa
• Puntuación de satisfacción

​

Fecha

• Descripción: Campo de fecha
• Uso: Permite seleccionar o ingresar una fecha
• Ejemplos de uso:
• Cumpleaños del contacto
• Fecha prevista de cierre de oportunidad
• Fecha del último contacto

​

Booleano

• Descripción: Campo verdadero/falso
• Uso: Permite marcar como verdadero o falso
• Ejemplos de uso:
• Cliente VIP (sí/no)
• Acepta marketing (sí/no)
• Oportunidad calificada (sí/no)

​

Lista

• Descripción: Lista de valores predefinidos
• Uso: Permite seleccionar un valor de una lista predefinida
• Ejemplos de uso:
• Prioridad (Baja, Media, Alta)
• Estado (Activo, Inactivo, Pendiente)
• Fuente principal (sitio web, referencia, campaña)

​

Validación de expresiones regulares (Regex)

​

Cuándo usar expresiones regulares

• Valores predefinidos: Cuando desea restringir la entrada a valores específicos (por ejemplo, “Bajo”, “Medio”, “Alto”)
• Formato específico: Cuando necesita un formato específico (por ejemplo, código de producto, número de teléfono)
• Tamaño mínimo/máximo: Cuando necesita garantizar un tamaño de texto mínimo o máximo
• Patrones complejos: Cuando necesita validar patrones más complejos (por ejemplo, correos electrónicos, URL, códigos)

​

Ejemplos de patrones de expresiones regulares

​

Valores predefinidos

^(Low|Medium|High)$

• Acepta sólo “Bajo”, “Medio” o “Alto”
• Regex Cue: “Usar sólo: Bajo, Medio o Alto”

​

Tamaño mínimo

^.{2,}$

• Acepta cualquier texto con al menos 2 caracteres
• Regex Cue: “Proporcione al menos 2 caracteres”.

^.{5,}$

• Acepta cualquier texto con al menos 5 caracteres
• Regex Cue: “Describe el motivo por el que nos contactas (mínimo 5 caracteres)”.

​

Formato de correo electrónico

^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$

• Valida el formato básico de correo electrónico.
• Regex Cue: “Proporcione una dirección de correo electrónico válida”.

​

Consejos para expresiones regulares

• Pruebe primero: Siempre pruebe su patrón de expresiones regulares antes de guardarlo para asegurarse de que funcione como se esperaba.
• Sea específico: Utilice Regex Cue para explicar claramente el formato esperado a los usuarios
• Documentación: Considere documentar patrones de expresiones regulares complejos para facilitar el mantenimiento futuro
• Rendimiento: Los patrones de expresiones regulares muy complejos pueden afectar el rendimiento; úselo con moderación

​

Consideraciones finales

• Nomenclatura coherente: Utilice nombres y claves para mostrar coherentes para facilitar la organización y la búsqueda.
• Descripciones claras: Escriba descripciones claras y objetivas que expliquen el propósito de cada atributo.
• Validación adecuada: Utilice la validación de expresiones regulares cuando sea necesario para garantizar la calidad de los datos, pero no sea demasiado restrictivo.
• Categorización: Organice los atributos en categorías apropiadas (Conversaciones, Contactos, Canalización) para facilitar la gestión.
• Revisión periódica: Revise periódicamente los atributos existentes para asegurarse de que sigan siendo relevantes y actualizados.
• Documentación: Documente atributos personalizados complejos o aquellos con patrones de expresiones regulares específicos para facilitar el uso del equipo.
• Integración API: Recuerde que la clave de atributo se utiliza en API: mantenga la coherencia y evite cambios innecesarios
• Impacto de los datos: Considere el impacto en los datos existentes antes de cambiar el tipo o eliminar un atributo.
• Uso estratégico: Utilice atributos personalizados para recopilar información que agregue valor a su proceso de negocio.