Cree y rastree atributos de datos personalizados (CDAs) sobre sus users y leads, basados en criterios específicos para su negocio. Puede usar estos datos para filtrar y crear segmentos de clientes, y para enviar mensajes y campañas dirigidas. También puede usarlos como datos de calificación para calificar leads y trial users.

¿Qué es un atributo de datos personalizado?

Un atributo de datos personalizado (CDA) rastrea hechos sobre sus clientes — como el plan en el que alguien está, o cuándo se registró — a diferencia de un evento, que rastrea acciones recurrentes del cliente.

Ejemplo: Si su producto es una herramienta de gestión de proyectos, podría rastrear datos sobre la cantidad de archivos que cada user tiene. Luego, si desea enviar mensajes a users que no han comenzado a agregar archivos a la herramienta y podrían necesitar ayuda para integrarse, podría configurar un mensaje dirigido a users con "archivos menos de 1".

Los CDAs más comunes configurados en Intercom son sobre desarrollo del cliente, como:

Plan de precios
Valor de las compras
Número de compañeros añadidos
Número de canciones reproducidas
Fecha de finalización de la suscripción

Importante:

El valor signed_up debe enviarse a Intercom a través de su integración. Este valor indica la hora en que un user se registró en su servicio.

Puede elegir actualizar el valor mediante:

enviándonos el parámetro created_at timestamp en el fragmento intercomSettings.
estableciendo el valor para signed_up_at si está usando nuestro REST API.
usando una importación CSV, asignando una de las columnas importadas como fecha de registro.

Intercom establecerá automáticamente el valor para la fecha signed_up solo en los siguientes casos:

SDKs (Android/iOS) y users no identificados
users creados a través del fragmento JS sin valor created_at

En esos casos, los users tendrán la hora de registro establecida en el momento de la solicitud de creación. En todos los demás casos, el valor debe ser establecido por usted.

Crear atributos de datos personalizados

Para crear un nuevo atributo en Intercom, vaya a Configuración > Datos > Personas y haga clic en + Crear atributo. Dé un nombre a su nuevo atributo, una descripción y seleccione el tipo de datos que almacenará.

Prevenir actualizaciones de atributos vía Messenger

Si "Actualizaciones de Atributos" está habilitado, entonces las actualizaciones a este atributo solo serán aceptadas si provienen de una solicitud autenticada (a través de REST API o token web JSON en Messenger). Las solicitudes no autenticadas serán ignoradas.

Esta configuración puede activarse o desactivarse para cada atributo y no afecta las actualizaciones desde otras fuentes como nuestra Public API, importaciones CSV, etc. Todos los atributos que no tengan esto habilitado estarán abiertos a actualizaciones inseguras.

Nota:

Recomendamos que active "Actualizaciones de Atributos" para evitar actualizaciones no autorizadas a sus datos. Luego puede configurar Seguridad en Messenger con JWTs para permitir que esos campos se actualicen de forma segura vía Messenger.
Los atributos solo están protegidos contra actualizaciones inseguras vía Messenger si la configuración está activada para cada atributo individual.
Las actualizaciones de atributos vía Messenger solo se procesarán si la solicitud está autenticada con JWT. Usar el método legado de Verificación de Identidad (User hash) no funcionará y no se procesará ninguna actualización para solicitudes que intenten actualizar atributos protegidos que incluyan user_hash en lugar de JWTs.

Haga clic en guardar y el atributo se añadirá a su lista de atributos. Aún no estará poblado para ninguno de sus clientes, deberá enviarlo a Intercom mediante el fragmento JavaScript, la API o una app de nuestra tienda de aplicaciones. 👌

Si necesita cambiar el formato o la descripción del atributo que acaba de crear, puede editarlo y hacer el cambio:

Importante: El nombre del atributo de datos personalizado no puede cambiarse después de creado. Deberá archivar el atributo existente y crear uno nuevo.

Actualizar atributos personalizados vía Messenger

Los atributos de datos personalizados pueden actualizarse usando el fragmento de código Javascript del Messenger.

Al actualizar atributos personalizados vía Messenger, verifique que sus claves siempre tengan un valor JSON válido que sea una cadena (texto), número o booleano (true o false). Eso significa usar comillas dobles alrededor de cadenas de texto y enviar NULL para casos en que no exista valor para un user.

También puede enviarnos fechas o URLs. Puede rastrear URLs como una cadena de texto, por ejemplo "http://www.google.com". Intercom reconocerá esto y automáticamente lo convertirá en un hipervínculo. Rastree fechas enviándonos un timestamp unix en segundos. Si crea un nombre de clave que termine con “_at” lo trataremos automáticamente como una fecha en lugar de un número (vea "last_order_at" abajo). Descubra cómo funcionan las fechas en Intercom aquí.

Importante: Asegúrese de que está pasando UNIX en segundos y no en milisegundos.

Aquí hay algunos ejemplos de pares clave y valor de atributos de datos:

