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 usuários novos precisam.

Tempo
● 20 minutos
Preço
Plano Free
Quem faz
Você e o Qwen Code

Exemplo: um tour do produto com o Qwen Code

O back office de um e-commerce cujos devs foram embora; o dono mantém tudo com o Qwen Code. Gerentes novos em /admin/orders veem como filtrar pedidos não pagos, 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 grátis (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: troque COLE_AQUI_SUA_CHAVE pela chave do site em Admin > Visão geral -->
    <script src="https://tryclew.io/widget/COLE_AQUI_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

    Rode o Qwen Code na pasta do projeto

    Instale a CLI de código aberto Qwen Code e rode qwen na pasta do projeto. Ela lê o repositório e edita arquivos com a sua confirmação. O Qwen Chat na web só sugere código que você teria que 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

    Troque COLE_AQUI_SUA_CHAVE pela sua chave e envie o prompt.

    Adicione o widget de onboarding do Clew a este 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_SUA_CHAVE.js" async></script>
    
    Encontre o arquivo 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 renderizados 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 baixe, 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 arquivo raiz (tour do produto com o Qwen Code)
    Passo 4 · ilustração esquemática
  5. Passo 05

    Monte 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évia se atualiza enquanto você digita.

    Tooltip de tour do produto apontando um botão num 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)Seção por prefixo /admin/orders
    Quando mostrarAssim que a página carregar
    Segmentação de públicoSem regras: todo mundo que abre a página
    FrequênciaUma vez por visitante
    Editor de tours do Clew com formato, regra de URL, gatilho e regra de público (tour do produto com o Qwen Code)
    Passo 6 · ilustração esquemática
  7. Passo 07

    Publique e confira no site real

    Mude Status para Publicado e salve. Abra a página numa janela anônima: o Clew lembra quem já viu um item de “uma vez”, então o seu navegador de sempre pode pular. 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. Monte o tour do produto logado 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 arquivos; o widget carrega nos navegadores dos seus usuários.

Qual modelo do Qwen é preciso?

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

O tour do produto é grátis?

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

Por que não pedir para a IA criar o tour?

Dá, mas cada mudança de texto vira 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 time edita em minutos.

Uma linha no seu site e, depois, tours, tooltips e checklists sem deploy.

Pegar minha chave grátisComo o Clew funcionaPlano 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 um checklist antes de publicar. PDF, 2 páginas. O que tem no guia →

O guia está em inglês.