Integraciones y Personalización | HubSpot | Guía de Configuración

CheckOP es una plataforma de gestión operativa en campo (Field Management Service Software) que permite a las organizaciones coordinar, supervisar y registrar las actividades de sus equipos en terreno.
La aplicación centraliza procesos como creación de tareas, captura de formularios, seguimiento GPS, control de usuarios, gestión de evidencias multimedia (fotos, documentos, firmas, notas de voz, etc.) y análisis operativo en tiempo real.

La integración de CheckOP con HubSpot conecta las operaciones de campo con los datos comerciales y de servicio del CRM, generando una trazabilidad completa entre las actividades realizadas en terreno y los registros de clientes en HubSpot.

• Sincronización de tareas y formularios con HubSpot: las tareas creadas o completadas en CheckOP pueden vincularse automáticamente con tickets, deals  en HubSpot.

• Envío automático de reportes y evidencias: los reportes operativos, junto con sus archivos adjuntos (PDFs, imágenes, documentos), se publican como notas dentro de HubSpot, vinculadas al registro correspondiente.

• Actualización de estados: los cambios en los estados de tareas o formularios en CheckOP se reflejan en las etapas del pipeline configurado en HubSpot, manteniendo la sincronización operativa.

• Asignación de responsables: los usuarios asignados en CheckOP pueden asociarse con los propietarios en HubSpot, facilitando la alineación entre los equipos de campo y los equipos comerciales o de servicio.

• Relación con clientes y contactos: las tareas o formularios en CheckOP pueden asociarse con los contacts o companies en HubSpot, integrando la información operativa al historial del cliente.

• Georreferenciación operativa: CheckOP permite registrar la ubicación exacta donde se ejecuta una tarea, mediante coordenadas GPS.

  • Aunque el rastreo en tiempo real no se transmite a HubSpot, la app puede utilizar la información de país, ciudad y dirección del cliente registrada en el CRM para calcular automáticamente la latitud y longitud asociadas.

  • Estas coordenadas pueden sincronizarse con HubSpot como propiedades personalizadas (por ejemplo, latitude y longitude) y visualizarse en informes o paneles personalizados.

  • Además, cada registro sincronizado puede incluir enlaces directos a CheckOP, permitiendo que los usuarios de HubSpot accedan con un clic a la información detallada del punto de ejecución en el entorno operativo.

• Visión 360° del cliente: combina la información comercial y de servicio de HubSpot con los datos operativos de campo capturados por CheckOP.

• Automatización y sincronización en tiempo real: evita actualizaciones manuales y mantiene coherencia entre ambas plataformas.

• Trazabilidad completa: todos los reportes, evidencias y estados quedan vinculados a los registros del CRM, facilitando auditorías y seguimiento.

• Contexto geográfico enriquecido: la integración de coordenadas y enlaces de ubicación refuerza la toma de decisiones basada en territorio y optimiza la planificación de operaciones.

• Escalabilidad y flexibilidad: cada empresa puede definir sus propios flujos de trabajo, pipelines y reglas de sincronización según su estructura operativa.

• Transparencia operativa: los usuarios en HubSpot pueden acceder directamente a la información detallada en CheckOP mediante enlaces integrados, garantizando trazabilidad y control total del proceso.

Antes de instalar la aplicación CheckOP, asegúrate de cumplir con los siguientes requisitos:

1. Cuenta activa en HubSpot

   • Debes contar con una cuenta HubSpot con permisos de Super Admin o Administrador de aplicaciones conectadas.

   • La app es compatible con las siguientes ediciones:

     • HubSpot Service Hub

     • HubSpot Sales Hub

     • (versiones Professional o Enterprise recomendadas).

2. Cuenta activa en CheckOP

   • Se requiere una cuenta CheckOP con rol de Administrador o con permisos para configurar integraciones.

   • La integración utiliza las credenciales de autenticación generadas desde el entorno CheckOP.

3. Conexión estable a Internet

   • La sincronización entre CheckOP y HubSpot se realiza en tiempo real o bajo tareas programadas, por lo cual es necesario garantizar conectividad estable durante la configuración inicial.

