La integración de Custom CRM te permite conectar Enginy con tu propio sistema CRM o base de datos interna. Esta opción está diseñada para equipos que utilizan un sistema propietario o personalizado que no está incluido en las integraciones estándar de Enginy.

Una vez conectado, Enginy puede interactuar con tu CRM de las siguientes maneras:

Para la especificación completa de los endpoints, consulta la Custom CRM API Reference.
​

Tu CRM debe aceptar autenticación por API key mediante un header configurable. Al conectar, deberás proporcionar los siguientes parámetros:

Enginy incluye tu API key header en cada petición enviada a tu CRM. Por ejemplo:
​

Cuando está configurado, Enginy puede generar enlaces clicables que abren registros de contactos y empresas directamente en tu CRM. Para habilitarlo, proporciona plantillas de URL al conectar — usando {{crmId}} como marcador que será reemplazado por el ID real del registro:
​

Por ejemplo, la plantilla https://mycrm.com/contacts/{{crmId}} se convierte en https://mycrm.com/contacts/ABC123 cuando Enginy genera el enlace. Si no se proporcionan plantillas, la opción "Open in CRM" no estará disponible para los registros de Custom CRM.
​

Si tu CRM permite asignar usuarios o propietarios a contactos, empresas, tareas y actividades, puedes implementar el endpoint opcional /users para habilitar la selección de propietario en Enginy.
​

Cada vez que Enginy necesita obtener propietarios, testea automáticamente tu endpoint /users. El comportamiento depende de la respuesta:

Cuando los usuarios están disponibles, Enginy muestra un desplegable de propietario en el modal de exportación, la creación de tareas y el registro de actividades. Puedes añadir o eliminar el endpoint /users en cualquier momento — la detección ocurre de forma dinámica en cada petición, no solo en la conexión inicial.
​

Tu endpoint /users debe devolver un array de usuarios con el siguiente formato:
​

Sigue estos pasos para conectar tu Custom CRM a Enginy a través de la API.
​

Antes de conectar, asegúrate de que tu CRM implementa todos los endpoints requeridos listados en la sección de Requisitos previos. Consulta la Custom CRM API Reference para las especificaciones completas.
​

Usa el endpoint de test para validar tu configuración antes de conectar:
​

Una vez conectado, puedes exportar contactos y empresas desde Enginy a tu Custom CRM:

Este paso define cómo Enginy relaciona contactos y empresas con los registros de tu CRM para evitar duplicados y garantizar la integridad de los datos. Una sincronización significa que Enginy compara sus registros con los de tu CRM usando los identificadores que configures aquí.

Muestra la dirección de correo electrónico del usuario de la integración API.
​

Elige cómo Enginy determina si un contacto ya existe en tu CRM.

Elige cómo Enginy determina si una empresa ya existe en tu CRM.

En la sección General encontrarás dos toggles que controlan cómo se gestionan las asociaciones durante la exportación:

Este paso configura qué campos de Enginy se mapean a qué campos de tu CRM al exportar datos. La configuración se divide en dos pestañas — Contacts y Companies — y el funcionamiento del mapeo es el mismo en ambas.

Al exportar manualmente un contacto o empresa, puedes elegir el Association Type en el modal de exportación. La configuración de la integración define el tipo de asociación predeterminado, pero puedes cambiarlo en cada exportación manual.
​

También puedes: sobrescribir valores existentes para cualquier mapeo de campo (en la pestaña Contacts o Companies), sobrescribir el propietario en el CRM, establecer opcionalmente los Manual export field values, y activar Export associated companies (o Export associated contacts al exportar manualmente una empresa).

Este paso te permite sincronizar propiedades específicas de campaña con tu CRM. No son campos estándar de lista; son propiedades vinculadas a la actividad de campaña.
​

Este paso final define las asociaciones entre los usuarios/identidades de Enginy y los usuarios de tu CRM para que las exportaciones y los registros de actividad se atribuyan a las personas correctas.

Una Identity en Enginy es el perfil que ejecuta una campaña (por ejemplo, un perfil de LinkedIn o un remitente de email). Identities Mapping vincula cada identidad de Enginy con un usuario de tu CRM.
​

Cuando una campaña — que siempre está vinculada a una identidad — realiza una sincronización o exportación, el registro de actividad de tu CRM muestra al usuario del CRM asociado como el que ejecutó la acción.
​

Users Mapping vincula una cuenta de usuario de Enginy con un usuario de tu CRM. Esto establece el propietario predeterminado para cualquier registro exportado por ese usuario — incluso para exportaciones automáticas mediante mapeos de campo, no solo exportaciones manuales.
​

Este mapeo establece un propietario predeterminado (propietario de contacto o empresa) para las exportaciones realizadas por un usuario de Enginy que no está mapeado en User Mapping.
​

Una vez completados los cuatro pasos, haz clic en Update para guardar la configuración de tu Custom CRM.
​

Para desconectar tu Custom CRM en cualquier momento, usa la siguiente llamada a la API:
​