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

# Marketplace e integraciones

> Explora e instala apps del marketplace (OAuth), lista operadores y equipos de Connect, y administra el catálogo de Jelou Shop desde el CLI.

## `jelou marketplace`

Explora, busca e instala apps OAuth del marketplace (Shopify, HubSpot, Slack…)
para tu organización.

| Subcomando       | Descripción                                                       |
| ---------------- | ----------------------------------------------------------------- |
| `list`           | Explora las apps disponibles (busca o filtra a instaladas)        |
| `install <slug>` | Instala una app por slug (abre el navegador para autorizar OAuth) |

```bash theme={null}
jelou marketplace list
jelou marketplace list --search "shopify" --json
jelou marketplace list --installed-only
jelou marketplace install hubspot
jelou marketplace install slack --print-url           # flujos headless/SSH
jelou marketplace install shopify --metadata '{"shopify":{"shop":"mitienda.myshopify.com"}}'
```

| Flag                | Descripción                                                                                     |
| ------------------- | ----------------------------------------------------------------------------------------------- |
| `--search <q>`      | Filtra por nombre o descripción                                                                 |
| `--installed-only`  | Solo apps ya instaladas                                                                         |
| `--print-url`       | Imprime la URL OAuth en lugar de abrir el navegador                                             |
| `--metadata <json>` | Metadata requerida por algunas apps (ej. la tienda de Shopify)                                  |
| `--timeout <seg>`   | Timeout del sondeo OAuth (default 120)                                                          |
| `--limit <n>`       | Máximo de resultados (default 20)                                                               |
| `--wait`            | En modo `--json`, espera hasta que la app quede instalada (o `--timeout`) e informa `installed` |

<Warning>
  Instalar otorga scopes OAuth de larga duración sobre los datos de tu
  organización; revocar es un proceso de varios pasos en el dashboard (no por
  CLI). Si un slug coincide con varias apps, el CLI pide elegir. Algunas apps
  (Shopify, etc.) requieren `--metadata` específico de la app.
</Warning>

## `jelou connect`

Lista operadores y equipos del producto Connect (flujos de derivación a
humanos).

```bash theme={null}
jelou connect operators list                       # operadores activos
jelou connect operators list --include-inactive    # incluye eliminados/inactivos
jelou connect teams list --json
jelou connect operators list --json --out operadores.json
```

* **Operadores** son usuarios individuales con rol de operador.
* **Equipos** son grupos de operadores para enrutamiento por equipo.
* El `id` del operador es el que se referencia en un nodo CONNECT de un workflow
  (`configuration.operatorId`).

## `jelou shop`

Administra Jelou Shop: activación por empresa, configuración, sucursales,
categorías, productos e importaciones de catálogo.

| Grupo            | Subcomandos                                                     |
| ---------------- | --------------------------------------------------------------- |
| Setup            | `info`, `activate`, `settings`                                  |
| Sucursales       | `branches list/show/create/update/delete`                       |
| Categorías       | `categories list/create/update/delete`                          |
| Productos        | `products list/show/upsert/update/status/delete`                |
| Catálogo externo | `accounts`, `syncs <accountId>`, `imports template/upload/show` |

```bash theme={null}
jelou shop activate --name "Mi Tienda" --contact-mail "soporte@example.com"
jelou shop settings --currency USD --tax-value 15
jelou shop products list --stock in_stock --search "zapato" --json
jelou shop products upsert --file productos.json --sync
jelou shop imports template --lang es --output plantilla.xlsx
jelou shop imports upload --file productos.xlsx --uploaded-by "alex"
```

<Note>
  `shop activate` usa la credencial de tu `jelou login` (tu API key de Jelou) — no
  requiere una clave de bootstrap aparte. Solo se permite **una activación por empresa** y se niega a
  sobrescribir una activación existente bajo `--no-input`. `products upsert` crea
  o actualiza productos por SKU; usa `--sync` para esperar el resultado.
</Note>