P7.1 · App público na Nuvemshop

Depende de P1.1 e P1.3. **É o canal de menor CAC do plano inteiro.**

O prompt

Publique o Raio-X da Loja como app gratuito na loja de aplicativos da Nuvemshop. Instalação orgânica, com intenção máxima, custo zero.

1. O que é publicado

Só o Raio-X grátis. Radar de Preço, Radar de Anúncios e Hub aparecem dentro do app como upgrade, não na vitrine.

App gratuito passa na revisão mais rápido, tem mais instalação, e a monetização acontece depois, dentro do produto.

2. Requisitos técnicos

• OAuth de P1.1 com escopos mínimos de leitura. Revise e remova qualquer escopo não estritamente necessário — escopo a mais é o motivo mais comum de reprovação
• app/uninstalled tratado: marca como desconectada, para os syncs, não apaga dados, e envia e-mail perguntando o motivo
• O app renderiza dentro do admin da Nuvemshop, em iframe. Ajuste X-Frame-Options e Content-Security-Policy: frame-ancestors só para os domínios da Nuvemshop
• Erro amigável quando o token expira ou é revogado
• Tempo até o primeiro valor: o lojista instala e vê a barra de progresso do sync imediatamente, com os primeiros KPIs aparecendo conforme os dados chegam. Não deixe tela em branco por 3 minutos

3. Listagem

Prepare e me entregue para revisão antes de submeter:

• Nome: Raio-X da Loja · EcomSmart
• Descrição curta (até 140 caracteres): Descubra quanto a sua base de clientes tem parado. Faturamento, recompra, curva RFV e capital parado em 3 minutos.
• Descrição longa com as palavras que o lojista busca dentro da loja de apps: relatório, recompra, clientes, RFV, análise, faturamento, capital parado, ticket médio. Tom EcomSmart
• 5 capturas 1280×800 geradas pela fábrica de P2.3, na identidade, tema claro
• Vídeo de 60 segundos: instalação, sync, relatório. Com roteiro de narração escrito
• Ícone: símbolo "E" azul em círculo branco, padrão de avatar EcomSmart
• Política de privacidade e termos em radar.ecomsmart.com.br/legal, específicos sobre quais dados são lidos, por quanto tempo ficam e como pedir exclusão. LGPD
• Suporte em português, e-mail e WhatsApp, com SLA declarado de um dia útil

4. Atribuição deste canal

Instalação da loja de apps chega sem utm. Marque Lead.origem = "app_nuvemshop" no callback quando não houver sessao_id no state.

No painel de ROI este canal aparece com custo zero e receita cheia. É o que vai mostrar quanto ele realmente vale.

5. Depois

Aprovado, repita para a Tray — mesmo app, mesmo fluxo. A Shopify fica para depois: revisão bem mais longa, com requisitos adicionais de GDPR e performance. Não comece pela Shopify.

Critérios de aceite

1. App funcionando dentro do iframe do admin da Nuvemshop, em loja de teste. Captura
2. app/uninstalled testado de verdade — instale e desinstale
3. Escopos revisados e reduzidos ao mínimo, listados no merge request
4. Todos os materiais de listagem prontos e revisados comigo antes de submeter
5. Submissão feita, com o número do protocolo