Clew

Como criar um tour do produto com o Qwen Code sem programador

Um walkthrough guiado com o Qwen Code em uns vinte minutos: instale uma linha, percorra a sua própria interface no editor visual e publique um tour que começa exatamente onde os utilizadores novos precisam.

Tempo
● 20 minutos
Preço
Plano Free
Quem faz
O Qwen Code, sem programador

Exemplo: um tour do produto com o Qwen Code

O back office de um e-commerce cujos programadores foram embora; o dono mantém tudo com o Qwen Code. Gestores novos em /admin/orders veem como filtrar encomendas por pagar, mudar um status e imprimir uma etiqueta de envio.

Grátis no plano Free do Clew, sem cartão e sem prazo: um site e até 3 tours ou tooltips publicados. Regras de público e testes A/B vêm com o Pro.

Como criar o tour do produto com o Qwen Code, passo a passo

  1. Passo 01

    Copie o seu snippet do Clew

    Crie uma conta gratuita (ou entre), adicione o seu site e abra Visão geral no admin. Clique na linha do cartão O widget ainda não deu sinal. para copiar: ela já vem com a chave real do seu site no lugar do marcador.

    <!-- Clew: substitua COLE_AQUI_A_SUA_CHAVE pela chave do site em Admin > Visão geral -->
    <script src="https://tryclew.io/widget/COLE_AQUI_A_SUA_CHAVE.js" async></script>
    Visão geral do admin do Clew com a linha de instalação e a chave do site oculta (tour do produto com o Qwen Code)
    Passo 1 · ilustração esquemática
  2. Passo 02

    Execute o Qwen Code na pasta do projeto

    Instale a CLI de código aberto Qwen Code e execute qwen na pasta do projeto. Ela lê o repositório e edita ficheiros com a sua confirmação. O Qwen Chat na web só sugere código que teria de colar.

    Sessão de assistente de IA no terminal aberta num projeto (tour do produto com o Qwen Code)
    Passo 2 · ilustração esquemática
  3. Passo 03

    Envie o prompt com a sua chave

    Substitua COLE_AQUI_A_SUA_CHAVE pela sua chave e envie o prompt.

    Adicione o widget de onboarding do Clew a esta app.
    
    Insira esta tag exata uma única vez, para que carregue em todas as páginas, inclusive depois de mudanças de rota no cliente:
    <script src="https://tryclew.io/widget/COLE_AQUI_A_SUA_CHAVE.js" async></script>
    
    Encontre o ficheiro HTML raiz ou o layout raiz deste projeto (index.html no Vite, app/layout.tsx com next/script no Next.js App Router, app.head.script do nuxt.config.ts no Nuxt, o template base em apps renderizadas no servidor) e adicione a tag ali.
    
    Adicione também atributos data-tour estáveis aos elementos que um tour do produto vai apontar: a navegação principal, o botão principal de criar/adicionar, o filtro ou a busca principal e o título da página, por exemplo data-tour="create-button". Não mude os estilos, textos ou o comportamento deles.
    
    Regras:
    - Use a URL do script exatamente como está. Não transfira, não empacote e não instale um pacote npm.
    - Se o projeto define uma Content-Security-Policy, permita https://tryclew.io em script-src e connect-src.
    - Não mude mais nada e me mostre o diff.
    Campo do assistente de IA com o prompt do Clew (tour do produto com o Qwen Code)
    Passo 3 · ilustração esquemática
  4. Passo 04

    Confirme as edições e publique

    Confirme as edições depois de conferir o diff, faça commit e deploy como sempre.

    Diff com uma linha de script adicionada ao ficheiro raiz (tour do produto com o Qwen Code)
    Passo 4 · ilustração esquemática
  5. Passo 05

    Crie o tour por cima da sua página

    No Clew abra Fluxos → + Novo fluxo, deixe Formato em Tooltips passo a passo e clique em Editar no seu site. Na sua página clique em Escolher elemento, clique no elemento do passo 1 e escreva um título e uma ou duas frases. Repita para 3–5 passos; a pré-visualização atualiza-se enquanto escreve.

    Tooltip de tour do produto apontando um botão numa app web, com pontos de passos e botão Próximo (tour do produto com o Qwen Code)
    Passo 5 · ilustração esquemática
  6. Passo 06

    Escolha onde, quando e para quem aparece

    No mesmo editor, preencha Onde mostrar (URL da página), Quando mostrar, Segmentação de público e Frequência. Estas são as configurações do exemplo acima:

    ConfiguraçãoValor
    FormatoTooltips passo a passo
    Onde mostrar (URL da página)Secção por prefixo /admin/orders
    Quando mostrarLogo ao carregar a página
    Segmentação de públicoSem regras: toda nós que abre a página
    FrequênciaUma vez por visitante
    Editor de tours do Clew com formato, regra de URL, acionador e regra de público (tour do produto com o Qwen Code)
    Passo 6 · ilustração esquemática
  7. Passo 07

    Publique e verifique no site real

    Mude Estado para Publicado e guarde. Abra a página numa janela anónima: o Clew lembra quem já viu um item de “uma vez”, por isso o seu navegador de sempre pode saltar. Visualizações, conclusões e abandonos aparecem nas estatísticas.

    Visão geral do admin do Clew com o cartão verde de widget ativo (tour do produto com o Qwen Code)
    Passo 7 · ilustração esquemática

Armadilhas: tour do produto com o Qwen Code

Confirme as edições uma a uma

Mantenha o modo de aprovação padrão para ver cada mudança. O tour do produto precisa da tag, de alguns atributos e, quando for o caso, de uma chamada identify; mais nada.

Painéis administrativos com login

As regras de URL funcionam em qualquer caminho, inclusive /admin. Crie o tour do produto com sessão iniciada como um funcionário típico, para escolher os elementos que ele vê.

Classes geradas mudam a cada rebuild

Apps feitos com IA costumam usar classes utilitárias ou CSS modules com hash. Um seletor como .bg-blue-600.px-4 quebra no próximo prompt. Por isso o prompt pede atributos data-tour: escolha esses elementos e o tour sobrevive às regenerações.

Perguntas e respostas

O Qwen Code precisa de acesso ao Clew?

Não. Ele só edita os seus ficheiros; o widget carrega nos navegadores dos seus utilizadores.

Qual modelo do Qwen é preciso?

O modelo de código padrão do Qwen Code resolve; é uma edição pequena e bem descrita.

O tour do produto é grátis?

Sim: tours estão no plano Free, com até 3 publicados. Só precisa do Pro para regras de público, testes A/B e mais tours.

Porque é que não pedir para a IA criar o tour?

É possível, mas cada mudança de texto passa a ser um prompt novo, um diff novo e um deploy novo, e sem estatísticas. Com o Clew a IA adiciona uma linha e alguns atributos uma vez; o tour qualquer pessoa do equipa edita em minutos.

Uma linha no seu site e, a seguir, tours, dicas e checklists sem novas versões.

Obter a minha chave grátisComo funciona o ClewPlano gratuito para sempre, sem cartão

Tours de produto, pop-ups e onboarding na era da IA

7 padrões com número de passos, regras de texto e métricas, o que a IA muda e uma lista antes de publicar. PDF, 2 páginas. O que inclui →

O guia está em inglês.