Para gestionar eficazmente a tus clientes, Intercom utiliza dos tipos de IDs: el Intercom ID y el user_id. Entender cómo funcionan juntos es esencial para mantener la integridad de los datos y asegurar una identificación precisa del cliente.

El Intercom ID es un identificador que nuestro sistema genera automáticamente para cada registro de cliente. Este ID es constante y no puede ser cambiado. En nuestra API, a menudo se le llama contact_id.

El user_id es un identificador personalizable que puedes configurar para que coincida con la clave primaria o ID único de tu propia base de datos. Ofrece una forma flexible de integrar Intercom con tus sistemas externos y puede actualizarse vía API.

Seguir estas mejores prácticas te ayudará a evitar problemas comunes de datos como registros duplicados o conversaciones fusionadas.

Siempre debes asignar un user_id único para cada cliente, típicamente la clave primaria de tus propios registros de base de datos. Es crucial usar este mismo user_id para todas las interacciones futuras y actualizaciones de perfil de ese cliente específico.

Evita pasar diferentes user_ids para la misma dirección de correo electrónico, ya que esto creará registros duplicados de clientes.

Los valores de user_id enviados a Intercom deben ser globalmente únicos en todo tu espacio de trabajo. En configuraciones multi-inquilino — donde múltiples inquilinos u organizaciones comparten el mismo espacio de trabajo de Intercom — los IDs de usuario que solo son únicos dentro de un solo inquilino pueden colisionar entre inquilinos, causando que clientes separados se fusionen en el mismo registro de contacto de Intercom.

Para evitar esto, antepone un identificador de inquilino a los valores de user_id antes de enviarlos a Intercom. Por ejemplo, en lugar de enviar "user_123", envía "tenant_abc:user_123".

Nunca asignes valores predeterminados como "undefined" ni uses el mismo user_id para múltiples clientes. Esto causará errores de datos y te impedirá identificar correctamente a clientes individuales.

Si necesitas actualizar un registro de cliente que previamente tenía un user_id desconocido, puedes agregar el identificador correcto más tarde.

Puedes usar la API de Intercom para realizar varias acciones clave para gestionar los IDs de tus clientes. Para detalles completos, consulta nuestro Developer Hub.

Para asegurar una autenticación robusta para clientes conectados, es mejor usar la clave primaria de tu base de datos como user_id en la carga útil del JSON Web Token (JWT).

Si solo tienes una dirección de correo electrónico para identificar a un cliente, debes llenar tanto los atributos user_id como email en la carga útil del JWT con la dirección de correo electrónico del cliente.

Si archivas un atributo user_id personalizado, el campo user_id predeterminado de Intercom no se actualizará automáticamente con esos datos. Será necesario un relleno manual para actualizar los registros.

Si encuentras registros duplicados causados por asociaciones incorrectas entre user_id y correo electrónico, deberás limpiar los registros manualmente o usando la API para fusionarlos o eliminarlos.

Si necesitas actualizar el campo de tu base de datos de usuarios, consulta con tu desarrollador sobre cómo usar la API de Intercom o utiliza el flujo de importación CSV.