4. Módulos habilitados en CheckOP

   • Es necesario tener activo el módulo de Formularios y Tareas, ya que son los que permiten enviar información estructurada a HubSpot.

   • El módulo de Rastreo GPS es opcional, pero permite habilitar el registro georreferenciado de las ejecuciones.

5. Datos del cliente correctamente estructurados en HubSpot

   • Para aprovechar las funciones de georreferenciación, los campos de dirección, ciudad y país de los contactos o empresas en HubSpot deben estar completos.

   • Esta información será usada por CheckOP para calcular coordenadas de latitud y longitud, que pueden sincronizarse como propiedades personalizadas.

1. Inicia sesión en https://app.checkop.co.
2. En el menú superior, selecciona:
   Administración → Configuración → HubSpot.
3. En el menú lateral, selecciona:
   HubSpot.

Dentro del panel de configuración se muestran las secciones:

• Configuración Global
  • Configuración Global de Integración
    • Activación
• Logs

En el bloque Activación, realiza lo siguiente:

1. Marca el checkbox “Activar integración”.
   • Estado: ✅ Activo
   • Descripción visible:

“Habilitar o deshabilitar todas las integraciones de HubSpot, esta acción aplica para clientes, tareas y sincronización de propiedades.”

1. Esta acción permite que CheckOP inicie los procesos automáticos de conexión con HubSpot y habilite los endpoints internos para sincronizar datos.

• En el bloque Tipo de aplicación de HubSpot, existen dos opciones:

  • ☐ App privada
  • ☑ App pública (seleccionada por defecto en la configuración actual)

  Seleccionar App pública indica que la autenticación se realiza mediante OAuth 2.0, utilizando un flujo de autorización de HubSpot.

• 1. Ubica el botón “Instalar App”, que enlaza al flujo OAuth de HubSpot.

Al hacer clic en “Instalar App”:

• Se abre el portal de HubSpot para elegir una cuenta o portal de destino.

• El usuario debe iniciar sesión en HubSpot (si no lo está).
• Se muestra la ventana de autorización de permisos de CheckOP.

• Haz clic en “Conectar aplicación”.

