> ## 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 integrações

> Explore e instale apps do marketplace (OAuth), liste operadores e equipes do Connect, e administre o catálogo do Jelou Shop pela CLI.

## `jelou marketplace`

Explore, busque e instale apps OAuth do marketplace (Shopify, HubSpot, Slack…)
para a sua organização.

| Subcomando       | Descrição                                                        |
| ---------------- | ---------------------------------------------------------------- |
| `list`           | Explora as apps disponíveis (busca ou filtra para as instaladas) |
| `install <slug>` | Instala uma app por slug (abre o 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           # fluxos headless/SSH
jelou marketplace install shopify --metadata '{"shopify":{"shop":"mitienda.myshopify.com"}}'
```

| Flag                | Descrição                                                                                  |
| ------------------- | ------------------------------------------------------------------------------------------ |
| `--search <q>`      | Filtra por nome ou descrição                                                               |
| `--installed-only`  | Apenas apps já instaladas                                                                  |
| `--print-url`       | Imprime a URL OAuth em vez de abrir o navegador                                            |
| `--metadata <json>` | Metadata exigida por algumas apps (ex. a loja do Shopify)                                  |
| `--timeout <seg>`   | Timeout da sondagem OAuth (padrão 120)                                                     |
| `--limit <n>`       | Máximo de resultados (padrão 20)                                                           |
| `--wait`            | No modo `--json`, aguarda até a app ficar instalada (ou `--timeout`) e informa `installed` |

<Warning>
  Instalar concede escopos OAuth de longa duração sobre os dados da sua
  organização; revogar é um processo de várias etapas no dashboard (não pela
  CLI). Se um slug corresponder a várias apps, a CLI pede para escolher. Algumas apps
  (Shopify, etc.) exigem `--metadata` específico da app.
</Warning>

## `jelou connect`

Lista operadores e equipes do produto Connect (fluxos de transferência para
humanos).

```bash theme={null}
jelou connect operators list                       # operadores ativos
jelou connect operators list --include-inactive    # inclui excluídos/inativos
jelou connect teams list --json
jelou connect operators list --json --out operadores.json
```

* **Operadores** são usuários individuais com papel de operador.
* **Equipes** são grupos de operadores para roteamento por equipe.
* O `id` do operador é o que se referencia em um nó CONNECT de um workflow
  (`configuration.operatorId`).

## `jelou shop`

Administre o Jelou Shop: ativação por empresa, configuração, filiais,
categorias, produtos e importações de catálogo.

| Grupo            | Subcomandos                                                     |
| ---------------- | --------------------------------------------------------------- |
| Setup            | `info`, `activate`, `settings`                                  |
| Filiais          | `branches list/show/create/update/delete`                       |
| Categorias       | `categories list/create/update/delete`                          |
| Produtos         | `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 a credencial do seu `jelou login` (sua API key da Jelou) —
  não requer uma chave de bootstrap à parte. Apenas **uma ativação por empresa** é permitida e ele se recusa a
  sobrescrever uma ativação existente sob `--no-input`. `products upsert` cria
  ou atualiza produtos por SKU; use `--sync` para esperar o resultado.
</Note>