Marketplace e integrações

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

Verifica se os nós de pagamento de um workflow cobram como foram configurados, antes de publicar ou entregar. Verifica cada nó de pagamento separadamente e para no primeiro teste que falhar.

Verificação	O que verifica
Contrato	Os inputs do nó e a versão da tool de pagamentos contra o catálogo de gateways, igual a `jelou workflow validate` e `jelou push`
Saídas	Se as saídas que o nó usa existem nessa versão
Instalação	Se o gateway do nó está instalado e conectado no marketplace
Empresa	Se o JelouPay está ativado e a empresa tem seu app de workflows
Credenciais	Se os secrets do gateway existem (não se aplica no modo de teste)
Ambiente	Se o nó e a instalação estão no mesmo ambiente (teste ou produção)
Link de pagamento	Se o gateway gera um link de pagamento real com dados fictícios de comprador

jelou payments verify 1234                    # todos os nós de pagamento do workflow 1234
jelou payments verify workflows/cobro.json    # um workflow local
jelou payments verify 1234 --node cobro-stripe
jelou payments verify 1234 --json             # resultado por nó: verificações, avisos e falha

Flag	Descrição
`--node <id>`	Verifica só esse nó de pagamento
`--installation <id>`	Instalação a usar quando o nó não indica a sua e o gateway tem várias
`--live`	Gera o link de pagamento também em nós de produção
`--amount <valor>`	Valor da cobrança de teste (padrão 1)
`--currency <código>`	Moeda da cobrança quando o nó a obtém da conversa; se o nó tem uma moeda fixa, ela é mantida

O comando termina com exit code 0 se todos os nós passam, 2 se há um erro de configuração, 4 se a autenticação falha e 6 se um serviço não respondeu (tente novamente).

O link de pagamento não cobra nada: cria um pedido pendente marcado como verificação, e o resultado mostra só o domínio do link, nunca o link completo nem o valor dos secrets. No modo de teste não consome seus testes, porque só contam os pagamentos concluídos.

Em produção, o link de pagamento é omitido a menos que você passe --live. Com --live, o pedido de teste aparece como pendente no Payment Hub do negócio.

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

Primeiros Passos

Desenvolvedor

Jelou CLI

Mensagens Outbound

Caixa de entrada

Marketplace

Canais

Configuração

Faturamento

Marketplace e integrações

`jelou marketplace`

`jelou payments`

`jelou connect`

`jelou shop`

​jelou marketplace

​jelou payments

​jelou connect

​jelou shop

`jelou marketplace`

`jelou payments`

`jelou connect`

`jelou shop`