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 que alguien tiene o cuándo se registró — a diferencia de un evento, que rastrea acciones recurrentes del cliente.
Lo que esto no hace
Los atributos de datos personalizados son los campos que crea en Settings > Data > People. Algunos campos en una conversación o ticket, como Followers, están integrados en el Inbox en lugar de ser creados como atributos de datos personalizados, por lo que no puede archivarlos como atributos de datos personalizados.
Ejemplo: Si su producto es una herramienta de gestión de proyectos, podría rastrear datos sobre la cantidad de archivos que tiene cada user. Luego, si desea enviar mensajes a users que no han comenzado a agregar archivos a la herramienta y podrían necesitar ayuda para incorporarse, podría configurar un mensaje dirigido a users con "files less than 1".
Los CDAs más comunes configurados en Intercom son sobre desarrollo del cliente, tales 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 el momento en que un user se registró en su servicio.
Puede elegir actualizar el valor mediante:
enviándonos el parámetro
created_attimestamp en el fragmento intercomSettings.estableciendo el valor para
signed_up_atsi 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 mediante el 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 deberá ser establecido por usted.
Crear atributos de datos personalizados
Para crear un nuevo atributo en Intercom, vaya a Settings > Data > People 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 "Attribute Updates" 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 JSON web token 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 "Attribute Updates" para evitar actualizaciones no autorizadas de 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. 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 lo convertirá automáticamente en un hipervínculo. Rastree fechas enviándonos un timestamp unix en segundos. Si crea un nombre de clave que termine en “_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 pasar UNIX en segundos y no en milisegundos.
Aquí hay algunos ejemplos de pares clave-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"
Nota: Los campos de fecha y hora se tratan solo como fechas en informes y filtros, por lo que los filtros funcionan por día, no por hora, minuto o segundo. Los atributos personalizados de fecha/hora pueden no aparecer en informes para métricas que no lo soportan.
Cosas para recordar:
Los nombres clave distinguen entre 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. Revísalos 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: Un nombre de atributo personalizado usado en Personas no puede reutilizarse en Compañías, y viceversa, incluso si el atributo existente está archivado. Esto significa que si accidentalmente creas un atributo en Personas que querías para Compañías (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ñías sin conflicto.
Los atributos personalizados no pueden eliminarse: Los atributos personalizados solo pueden archivarse, no eliminarse permanentemente a través de la interfaz. El soporte de Intercom no puede eliminarlos por ti.
Atributo "Plan Name" de Compañía: Intercom incluye un atributo de 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 mediante la API, pero puedes optar por presentar una solicitud de 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 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 a medida que 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 (que será 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 array 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 añadirá como opción permanente para esa lista cuando se cambie 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 vía Messenger, los clientes verán estos nombres en el Messenger.
Importante: Los atributos desplegables seleccionables manualmente (listas) 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 vía 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 icono 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".
Comprender los límites y mejores prácticas de CDA
Los atributos de datos personalizados (CDA) tienen límites por 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 tras implementar estrategias de optimización, pueden estar disponibles aumentos adicionales bajo solicitud.
Nota: Si envías datos sobre tus users vía Messenger, te recomendamos encarecidamente asegurar tu Messenger. Más información:
Preguntas frecuentes
¿Cómo se llena el atributo 'Country' y qué tan rápido se actualiza para usarse en workflows?
¿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 usarlos para ramificar un workflow tan pronto como un user inicia una conversación.
¿Se puede editar manualmente el atributo 'Country'?
¿Se puede editar manualmente el atributo 'Country'?
No, el atributo 'Country' es un campo generado por el sistema y no puede ser editado manualmente. Si necesitas un campo de país que pueda ser actualizado manualmente por un usuario o un administrador, debes crear un atributo personalizado para este propósito.
¿Por qué fallan mis actualizaciones API a un atributo personalizado cuando uso la integración de Jira?
¿Por qué fallan mis actualizaciones API a un atributo personalizado cuando uso la integración de Jira?
Las actualizaciones 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 API se dirigen al atributo de Jira en lugar de tu atributo personalizado, y las actualizaciones a atributos de Jira están bloqueadas, causando que la solicitud falle.
Para solucionar esto, cambia el nombre de tu atributo personalizado para que no duplique ningún nombre de atributo de Jira. Ten en cuenta que los nombres de atributos personalizados no pueden cambiarse después de la creación, por lo que deberás archivar el atributo existente y crear uno nuevo con un nombre único.