window.intercomSettings = {
  email: "bob@example.com",
  user_id: "123",
  app_id: "abc1234",
  created_at: 1234567890,
  "subdomain": "intercom", // Put quotes around text strings
  "teammates": 4, // Send numbers without quotes
  "active_accounts": 12,
  "last_order_at" : 1350466020, // Send dates in unix timestamp format and end key names with "_at"
  "custom_domain": null // Send null when no value exists for a user
}

Importante: No use un objeto anidado custom_attributes: {} al pasar CDAs vía el fragmento JS del Messenger. Este formato (por ejemplo custom_attributes: { lead_source: "Intercom" }) solo es válido para la REST API. Cuando se pasa vía window.intercomSettings o window.Intercom("boot", ...), el Messenger descartará silenciosamente estos valores y no se actualizarán en el backend. Siempre pase los CDAs como claves de nivel superior directamente en el objeto de configuración, como se muestra en el ejemplo anterior. El atributo también debe existir ya en Intercom antes de que se acepte cualquier valor vía Messenger.

Diferentes tipos de CDAs que puede enviar a Intercom

Cadena (es decir, palabras) Ej. URLs, nombre del plan, tipo de user, etc.
Número (entero)
Booleano (true / false)
Marca de tiempo (la fecha y hora en que ocurre algo) ej. "converted_at"

Cosas para recordar:

