Clew

Como configurar o onboarding de usuários com o Qwen Code sem programador

Um fluxo completo de primeira sessão com o Qwen Code — boas-vindas, primeira ação guiada e lista de primeiros passos — com três itens do Clew que acompanham o usuário pelo app, em vez de um tour comprido no carregamento.

Tempo
● 40 minutos
Preço
Tours grátis · resto no teste de 14 dias
Quem faz
Você e o Qwen Code

Exemplo: onboarding de usuários com o Qwen Code

Um back office mantido com o Qwen Code. Gerentes novos (role = manager) veem as boas-vindas em /admin, um tour em /admin/orders e um checklist de rotinas diárias na segunda visita.

A parte do tour de produto é grátis no plano Free (até 3 publicados). Modal, Checklist e as regras de público fazem parte do Pro: toda conta nova ganha 14 dias de teste com tudo incluído, sem cartão. Quando o teste acaba, nada é apagado e o que foi publicado continua aparecendo.

Como configurar o onboarding de usuários 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 (onboarding de usuários 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 (onboarding de usuários 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.
    
    Depois do login, chame Clew.identify() com propriedades não pessoais como strings que diferenciem um usuário novo de um antigo, por exemplo { signup_source: "web", onboarded: "false", role: "owner" }, e atualize onboarded para "true" quando o usuário concluir a ação principal. Se o widget ainda puder não ter carregado, defina antes o stub de fila: window.TutorKit = window.TutorKit || { q: [], identify: function (p) { this.q.push(["identify", p]); } }; e chame window.TutorKit.identify(...). Adicione também atributos data-tour à navegação principal e ao botão principal de criar. Nunca envie nomes nem e-mails.
    
    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 (onboarding de usuários 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 (onboarding de usuários com o Qwen Code)
    Passo 4 · ilustração esquemática
  5. Passo 05

    Crie os três itens do onboarding

    Em Fluxos crie três itens: um Janela modal com uma frase de boas-vindas e um link para a tela principal; um tour Tooltips passo a passo de 3–4 passos nessa tela, feito com Editar no seu site e Escolher elemento; e um Checklist de onboarding com as tarefas de configuração que faltam.

    Um pop-up de boas-vindas, um tooltip de tour e um painel de checklist como três etapas do onboarding (onboarding de usuários 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
    Pop-up de boas-vindas
    FormatoJanela modal
    Onde mostrar (URL da página)Caminho exato /admin
    Quando mostrarAssim que a página carregar
    Segmentação de públicoPropriedade role é igual a manager
    FrequênciaUma vez por visitante
    Tour do produto
    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
    Checklist
    FormatoChecklist de onboarding
    Onde mostrar (URL da página)Seção por prefixo /admin
    Quando mostrarNa N-ésima visita: 2
    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 (onboarding de usuários 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 (onboarding de usuários com o Qwen Code)
    Passo 7 · ilustração esquemática

Armadilhas: onboarding de usuários 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 onboarding de usuários 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 onboarding de usuários logado como um funcionário típico, para escolher os elementos que ele vê.

As boas-vindas não podem aparecer para usuários antigos

“Uma vez por visitante” vale por navegador: um cliente antigo num notebook novo é um visitante novo. Se o seu app conhece o usuário, adicione uma regra sobre uma propriedade como onboarded para os antigos pularem as boas-vindas.

Não dispare tudo na mesma página

Se o pop-up, o tour e o checklist batem com a mesma URL, só um começa e os outros esperam. Dê a cada um a sua página ou gatilho, como na tabela acima.

Perguntas e respostas

Serve para ferramentas da equipe?

Sim. Funciona atrás de login em qualquer caminho onde a linha estiver instalada.

Qual modelo do Qwen é preciso?

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

Quais partes são grátis?

Tours são grátis no plano Free. O pop-up de boas-vindas, o checklist e as regras de público estão no Pro; o teste de 14 dias inclui tudo, sem cartão.

Quanto tempo leva?

Uns quarenta minutos para a primeira versão: dez para o pop-up, vinte para o tour e dez para o checklist. Depois, melhore pelo funil.

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.