Ir al contenido principal

🚀 Configuración de la integración con Smartbuild

Cree trabajos automáticamente en Smartbuild cada vez que se envíe un diseño a través de su configurador de IdeaRoom.

Ver video de demostración

💡 ¿Quién puede usarlo?

  • Clientes que hayan adquirido el complemento de integración con Smartbuild

  • Clientes de Post Frame, Red Iron y Carport

💡 ¿Por qué usarlo?

  • Crea automáticamente un trabajo en Smartbuild a partir de los diseños enviados

  • Aumenta la cantidad de prospectos generados

  • Ahorra tiempo y elimina el trabajo manual

✅ Antes de empezar

Asegúrese de lo siguiente:

  • Tiene acceso de administrador a IdeaRoom SalesView

  • Tiene una cuenta activa en Smartbuild con acceso a la API

  • Distribuidores:

    • Su proveedor ha activado Smartbuild en su conjunto de datos

    • Sabe si usará la asignación de SKU del proveedor o creará la suya propia

⚠️ Asegúrese de que el usuario de Smartbuild tenga habilitados los permisos de usuario canEditDistributor. Sin esta configuración de permisos, IdeaRoom no puede crear un trabajo en Smartbuild.

🔧 Cómo configurarlo

1. Activar Smartbuild (Distribuidores/Constructores)

  • Vaya a Admin > Sites > Integrations

  • Seleccione la tarjeta de integración Smartbuild Systems

  • Seleccione el proveedor del menú desplegable, si tiene varios proveedores en IdeaRoom

  • Asegúrese de que la opción Use Supplier Mapping esté marcada.

    • La usará en la mayoría de los casos, a menos que tenga requisitos de datos únicos en Smartbuild

  • Ingrese su nombre de usuario y contraseña de Smartbuild

    • Asegúrese de que su nombre de usuario tenga acceso de administrador

  • Guarde

📝 Repita el proceso para cada proveedor.

2. Activación del proveedor (solo proveedores)

  • Vaya a Sites > Integrations

  • Seleccione la tarjeta de integración Smartbuild Systems

  • Ingrese su nombre de usuario y contraseña de Smartbuild

    • Asegúrese de que su nombre de usuario tenga acceso de administrador

  • Guarde

  • Una vez guardado, seleccione nuevamente la tarjeta de integración y seleccione Go to Mapping

3. Configurar la asignación de SKU

  • Vaya a Product Catalogs

  • Seleccione Smartbuild Mapping

  • Comience la asignación seleccionando cada categoría

  • Use el botón Map Items para asignar automáticamente cualquier SKU de Smartbuild que coincida con las claves de IdeaRoom.

  • Si no se encuentra una asignación automática, asigne sus elementos manualmente

  • Seleccione Preview, envíe un diseño. Confirme que se creó un trabajo en Smartbuild

  • Haga clic en Publish

Nota sobre la asignación: colores y apertura de puertas

  • Algunos usuarios de SmartBuild crean SKU únicos para cada combinación de componente, color y apertura (por ejemplo, una puerta blanca-36×80-RHI frente a una puerta gris-36×80-LHO).

    • El color y la apertura de un componente en IdeaRoom se definen en tablas separadas y se consideran atributos adicionales.

    • Solo podemos asignar una opción de componente de IdeaRoom a un SKU de Smartbuild.

  • Recomendación: asigne a un SKU de color y apertura predeterminado (como blanco o RHI) y actualice la configuración más adelante en Smartbuild.

4. Publicar para entrar en funcionamiento

  • Una vez publicado, los trabajos de Smartbuild se crearán automáticamente para cada diseño enviado 🎉

Opciones avanzadas de asignación de usuarios

Para facilitar la asignación manual, la interfaz proporciona varios menús que incluyen únicamente las opciones esenciales necesarias para que la integración funcione correctamente. Hemos creado dos potentes opciones que permiten a los usuarios avanzados asignar opciones que actualmente no están disponibles a través de la interfaz de asignación estándar: Custom Location y Custom Options.

Custom Locations

El menú Custom Locations está destinado a usuarios avanzados que necesitan ajustar con precisión la integración con SmartBuild para cumplir con requisitos específicos.

Descripción general de las columnas de Custom Locations