Los nombres de clave distinguen mayúsculas y minúsculas, y no pueden contener puntos ('.'), signos de dólar ('$'), caracteres como ~`!@#%^&*'{}[]|\'" o el carácter NULL. — Si se usa un carácter no soportado, el atributo se creará con un guion bajo en su lugar.
Los valores de datos deben enviarse como cadenas JSON, números o booleanos (true o false). No podemos aceptar objetos, hashes anidados ni formatos de datos en arrays.
Los valores de cadena de texto solo pueden contener hasta 255 caracteres. Esto aplica solo a atributos personalizados y no a atributos de datos de conversación.
Puedes borrar los valores de datos existentes enviando cadenas vacías.
Intercom rastrea automáticamente una serie de atributos estándar. Revisa estos antes de crear atributos personalizados.
El límite suave es de 250 CDA activos.
Los valores numéricos no pueden comenzar con un "0". Los enteros son números enteros, por lo que "01234" debe ingresarse como "1234". Si necesitas recopilar una cadena de números, como un código postal estatal que incluye un "0" al inicio, entonces debes usar un atributo de tipo String.
Los atributos de Personas y Compañías comparten un espacio de nombres para los nombres: Un nombre de atributo personalizado usado en Personas no puede reutilizarse en Compañía, y viceversa, incluso si el atributo existente está archivado. Esto significa que si accidentalmente creas un atributo en Personas que querías para Compañía (o al revés), el nombre original no puede reutilizarse. Archiva el atributo equivocado y crea uno nuevo con un nombre ligeramente diferente. Los atributos de conversación son independientes y pueden compartir nombre con atributos de Personas o Compañía sin conflicto.
Los atributos personalizados no pueden eliminarse: Los atributos personalizados solo pueden archivarse, no eliminarse permanentemente a través de la interfaz de usuario. El soporte de Intercom no puede eliminarlos por ti.
Atributo "Plan Name" de Compañía: Intercom incluye un atributo del sistema incorporado llamado "Plan Name" para compañías. No aparece en Configuración pero sí en la barra lateral de conversación. Si creas un atributo personalizado de compañía con el mismo nombre, ambos se mostrarán en la barra lateral, causando duplicación aparente. Usa un nombre distinto (por ejemplo, "Subscription Plan") para evitar esto.

Una vez que hayas actualizado tu fragmento de código y comenzado a rastrear los datos, deberías:

Activa la verificación de identidad para tus users.
Crea descripciones para cada atributo para ayudar a tus compañeros a entenderlos.

Importante: Recibimos nuestros datos de geolocalización basados en la dirección IP del User desde un servicio externo llamado Maxmind. No tenemos control sobre estos datos y no es posible actualizarlos a través de la API, pero puedes solicitar una corrección de datos a través de esta página si crees que son incorrectos.

Además, es posible que estos users estén usando una VPN o que estén viajando en este momento, lo que explicaría por qué la ubicación parece incorrecta.

Con respecto al atributo "region": para Estados Unidos, "region" se refiere a Estado. En otros países puede variar; por ejemplo, en Canadá "region" se refiere a Provincia.

Puedes ver una lista de todos los valores de región y sus abreviaturas aquí.

Otros métodos

También es posible rastrear y actualizar atributos personalizados sobre tus users, con importaciones CSV, la REST API de Intercom o muchas aplicaciones de terceros.

Importante: Los atributos de datos personalizados deben crearse en Intercom antes de que cualquier integración o aplicación de terceros pueda actualizar sus valores. Las integraciones y la REST API solo pueden actualizar los valores de atributos existentes; no pueden crear nuevas definiciones de atributos. Para agregar un nuevo atributo, ve a Configuración > Datos > Personas y créalo manualmente primero.

¿Qué es la data de calificación personalizada?

La data de calificación es un conjunto especial de atributos que puedes actualizar manualmente en los perfiles de tus clientes mientras los calificas. Puedes configurarlos mediante un formulario simple en Intercom. Si planeas actualizar estos datos manualmente, no necesitas hacer nada más.

Si quieres rastrear estos datos mediante un ping, necesitas agregar los pares clave/valor a tu fragmento de código intercomSettings, tal como harías con otros datos personalizados.

Para crear nueva data de calificación personalizada, ve a Configuración > Datos > Personas > Calificación de leads.

Desplázate hacia abajo y haz clic en Agregar datos y luego en + Crear nuevos datos en el menú desplegable.

Aquí puedes crear un nombre (esa es tu clave) y elegir un formato para los valores que recopilarás (Texto, Número, Verdadero o Falso, o Lista).

Si eliges el formato Lista, no es una estructura de matriz sino una lista de selecciones donde los valores están predeterminados.

Nota: Es posible establecer el valor de un atributo de lista a un valor que no hayas configurado manualmente para la lista usando nuestra REST API. Sin embargo, este valor no se agregará como una opción permanente para esa lista al cambiar el valor manualmente y puede perderse si un compañero cambia este valor manualmente.

Finalmente, puedes agregar una descripción para ayudar a tus compañeros a entender los datos.

Elige nombres simples para tu data de calificación personalizada. Si decides calificar estos datos a través del Messenger, los clientes verán estos nombres en el Messenger.

Importante: Los atributos desplegables seleccionables manualmente (lista) en Datos de Personas están limitados a 35 opciones por atributo. Este límite no puede eliminarse. Si necesitas más de 35 valores, usa un atributo de texto y establece los valores mediante la REST API.

Archivar atributos de datos

Los atributos de datos personalizados no pueden eliminarse completamente, pero puedes archivarlos. Los datos archivados no aparecerán como filtro en tus listas de users o leads, por lo que es una buena forma de limpiar datos que no necesitas.

Ve a Configuración > Datos > Personas.

Elige un dato que quieras archivar. Haz clic en el ícono de editar junto a él y luego haz clic en Archivar en la ventana emergente. Puedes desarchivarlos si cambias de opinión, pero no puedes eliminar completamente los atributos de datos personalizados.

Para encontrar tus atributos personalizados archivados, solo desplázate hasta el final de la página.

Si quieres desarchivar tu atributo personalizado, abre el atributo y haz clic en "Desarchivar".

Comprendiendo los límites y mejores prácticas de CDA

Los atributos de datos personalizados (CDA) tienen límites en el espacio de trabajo para mantener un rendimiento óptimo.

Hay un límite de 250 CDA de Personas y Compañías por espacio de trabajo, pero puedes archivar atributos no usados para liberar espacio.

Al crear nuevos atributos, considera estas mejores prácticas:

Crea atributos que tengan una aplicación amplia entre los users.
Evita crear atributos para situaciones puntuales.
Considera usar Eventos como alternativa para escenarios específicos.
Utiliza etiquetas cuando sea apropiado, ya que no tienen las mismas limitaciones.

Revisa regularmente el uso de tus CDA para asegurar una gestión eficiente del espacio de trabajo. Si necesitas mayor capacidad después de implementar estrategias de optimización, pueden estar disponibles aumentos adicionales de límite bajo solicitud.

Nota: Si envías datos sobre tus users a través del Messenger, te recomendamos encarecidamente que asegures tu Messenger. Más información:

Autenticación de tus users con JSON web tokens (JWTs)

Preguntas frecuentes

¿Cómo se llena el atributo 'Country' y qué tan rápido se actualiza para usarse en workflows?

El atributo 'Country' se llena y actualiza automáticamente basado en la dirección IP del user. Esto sucede instantáneamente cada vez que un user está activo en tu app o interactúa con el Messenger. Debido a que los datos están disponibles en tiempo real, puedes usarlo para ramificar un workflow tan pronto como un user inicia una conversación.

¿Se puede editar manualmente el atributo 'Country'?

No, el atributo 'Country' es un campo generado por el sistema y no puede editarse manualmente. Si necesitas un campo de país que pueda ser actualizado manualmente por un user o un administrador, deberías crear un atributo personalizado para este propósito.

¿Por qué fallan mis actualizaciones de API a un atributo personalizado cuando uso la integración de Jira?

Las actualizaciones de API a atributos personalizados pueden fallar silenciosamente si un atributo personalizado comparte el mismo nombre que un atributo de Jira. Cuando existen nombres duplicados, las solicitudes de actualización de API se dirigen al atributo de Jira en lugar de tu atributo personalizado, y las actualizaciones a atributos de Jira son bloqueadas, causando que la solicitud falle.

Para solucionar esto, cambie el nombre de su atributo personalizado para que no duplique ningún nombre de atributo de Jira. Tenga en cuenta que los nombres de atributos personalizados no se pueden cambiar después de la creación, por lo que deberá archivar el atributo existente y crear uno nuevo con un nombre único.

Crear y rastrear atributos de datos personalizados (CDAs)