> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roofkit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Deep links

> Preselecciona marca, material, forma y color antes de que un propietario inicie el visualizador público.

## Contrato de deep link

Las URLs del visualizador público y de embeds soportan cuatro parámetros estables de query que preseleccionan opciones de techo antes de que el propietario interactúe con el visualizador.

| Parámetro | Valor | Ejemplo |
| - | - | - |
| brand | Slug opcional de biblioteca de colores | westlake |
| material | ID de material del catálogo público | lib-tiles |
| shape | Clave estable de forma para el material seleccionado | high\_barrel |
| color | ID de color del catálogo público después del filtrado por material y forma | westlake-fn-barcelona-900-avalonbeachblend |

> [!WARNING]
>
> **Tiles no es un parámetro de query**
>
> Usa material=lib-tiles para techos de teja. No existe un parámetro de query tiles soportado.

## Reglas de resolución

* Los nombres de parámetros van en minúsculas.
* Los valores se recortan y se comparan exactamente.
* Los valores vacíos se ignoran.
* Los parámetros repetidos usan el primer valor no vacío.
* brand se resuelve antes que material, shape y color.
* brand debe estar habilitado para el workspace y activo para el roofer; los valores de brand inválidos vuelven al catálogo de RoofKit.
* Un material inválido descarta shape y color.
* Una forma inválida o incompatible descarta color.
* Un color inválido descarta solo color.
* Las selecciones de shingle no requieren shape; cualquier valor de shape enviado se ignora para shingles.
* Los parámetros inválidos nunca muestran errores al propietario.

## Ejemplos

```text Visualizador independiente theme={null}
https://roofkit.site/v/roofer-123?brand=westlake&material=lib-tiles&shape=high_barrel&color=westlake-fn-barcelona-900-avalonbeachblend
```

```text Visualizador específico de landing theme={null}
https://roofkit.site/v/roofer-123/l/storm-damage?brand=westlake&material=lib-tiles&shape=high_barrel&color=westlake-fn-barcelona-900-avalonbeachblend
```

```text Página host del widget de botón theme={null}
https://contractor.example/roof-replacement?brand=westlake&material=lib-tiles&shape=high_barrel&color=westlake-fn-barcelona-900-avalonbeachblend
```

```text Página host de la instalación inline theme={null}
https://contractor.example/estimate?brand=westlake&material=lib-tiles&shape=high_barrel&color=westlake-fn-barcelona-900-avalonbeachblend
```

```text URL directa del embed theme={null}
https://roofkit.site/embed/v/roofer-123/l/storm-damage?brand=westlake&material=lib-tiles&shape=high_barrel&color=westlake-fn-barcelona-900-avalonbeachblend
```

```text Landing con dominio personalizado theme={null}
https://visualizer.contractor.example/l/storm-damage?brand=westlake&material=lib-tiles&shape=high_barrel&color=westlake-fn-barcelona-900-avalonbeachblend
```

## Notas de implementación

Para el widget de botón y el script inline de una línea, agrega los parámetros de deep link a la URL de la página host del contratista. RoofKit reenvía esos parámetros al iframe. Una URL directa de embed sigue aceptando los mismos parámetros.

> [!TIP]
>
> **Fuente de verdad del catálogo**
>
> Los valores válidos deben venir del catálogo público activo para el workspace y el roofer. Al usar brand, confirma que la biblioteca de colores esté habilitada para el workspace y activa para el roofer.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.