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

# Código QR de App Deep Link

> Crea un código QR que enlaza directamente a una app móvil.

## Para qué sirve

Un código QR de App Deep Link abre tu app directamente en una pantalla específica, a través de su esquema de URI personalizado, si la app está instalada en el dispositivo que escanea. Si no está instalada, el código recurre a la ficha de tienda de tu app, o como último recurso a una página web sencilla. Es un **Quick Code**: un código QR de acción directa sin página de destino. En la aplicación, la tarjeta correspondiente dice "Open your app directly if it's installed, otherwise fall back to the store."

<Note>
  App Deep Link es **siempre un código QR dinámico**; esto es necesario para que la lógica de resolución (app → tienda → alternativa) pueda ejecutarse al momento del escaneo. Obtienes una URL corta de Scanova (`scnv.io/...`) y puedes vincular un dominio personalizado, pero no tiene página de destino propia.
</Note>

## Orden de resolución

El formulario se organiza en tres secciones, que se verifican en este orden al momento del escaneo:

1. **App instalada**: el dispositivo abre tu app directamente a través del **Android app URI** o **iOS app URI** correspondiente.
2. **App no instalada, sistema operativo reconocido**: el dispositivo se envía al **enlace de tienda** correspondiente (Google Play o Apple App Store), si proporcionaste uno.
3. **Ninguno de los casos anteriores**: quien escanea se envía a la **Fallback web URL** (URL web de respaldo), motivo por el cual ese campo es obligatorio.

## Crear un código QR de App Deep Link

<Steps>
  <Step title="Abrir Create QR Code y elegir Quick Code">
    Desde la barra lateral, ve a **QR Codes** y luego haz clic en **Create QR Code** (o navega a `/qr/create`). Haz clic en la tarjeta **Quick Code**.
  </Step>

  <Step title="Elegir App Deep Link">
    En la cuadrícula de tipos de **Quick Code**, haz clic en **Configure** debajo de **App Deep Link**, en la sección **Dynamic** de la parte superior (este tipo no tiene opción Static). Esto abre el formulario en `/qr/quick/appDeepLink`.
  </Step>

  <Step title="Añadir los URI de tu app">
    En **App URIs**, ingresa al menos uno de **Android app URI** o **iOS app URI**: el esquema personalizado que tu app registra para abrirse directamente (por ejemplo, `myapp://profile`).
  </Step>

  <Step title="Añadir enlaces de tienda (opcional) y una URL de respaldo">
    En **Store links** (Enlaces de tienda), añade opcionalmente tus URL de Google Play y/o Apple App Store, que se muestran cuando la app no está instalada pero el sistema operativo del dispositivo se reconoce. En **Fallback URL**, ingresa una **Fallback web URL**; este campo es obligatorio, ya que es el destino de último recurso para todos los demás casos.

    <Frame caption="El formulario de App Deep Link Quick Code con URI de app, enlaces de tienda y una URL de respaldo ingresados">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/app-deep-link/app-deep-link-quick-code-form.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=fa5c24381e8f34cf1794154ecce881bc" alt="Formulario de App Deep Link Quick Code con URI de app para Android e iOS, enlaces de tienda opcionales, una URL de respaldo obligatoria, y la URL corta autogenerada del código QR dinámico" width="1280" height="1277" data-path="images/v2/qr-codes/create/app-deep-link/app-deep-link-quick-code-form.png" />
    </Frame>
  </Step>

  <Step title="Publicar">
    Haz clic en **Publish**. Se abre un panel para confirmar o cambiar el nombre del código QR, asignar una carpeta o etiquetas, y ajustar el diseño del código QR antes de confirmar.
  </Step>
</Steps>

## Crear uno a través de la API

Para crear un código QR de App Deep Link a través de la API en lugar de la interfaz, usa el ID de categoría `23` (etiquetado como **App Deep Link** en la tabla de referencia **Category dropdown reference** de [Create QR Code](/v1/api-reference/endpoint/qr_manager/create), `allowed_qr_types: "dy"`; solo `"dy"` es válido para `qr_type`). A diferencia de cualquier otra categoría de esta página, el payload `info` aquí es un **array simple** de bloques tipados, no un objeto `{type, data}`:

```json theme={null}
[
  {
    "type": "intentUri",
    "data": [
      { "type": "android", "uri": "acmeapp://profile/42" },
      { "type": "ios", "uri": "acmeapp://profile/42" }
    ]
  },
  {
    "type": "appStore",
    "data": [
      { "type": "playStore", "url": "https://play.google.com/store/apps/details?id=com.acme.app" },
      { "type": "appleStore", "url": "https://apps.apple.com/app/id123456789" }
    ]
  },
  {
    "type": "fallback",
    "data": { "url": "https://acme.com/profile/42" }
  }
]
```

Cada bloque es opcional en principio, pero el `url` del bloque `fallback` es efectivamente obligatorio: publicar sin un fallback falla la validación de la misma forma en que el formulario del panel lo bloquea. Incluye un bloque `intentUri` solo si tienes al menos un URI de app.

Consulta [Create QR Code](/v1/api-reference/endpoint/qr_manager/create) para ver el esquema de solicitud completo.

## Relacionado

* [Código QR de App Store](/es/qr-codes/create/app-store) — una alternativa más simple de "enviar a la tienda" cuando no necesitas enlace profundo dentro de la app.
* [Crear tu primer código QR](/es/getting-started/first-qr-code) — un recorrido completo por el flujo de Quick Code al que pertenece este tipo.
* [Carpetas, etiquetas y operaciones masivas](/es/qr-codes/manage/folders-tags-bulk-operations) — organiza el código QR después de publicarlo.