Esto redirige automáticamente de vuelta a CheckOP (https://app.checkop.co/hubspot/callback).

• Tras conectar la app en HubSpot y activarse la redirección haz clic en “Vincular cuenta”.

• Finalmente haz clic en “Confirmar”.

• Ahora podrás “Empezar la configuración”.

✅ Resultado esperado:

• El estado de instalación cambia a “Conectada”.

La aplicación solicita permisos (“scopes”) que permiten interacción completa con CRM y objetos:

Después de completar la instalación:

1. Regresa a Configuración → HubSpot.
2. Confirma que:
   • El estado muestra “Activo”.
   • No aparece el mensaje de error “Datos de acceso inválidos”.
   • El botón “Instalar App” cambia a un estado visual de confirmación o deja de mostrarse.

• Mantén activo el checkbox de Activar integración.
• Si cambias el portal de HubSpot o el acceso de OAuth expira, repite el proceso de instalación.
• No compartas tokens ni enlaces OAuth fuera del entorno seguro de CheckOP.

Permitir la correcta configuración del intercambio de datos entre CheckOP y HubSpot, estableciendo cómo se relacionan las propiedades de clientes en ambos sistemas (mapeo) bidireccionalmente y qué registros serán considerados para sincronización desde HubSpot hacia CheckOP (restricciones).

• En el menú superior, selecciona:
  Administración → Configuración → HubSpot.
• En el menú lateral, selecciona:
  HubSpot.

• Dentro del panel de configuración se muestran las secciones:

• Configuración Global
  • Configuración Global de Integración
    • Activación
    • “Integración con clientes”
• Logs

1. Activa la casilla ✅ Activar sincronización de clientes.
2. En el campo “Integrar clientes de CheckOP con objeto de HubSpot”, selecciona el objeto correspondiente:
   • Contactos
   • o Empresas

La sección Mapeo de Propiedades de Clientes permite vincular los campos internos de CheckOP con las propiedades existentes o nuevas de HubSpot.
Debajo, se muestra una tabla con todas las columnas de mapeo 

Cómo realizar el mapeo

• En la columna Propiedad HubSpot (API) haz clic sobre el campo editable.
• Puedes:
  • Seleccionar una propiedad existente
    • Usa el buscador que despliega todas las propiedades disponibles del objeto (por ejemplo, city, address, industry, etc.).
    • Elige la propiedad correcta según el campo de CheckOP.

• • Crear una propiedad nueva directamente desde CheckOP
    • Haz clic en “Crear propiedad”.
    • Completa los campos:
      • Grupo: (por ejemplo, Información del contacto).
      • Nombre visible: “Código DVP”.
    • Presiona Crear ahora para crear la propiedad en HubSpot y vincularla automáticamente

• Aceptar la sugerencia automática
  • Si CheckOP detecta coincidencia (ej. “Ciudad” → city), puedes mantenerla o modificarla.

• Repite este proceso para cada fila de la tabla.
• Presiona Guardar configuración cuando termines.
  

Definir condiciones para limitar qué registros se obtienen desde HubSpot hacia CheckOP, según valores específicos en propiedades del objeto configurado (por ejemplo, contactos).

Esto permite que CheckOP solo traiga los registros que cumplan los criterios definidos, evitando sincronizar información innecesaria.

• En el bloque Restricciones, haz clic en Agregar restricción.

• Se abrirá un panel con dos campos principales:
  • Seleccione una propiedad

• • • Despliega la lista completa de propiedades disponibles en HubSpot (según el objeto).
    • Ejemplo: tipodireccion, country, industry, lifecyclestage, etc.
    • En la vista actual se muestra, por ejemplo:

         address (Street Address) - contactinformation

• • Valor(es) de restricción
    • Ingresa uno o varios valores exactos que esa propiedad debe tener para sincronizarse.
    • Cada valor debe ser el valor interno del campo en HubSpot (no la etiqueta visible).
    • Presiona Enter para agregar múltiples valores tipo etiqueta (tag).
    • Ejemplo:
      • Propiedad: tipodireccion
      • Valores: bo_BillTo, bo_ShipTo
• Haz clic en Guardar.

La restricción se añadirá a la Lista de restricciones.

Debajo de la lista aparecen los botones:

• Guardar configuración (Clientes) → aplica la restricción.
• Descartar → cancela los cambios.

Durante cada proceso de sincronización:

1. CheckOP consulta los objetos configurados en HubSpot (Contactos o Empresas).
2. Antes de importar los datos, aplica las condiciones definidas en el bloque de Restricciones.
3. Solo se obtienen los registros que cumplen todas las condiciones configuradas.
4. Los registros que no cumplen las condiciones se ignoran (no se traen a CheckOP).

💡 Ejemplo ilustrativo según configuración:

• Propiedad: tipodireccion
• Valores: bo_BillTo, bo_ShipTo
  🔁 Solo se sincronizan a CheckOP los contactos de HubSpot cuyo campo tipodireccion contenga uno de esos valores.
  Los demás contactos no se obtendrán durante la sincronización.

Cada restricción existente se puede:

• Editar para modificar la propiedad o los valores permitidos.
• Eliminar para quitar el filtro.

• Las propiedades deben existir en HubSpot con su internal name válido.
• Los valores deben coincidir exactamente (respeta mayúsculas/minúsculas).
• Si hay varias restricciones, CheckOP las combina con un operador lógico AND.
• Estas condiciones solo afectan la obtención de datos desde HubSpot, no el envío.

• Utiliza propiedades de HubSpot con valores bien estandarizados (p. ej., bo_BillTo, bo_ShipTo).
• No uses etiquetas visibles como valores de restricción; siempre usa el valor interno del campo.
• Si deseas sincronizar varios tipos de cliente, agrega los valores como tags separados.
• Documenta internamente las propiedades y condiciones utilizadas para mantener trazabilidad.

• Los campos de clientes de CheckOP quedan correctamente mapeados con las propiedades de HubSpot y trabajarán la sincronización bidireccionalmente.
• Si hay restricciones configuradas, durante la sincronización, CheckOP solo obtiene los registros de HubSpot que cumplen con las condiciones de restricción definidas.
• Se mantiene una integración controlada, eficiente y alineada con los criterios del negocio.

Permitir que cada formulario creado en CheckOP se integre con HubSpot vinculando los registros creados (respuestas de formularios a través de asignación de tareas en CheckOP) a un objeto del CRM con pipeline, como Tickets o Negocios, y definir automáticamente a qué pipeline y etapa deben asignarse los datos enviados y estado de tarea desde CheckOP.

1. En el menú superior, selecciona:
   Operaciones → Formularios
2. Crea un nuevo formulario o elige uno existente y haz clic en “Detalles”

• Dirígete a la pestaña Integración HubSpot.
• Activa el interruptor “Integración de formulario con HubSpot”.
• Se mostrarán las secciones de configuración divididas en bloques:
  • Configuración general
  • Mapeo de propiedades base
  • Mapeo de propiedades del formulario
  • Configuración avanzada

Dentro de Configuración General, se define el objeto destino y las reglas de sincronización.

Campos principales:

Al activar la integración, el usuario puede elegir entre:

• Tickets (Service Hub)
  Ideal para formularios de soporte, incidencias, PQRS o mantenimiento.
• Deals (Sales Hub)
  Adecuado para formularios comerciales o de oportunidades de negocio.

El campo Objeto destino se completa con el nombre del objeto en HubSpot, por ejemplo:

• Tickets
• o Deals

En el campo Pipeline, el usuario puede:

• Seleccionar un pipeline existente sincronizado desde HubSpot (por ejemplo: CheckOP).
• O bien, crear un nuevo pipeline directamente desde CheckOP sin salir de esta interfaz.

➕ Crear un nuevo pipeline desde CheckOP

• Haz clic en Agregar nuevo Pipeline al final de la lista desplegable.
• Se abrirá una ventana modal donde podrás definir:
  • Nombre del nuevo pipeline
  • Etapas del pipeline, cada una con su nombre y orden.

• Guarda los cambios haciendo clic en “Crear Ahora” y CheckOP enviará esta configuración a HubSpot mediante la API correspondiente, creando el pipeline y sus etapas.
• Una vez creado, el pipeline quedará disponible en el campo de selección para asociarlo al formulario actual.

💡 Ejemplo:
Si el formulario pertenece al objeto Tickets, podrás crear un pipeline “Mantenimiento Preventivo” con etapas como:

• Recibido
• En revisión
• Finalizado

Una vez elegido el pipeline, se muestra la tabla de correspondencia entre los estados internos de CheckOP y las etapas del pipeline en HubSpot.

Cada fila permite elegir, mediante un campo desplegable, la etapa del pipeline de HubSpot que corresponde a cada estado operativo de CheckOP.
Esto asegura una sincronización dinámica del progreso de las tareas o formularios.

• Relación con notas de HubSpot

Permite que CheckOP envíe actualizaciones de estado y reportes en formato PDF como notas adjuntas dentro del registro del objeto en HubSpot.
Se configura mediante un identificador de relación tipo:

227 - (Nativa) - HUBSPOT_DEFINED

• Relación con usuarios asignados

Si los usuarios asignados en CheckOP también existen como propietarios en HubSpot:

• • Activa la opción “Relacionar usuarios asignados de tareas con usuarios propietarios en HubSpot”.
  • El campo de usuario debe estar mapeado con la propiedad hubspot_owner_id.
    
    
• Relación con clientes

Si la integración de clientes está activa, se puede relacionar cada envío del formulario con un contacto específico de HubSpot.
El campo de cliente en CheckOP debe estar mapeado con hubspot_client_id.

• Los formularios de CheckOP pueden asociarse a cualquier pipeline de HubSpot o crear uno nuevo.
• Los estados de CheckOP se reflejan directamente en las etapas del pipeline.
• La integración mantiene una relación coherente entre clientes, propietarios y actualizaciones.
• Los pipelines creados desde CheckOP se sincronizan inmediatamente en HubSpot sin requerir pasos adicionales.

Configurar las propiedades base de las tareas asociadas a los formularios integrados con HubSpot en CheckOP, permitiendo definir la correspondencia entre los campos internos de tareas asignadas asociadas a los formularios y las propiedades del objeto de HubSpot seleccionado (por ejemplo, Tickets o Deals).

La sección se encuentra dentro del formulario, bajo la pestaña:

Integración HubSpot → Mapeo de propiedades Base

Esta configuración permite establecer el vínculo directo entre los campos nativos o calculados de CheckOP y las propiedades (API) del objeto destino en HubSpot.
El mapeo define qué dato se enviará o actualizará en HubSpot cuando una tarea o formulario se ejecute desde CheckOP.

En la parte superior se muestra el texto:

“Estas son las propiedades base que CheckOp utiliza para gestionar la creación y actualización de las tareas en sí. Mapea cada propiedad con una propiedad existente en HubSpot o crea una nueva si es necesario.”

Debajo se encuentran los siguientes elementos:

• Campo de búsqueda:
  “Buscar propiedad” — permite filtrar propiedades existentes por nombre API o etiqueta.
• Tabla de mapeo, con las columnas:
  
  

Paso 1. Buscar propiedad existente

Cada fila permite escribir o buscar una propiedad de HubSpot en el campo “Propiedad HubSpot (API)”.
El sistema muestra coincidencias automáticas basadas en las propiedades disponibles en el objeto configurado (Tickets, Deals, etc.).

Ejemplo:

• Si escribes “cliente”, el sistema puede sugerir: hubspot_client_id
• Si escribes “owner”, puede sugerir: hubspot_owner_id
  
  

Paso 2. Seleccionar propiedad compatible o sugerida

Cuando existe una coincidencia, CheckOP muestra la sugerencia con el texto:

“Propiedad sugerida: [nombre_API]”

El usuario puede:

• Seleccionar la propiedad sugerida directamente.
• O dejar el campo vacío si no desea mapear esa propiedad todavía.

Si no existe una propiedad en HubSpot adecuada, es posible crearla directamente desde este campo.

• En el desplegable, al escribir el nombre de la propiedad deseada, aparecerá la opción “Crear propiedad”.
• Al seleccionarla, CheckOP creará la propiedad correspondiente en HubSpot mediante la API, respetando el tipo de dato y grupo del objeto destino.

• Automáticamente, esa nueva propiedad quedará asociada al campo CheckOP.

Paso 4. Guardar configuración

Una vez configuradas las propiedades requeridas, haz clic en:

Guardar configuración de propiedades

El sistema valida que las propiedades obligatorias tengan un valor válido.
Si alguna propiedad obligatoria no está mapeada, se muestra el mensaje:

“Sin Mapear - Propiedad requerida”

Solo después de resolver esas asignaciones el guardado se confirma con el mensaje:

“Configuración guardada correctamente.”

Durante la configuración pueden mostrarse los siguientes textos auxiliares:

• “Sin Mapear - Propiedad requerida” → indica que la propiedad es obligatoria antes de guardar.
• “Propiedad sugerida: [nombre_API]” → muestra una recomendación basada en coincidencia del nombre o tipo.
• “Propiedad Calculada (Solo lectura)” → algunas propiedades no pueden modificarse porque se generan automáticamente desde CheckOP.

• Las propiedades calculadas de CheckOP (por ejemplo, latitud, longitud o marcas de tiempo) no deben editarse manualmente en HubSpot.
• Si se elimina o renombra una propiedad en HubSpot, deberá reconfigurarse en esta tabla antes de sincronizar.
• Las propiedades creadas desde CheckOP conservan el nombre interno (API) para mantener la compatibilidad futura.
• Las propiedades de solo lectura de HubSpot no estarán disponibles para mapearse como destino de escritura (evita errores del tipo READ_ONLY_VALUE).

Una vez completado el mapeo:

• Todas las propiedades base del formulario están asociadas a propiedades válidas del objeto de HubSpot.
• CheckOP puede crear o actualizar registros en HubSpot con los valores definidos.
• Los mensajes de validación desaparecen y el sistema confirma “Configuración guardada correctamente.”

Esta configuración permite que los campos creados en el formulario de CheckOP (los que captura el usuario en campo desde app o web) se sincronicen con propiedades personalizadas en HubSpot, dentro del objeto seleccionado (Tickets o Deals).

Desde esta sección, el usuario puede:

1. Elegir o crear el grupo de propiedades donde se almacenarán los campos del formulario.
2. Crear automáticamente las propiedades correspondientes en HubSpot, respetando tipos de datos y opciones.
3. Ejecutar la acción de sincronización, que crea o actualiza esas propiedades dentro del CRM.

Se accede desde la pestaña:

Integración HubSpot → Mapeo de propiedades Formulario

Aparece después del bloque “Mapeo de propiedades Base”.

Esta sección se utiliza para mapear los campos personalizados del formulario de CheckOP con propiedades en HubSpot, asegurando que la información que llenan los usuarios en campo (por ejemplo, respuestas, fotos, selecciones, notas, etc.) quede disponible dentro del CRM bajo el objeto vinculado (como Ticket o Deal).

Campo:

Grupo
[input de texto con buscador y opción de creación]

Permite seleccionar o crear el grupo de propiedades de HubSpot dentro del objeto actual (por ejemplo, “contactinformation” o “ticket_information”) donde se guardarán las nuevas propiedades generadas a partir de los campos del formulario.

El grupo define la “carpeta” o “categoría” donde HubSpot organizará esas propiedades personalizadas.

💡 Ejemplo práctico:

• • Objeto destino: Tickets
  • Grupo de propiedades: checkop_form_data
    → Todas las propiedades creadas por este formulario se agruparán allí.

Botones disponibles:

• • Guardar grupo → Guarda el grupo de destino seleccionado o creado.
  • Cancelar → Deshace cambios sin guardar.

Sincronización manual

Texto informativo en pantalla:

“Esta acción sincronizará los campos de CheckOp con propiedades de HubSpot de manera automática. Se creará una propiedad en HubSpot para cada campo del formulario que no tenga ya una propiedad establecida. También se actualizarán las propiedades de múltiples opciones con las opciones configuradas en este momento en el formulario.”

Paso 1. Seleccionar el grupo de propiedades

Antes de crear o sincronizar propiedades, es necesario definir en qué grupo de HubSpot se guardarán.

1. En el campo “Grupo”, busca un grupo existente o escribe un nuevo nombre.
2. Si no existe, CheckOP permitirá crearlo directamente desde esta interfaz.
3. Presiona Guardar grupo.

Si el formulario sincroniza con Tickets, las propiedades se crearán en el grupo elegido dentro de ese objeto.

Paso 2. Verificación de compatibilidad

Una vez definido el grupo, CheckOP analiza los campos del formulario y sus tipos (texto, número, lista desplegable, checkbox, fecha, etc.) para determinar cuáles pueden convertirse en propiedades de HubSpot.

• Si ya existe una propiedad con el mismo nombre y tipo, CheckOP la detecta y reutiliza.
• Si no existe, CheckOP la creará automáticamente durante la sincronización.

Paso 3. Crear o actualizar propiedades

Al presionar el botón “Sincronizar”, CheckOP ejecuta una sincronización unidireccional:

🔁 Desde CheckOP hacia HubSpot
(Nunca en sentido inverso)

Durante esta acción:

• Se crea una propiedad en HubSpot por cada campo del formulario que aún no tenga correspondencia.
• Se actualizan las propiedades existentes de tipo múltiple (listas desplegables, selección múltiple o checkbox), alineando las opciones configuradas actualmente en el formulario.
• Se mantienen sincronizados los nombres y tipos de campos, evitando inconsistencias entre ambos sistemas.

Paso 4. Ajustes posteriores

Si el formulario es modificado (por ejemplo, se agrega o elimina un campo, o se cambian las opciones de una lista):

1. Guarda el formulario.
2. Regresa a la pestaña de Integración HubSpot.
3. Pulsa nuevamente “Sincronizar” para que los cambios se reflejen en HubSpot.

Al completar estos pasos:

• Todas las propiedades del formulario en CheckOP tendrán equivalentes en HubSpot.
• Las propiedades estarán organizadas dentro del grupo seleccionado.
• Los cambios posteriores en el formulario (nuevos campos u opciones) podrán replicarse fácilmente con el botón “Sincronizar”.
• La relación de datos se mantendrá actualizada y libre de conflictos entre ambos sistemas.

Documentar la funcionalidad que se habilita dentro del modo de edición del formulario una vez ejecutada la sincronización de propiedades de formulario con HubSpot.
Desde este punto, cada campo del formulario (creado con el editor visual “Drag & Drop”) incorpora una opción llamada “Opciones HubSpot”, que permite revisar y gestionar la propiedad de HubSpot asociada a ese campo.

Para que esta opción esté disponible, deben haberse completado los siguientes pasos en orden:

1. Activar la integración con HubSpot desde la pestaña “Integración HubSpot”.
2. Seleccionar el objeto destino (Tickets o Deals).
3. Definir o crear el grupo de propiedades donde se almacenarán los campos del formulario.
4. Ejecutar la sincronización con el botón “Sincronizar” dentro de la sección Mapeo de Propiedades del Formulario.

Al ejecutar la sincronización, CheckOP crea automáticamente en HubSpot una propiedad por cada campo del formulario (si aún no existía), asignándole un nombre interno único que comienza con el prefijo checkop_.

Una vez sincronizado, al presionar el botón Editar en la parte superior de la pestaña del formulario, CheckOP entra al modo de edición Drag & Drop.

En este modo se pueden:

• Agregar, mover o eliminar campos.
• Editar los títulos, tipos y restricciones de cada campo.
• Y lo más importante: acceder a las Opciones HubSpot de cada campo.

Cada campo del formulario tiene un pequeño botón visible con el texto Opciones HubSpot

Este botón se encuentra junto a otros controles como:

• Mas restricciones
• Eliminar campo

Al hacer clic sobre Opciones HubSpot, se abre un recuadro modal que muestra información de integración específica del campo.

Dentro de esta ventana modal se muestra:

• Al crear un nuevo campo en el formulario, CheckOP genera internamente un identificador.
• Cuando se ejecuta la sincronización con HubSpot, ese campo se convierte en una propiedad real en el CRM, vinculada al grupo de propiedades seleccionado.
• El sistema guarda en cada campo de CheckOP la referencia directa al nombre interno de la propiedad recién creada.

De esta forma:

• Si un usuario abre las Opciones HubSpot, verá reflejado el valor del campo name (API) de la propiedad de HubSpot.

Aunque el sistema permite modificar manualmente el nombre de la propiedad (API Name) dentro del campo “Propiedad en HubSpot”, esto solo debe hacerse si se tiene pleno conocimiento técnico de las propiedades existentes en HubSpot.

Por esta razón, se recomienda seguir esta regla operativa oficial:

Supongamos que el formulario tiene los siguientes campos:

• Campo de texto: HubSpot Test Form 1
• CheckBox: HubSpot Test 2
• Campo de fotos: Fotos test HubSpot Form

Luego de sincronizar, al abrir Opciones HubSpot en cada uno:

Cada una apunta a una propiedad diferente creada en HubSpot dentro del grupo configurado en la integración.

Si el formulario es modificado —por ejemplo, se cambian las etiquetas de las opciones o se agregan nuevos campos— el proceso correcto es:

1. Guardar los cambios del formulario.
2. Ir a la pestaña Integración HubSpot → Mapeo de Propiedades Formulario.
3. Presionar Sincronizar.

Esto asegura que:

• Se creen nuevas propiedades para los campos nuevos.
• Se actualicen las opciones de los campos de selección múltiple o listas desplegables.
• Las propiedades sigan correctamente vinculadas al campo correcto, conservando los nombres internos.

Una vez ejecutada la sincronización y configuradas las propiedades:

• Cada campo del formulario tiene asociada una propiedad válida en HubSpot.
• El botón Opciones HubSpot permite verificar y, si es necesario, editar manualmente la referencia API.
• CheckOP mantiene una relación clara y directa entre su formulario y el CRM, garantizando que los datos ingresados se sincronicen correctamente.

Definir las configuraciones avanzadas disponibles en la integración de un formulario CheckOP con HubSpot, relacionadas con la sincronización de subtareas, la gestión de archivos multimedia y la seguridad en enlaces públicos.

Estas opciones permiten afinar el comportamiento de la integración para casos donde los formularios tienen subtareas asociadas, contenidos multimedia o reportes PDF.

Dentro del formulario, acceder a:

Integración HubSpot → Configuración avanzada

Esta pestaña contiene configuraciones adicionales que controlan cómo CheckOP envía información más compleja (subtareas, archivos, reportes) hacia HubSpot, incluyendo parámetros de seguridad y visibilidad.

La interfaz muestra los siguientes bloques de configuración:

Opción 1:

✅ Las subtareas de tareas asociadas a este formulario viajarán como registros independientes a la integración.

Descripción funcional:

• Cuando esta opción está activada, cada subtarea asociada a una tarea principal en CheckOP se registra en HubSpot como un registro independiente dentro del mismo objeto configurado (por ejemplo, Ticket o Deal).
• Esto permite que HubSpot gestione las subtareas con su propia información, propiedades y estado.

Comportamiento técnico:

• Cada subtarea adopta el mismo esquema de mapeo de propiedades del formulario principal.
• CheckOP envía las subtareas mediante el mismo flujo de sincronización.

Opción 2:

✅ Llevar los reportes PDF de las subtareas a su registro padre en HubSpot.

Descripción funcional:

• Si esta opción está activa, los reportes PDF de las subtareas  se adjuntan directamente al registro principal (la tarea padre) dentro de HubSpot.

Comportamiento técnico:

• Los registros de subtareas continúan existiendo en CheckOP, pero su documentación visual se centraliza en HubSpot para simplificar la gestión.

Opción 3:

✅ Generar enlaces de visualización de los campos con multimedia.

Descripción funcional:

• Activa la generación automática de URLs públicas y seguras para todos los campos multimedia (imágenes, documentos, videos, etc.) cargados en el formulario.
• Estas URLs se incluyen en los registros enviados a HubSpot, de modo que los archivos puedan referenciarse directamente desde el CRM.

Comportamiento técnico:

• CheckOP convierte los archivos cargados en el formulario en enlaces almacenados en su servicio de almacenamiento.
• Los enlaces se asocian a la propiedad del campo correspondiente en HubSpot.
• Los enlaces son públicos únicamente para lectura; no permiten edición o eliminación desde HubSpot.

⚙️ Ejemplo:
Si un campo del formulario permite cargar fotos de inspección, tras sincronizar, en HubSpot se visualizará el enlace directo al archivo.

Opción 4: Contraseña de visualización de enlaces multimedia

Campo:

🔒 Contraseña de visualización de enlaces Multimedia
[Input de tipo password]

Descripción funcional:
Permite establecer una clave de acceso para restringir la visualización de los archivos multimedia compartidos mediante los enlaces públicos generados por CheckOP.

Comportamiento técnico:

• Si se define una contraseña, los enlaces de multimedia incluirán una capa de seguridad adicional que requerirá autenticación previa.
• Esta contraseña es global para todos los enlaces generados desde el formulario actual.
• Puede modificarse en cualquier momento desde esta misma sección.

Al completar esta configuración:

• Las subtareas se sincronizan correctamente con HubSpot según la lógica seleccionada.
• Los archivos multimedia y reportes se publican como enlaces seguros en las propiedades correspondientes.
• Los registros padre e hijo mantienen integridad y trazabilidad.
• Los enlaces públicos respetan la configuración de acceso definida por contraseña.