La tabla a continuación ofrece una breve descripción de cada columna de este menú y su propósito:

  • Enabled – Un valor booleano que especifica si se debe aplicar la fila de asignación.

  • Location – Un valor de enumeración que define dónde se debe usar la asignación en la solicitud para crear un nuevo trabajo en SmartBuild.

  • Question – Un campo de texto que contiene el identificador de la pregunta de SmartBuild que se incluirá en la solicitud de creación del trabajo.

  • Answer – Un campo de texto que contiene la respuesta a la pregunta de SmartBuild correspondiente que se incluirá en la solicitud de creación del trabajo.

  • Expression – Una expresión condicional basada en el estado actual del diseño de IdeaRoom. Cuando se evalúa, determina si esta asignación se debe incluir en la solicitud de creación del trabajo.

  • Priority – Un valor numérico que define la precedencia de esta asignación cuando existen varias asignaciones para la misma pregunta. Los valores más altos tienen prioridad.

Descripción general de Custom Locations

La tabla a continuación describe cada ubicación admitida y su propósito:

  • customer-email – Especifica qué pregunta de SmartBuild debe recibir el correo electrónico del cliente proporcionado en el configurador de IdeaRoom.

  • customer-phone – Especifica qué pregunta de SmartBuild debe recibir el teléfono del cliente proporcionado en el configurador de IdeaRoom.

  • gable-end-sub-fascia – Proporciona una respuesta a una pregunta de SmartBuild que se aplica únicamente cuando la sección central del edificio incluye un alero delantero o trasero.

  • side-wall-sub-fascia – Proporciona una respuesta a una pregunta de SmartBuild que se aplica únicamente cuando la sección central del edificio incluye un alero izquierdo o derecho.

  • main-height – Anula la pregunta de SmartBuild que recibe la altura de la sección central. Si no se proporciona ningún valor, se usa de forma predeterminada la altura de la sección central. La pregunta estándar de SmartBuild para esto es CeilingHeight.

  • project-name – Especifica qué pregunta de SmartBuild debe recibir el nombre del proyecto. La respuesta puede incluir las siguientes claves de interpolación: versionedEmailId, orderNumber, firstName, lastName, fullName.

    • Ejemplo: IR Order for {{fullName}} (#{{versionedEmailId}})

  • shed – Proporciona una respuesta a una pregunta de SmartBuild que se envía a los cobertizos. Smartbuild usa sheds para identificar un edificio adjunto o un porche (equivalente a leans en IdeaRoom).

  • shipping-address – Especifica qué pregunta de SmartBuild debe recibir la dirección de envío del configurador de IdeaRoom.

  • shipping-city – Especifica qué pregunta de SmartBuild debe recibir la ciudad de envío del configurador de IdeaRoom.

  • shipping-phone – Especifica qué pregunta de SmartBuild debe recibir el teléfono de envío del configurador de IdeaRoom.

  • shipping-state – Especifica qué pregunta de SmartBuild debe recibir el estado de envío del configurador de IdeaRoom.

  • shipping-zip – Especifica qué pregunta de SmartBuild debe recibir el código postal de envío del configurador de IdeaRoom.

Cuándo usar Custom Locations

  • Use Custom Options únicamente si la interfaz de asignación de IdeaRoom/SmartBuild no admite la opción que necesita.

  • Esto se recomienda para clientes avanzados que requieren un control preciso sobre las asignaciones.

Ejemplo 1: Configuración de leans adjuntos en Custom Location

Algunos clientes requieren que ciertas configuraciones se establezcan de forma predeterminada en los leans o porches adjuntos. Puede usar la tabla Custom Location para establecer esas configuraciones específicas según sea necesario. En este ejemplo, vamos a asignar el valor predeterminado para Match Heel, Overhang Style y Slab offset en los leans adjuntos.

Pasos para configurarlo:

  1. Location: shed

  2. Question: MatchHeelHeight

  3. Answer: true

  4. Expression: (no se necesita ninguna)

  5. Priority: (establézcala en 1 si las configuraciones no se aplican)

Repita estos pasos para las demás preguntas y consulte la imagen a continuación para ver un ejemplo de la configuración final esperada.

Consideraciones de Smartbuild para Carports

Paredes parciales

  • Para que IdeaRoom pueda enviar paredes parciales a Smartbuild, debe establecer NoCombineWalls en false en customLocation. Esto también activa la integración para informarnos de que su cliente es un cliente de carports.

Alturas

  • Smartbuild ofrece dos estilos de medición de la altura del techo: Ceiling Height y Top of Wall Material. Esto determina el método utilizado para calcular la altura del edificio. De forma predeterminada, nuestra integración con Smartbuild usa Ceiling Height, ya que esto es lo que usa la mayoría de los clientes de Post Frame.

  • Si su cliente usa Top of Wall Material, debe establecer main-height en la tabla customLocation con RoofHeight Style = EaveLine y dejar en blanco la respuesta de EaveLine, para que enviemos la altura seleccionada correctamente. (consulte la imagen)

  • NOTA: algunos clientes de Post-Frame pueden usar Top of Wall Material; si lo hacen, deberá agregar las actualizaciones de main-height mencionadas en la viñeta anterior.

Custom Options

El menú Custom Options permite a los usuarios avanzados crear asignaciones entre IdeaRoom y SmartBuild que no se admiten a través de la interfaz de asignación estándar.

Use esta función únicamente cuando la asignación estándar no proporcione la asignación específica que necesita.

Descripción general de las columnas de Custom Options

Cada fila de la tabla Custom Options define una regla de asignación:

  • Enabled – Valor booleano (true/false) que determina si la fila está activa.

  • Option Key – La clave única que IdeaRoom usa para identificar la opción.

  • Option Type – La categoría o el tipo de opción en IdeaRoom.

  • Question – El identificador de la pregunta de SmartBuild que se incluirá en la solicitud del trabajo.

  • Answer – El valor que responde a la pregunta de SmartBuild en la solicitud del trabajo.

  • Expression – Una condición basada en el estado actual del diseño de IdeaRoom. Si es verdadera, se aplica la asignación. (Deje en blanco si no es necesaria.)

  • Priority – Un número que determina la precedencia cuando existen varias asignaciones. Los valores más altos tienen prioridad.

Cuándo usar Custom Options

  • Use Custom Options únicamente si la interfaz de asignación de IdeaRoom/SmartBuild no admite la opción que necesita.

  • Esto se recomienda para clientes avanzados que requieren un control preciso sobre las asignaciones.

Ejemplo 1: Superficie de instalación en Custom Options

La opción installation-surface no está disponible en la interfaz de asignación estándar, pero puede configurarla mediante Custom Options. En este ejemplo, asignaremos la superficie de cemento a un paquete específico para que seleccione este paquete en SmartBuild de forma predeterminada cuando se cree un trabajo.

Pasos para configurarlo:

  1. Busque la clave de opción de IdeaRoom para installation-surface en Product Catalog (View Only).

  2. Pegue la clave en la columna Option Key.

  3. Seleccione installation-surface en la columna Option Type.

  4. Ingrese el identificador de la Question de SmartBuild correspondiente.

  5. Ingrese el valor de la Answer de SmartBuild coincidente.

  6. (Opcional) Agregue una condición en la columna Expression. La mayoría de las veces se deja en blanco.

  7. Establezca la Priority en 1 para asegurarse de que tenga precedencia.

Consulte la imagen a continuación para ver un ejemplo de la configuración final esperada.

Esto garantiza que SmartBuild reciba y establezca la superficie de instalación correcta cuando se cree un trabajo.

⚠️ Use el menú desplegable Question para seleccionar el atributo de la pregunta que necesita. Luego use el menú desplegable Answer para elegir entre las opciones disponibles para esa pregunta. Si el menú desplegable Answer no muestra ninguna opción, la pregunta requiere una respuesta de texto en su lugar.

Product Systems

Use la tabla de categoría Custom Product Systems para asignar sus sistemas de productos.

Funciones no compatibles

Es posible que deba deshabilitar o refactorizar las siguientes opciones para evitar errores:

  • Storage Units – No compatible. Dejarlas activas provoca errores de integración como: “Unexpected section [center-section] and wall key [back-storage / undefined].”

    • Deshabilite todos los almacenamientos para los clientes integrados con Smartbuild.

  • Combo Units – Debido a que SB no admite almacenamientos, las unidades combo no son directamente compatibles. Para lograr un aspecto similar, refactorice la unidad combo eliminando el almacenamiento y agregando un front lean-to en la sección central.

  • Weathervanes – No compatibles en SB. Elimínelas de las configuraciones.

  • HayRoofs – No compatibles en SB. Elimínelos de las configuraciones.

  • Crows Feet – No compatibles en SB. Elimínelos de las configuraciones.

  • Mezzanines - No compatibles en SB. Elimínelos de las configuraciones o encuentre una solución alternativa para avisar al usuario de ventas de SB.

Asignación de datos para opciones de IdeaRoom que no tienen una tabla de categoría de Smartbuild

  • Interior Walls - se envían automáticamente mediante código

  • Ceilings - se envían automáticamente mediante código, pero si se necesitan ajustes, se pueden hacer mediante la tabla customOptions

  • Overhangs - se envían automáticamente mediante código.

  • Eaves - se envían automáticamente mediante código.

  • Roof Pitch - se envía automáticamente mediante código.

  • Insulation - Debe asignarse mediante la tabla customOption.

  • Floors - no se envían automáticamente, deben asignarse en customOptions

  • Porch Roofs/Awnings - se envían automáticamente. No obstante, Smartbuild no admite Hay Roofs. Consulte Funciones no compatibles más arriba.

  • Wainscot - se envía automáticamente mediante código.

  • Mezzanines - No los enviamos a Smartbuild. Consulte Funciones no compatibles más arriba.

  • Additional Options - Deben asignarse mediante la tabla customOption.

  • Dormers - se envían automáticamente mediante código. Si el dormer corta el techo, la columna setbackAmountFromWall de la tabla dormerComponent debe ajustarse a un mínimo de 0.1 - Si es mayor que 0.1, no se necesita ninguna acción. Esto debe ajustarlo IdeaRoom.

  • Vents - Si los respiraderos se envían a Smartbuild, deben agregarse a la tabla Windows en IdeaRoom porque Smartbuild requiere un ancho y una altura especificados para renderizar. Esto debe ajustarlo IdeaRoom.

Cómo elegir qué cuenta de Smartbuild usar

  • Recomendamos que todos los clientes creen o usen una cuenta de SB que solo se utilice para la integración.

  • Asegúrese de que la cuenta solo tenga acceso a un único distributorName.

  • Smartbuild cobra por cada cuenta creada, pero no le cobrarán a un cliente por una cuenta si se usa específicamente para la integración. Notifique a Smartbuild cuando creen la nueva cuenta para que no le cobren.

Cómo resolver fallas de conexión de la cuenta de API

Si la conexión a la API de Smartbuild falla, a menudo se debe a una de estas dos razones:

  1. Caracteres especiales en el nombre de usuario de la integración.

    1. Ejemplo de correo electrónico incorrecto: csmith+idearoom@test.com falla debido al “+”.

    2. Cómo solucionarlo: Codifique los caracteres especiales antes de usarlos. Ejemplo de correo electrónico corregido: csmith%2Bidearoom@test.com

    3. Nota: Las direcciones de correo electrónico pueden incluir caracteres especiales, pero el nombre de usuario de la integración no debe incluirlos (a menos que estén codificados).

  2. Permisos insuficientes en la cuenta de usuario de Smartbuild

🧠 Preguntas frecuentes y resolución de problemas

  • ¿Por qué no veo la tarjeta de integración de Smartbuild en la página Sites > Integrations?
    → Es posible que su administrador aún no haya adquirido el complemento. Confírmelo con él.

  • ¿Puedo usar mi propia asignación?
    → ¡Sí! Las asignaciones creadas por el distribuidor anulan las del proveedor. Tenga cuidado al elegir esta opción; configure su propia asignación personalizada únicamente si realmente tiene escenarios únicos que no admite la asignación de su proveedor.

  • ¿No se creó ningún trabajo en Smartbuild?
    → Verifique:

    • ¿Está publicada la asignación?

    • Asegúrese de que el usuario tenga habilitados los permisos canEditDistributor en Smartbuild

    • Asegúrese de que el botón de envío que está usando esté habilitado para crear trabajos a través de SalesView | Sites | Workflows

    • ¿Hay algún SKU sin asignar?

    • ¿Son correctos su nombre de usuario y contraseña?

  • ¿Por qué mis Product Systems no se asignan correctamente?
    → Es posible que deba asignarlos en Custom Options para que funcionen correctamente. Consulte el Ejemplo 2 de Custom Options más arriba

  • ¿Dónde encuentro las OptionKeys de IdeaRoom para usar en la función Custom Option?
    → Cuando selecciona un optionType, los optionKeys disponibles se completarán automáticamente

Nota: Esta traducción fue generada por inteligencia artificial y puede contener errores.

Artículos relacionados
Notas de la versión
Integración de IdeaRoom con HubSpot
Crear un trabajo de SmartBuild mediante API
Agregar la URL de diseño de IdeaRoom a un trabajo de Smartbuild
¿Ha quedado contestada tu pregunta?