Marketplace e integrações - Jelou AI Docs

`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)

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`

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.

`jelou connect`

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

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`

jelou shop activate --name "Mi Tienda" --contact-mail "[email protected]"
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"

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.

⌘I