Clew

Como configurar o onboarding de utilizadores 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 utilizador pela 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
O Qwen Code, sem programador

Exemplo: onboarding de utilizadores com o Qwen Code

Um back office mantido com o Qwen Code. Gestores 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 tem 14 dias de teste com tudo incluído, sem cartão. Quando o teste acaba, nada é apagado e o que foi publicado continua a aparecer.

Como configurar o onboarding de utilizadores 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 (onboarding de utilizadores 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 (onboarding de utilizadores 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.
    
    Depois do login, chame Clew.identify() com propriedades não pessoais como strings que diferenciem um utilizador novo de um antigo, por exemplo { signup_source: "web", onboarded: "false", role: "owner" }, e atualize onboarded para "true" quando o utilizador 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 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 (onboarding de utilizadores 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 (onboarding de utilizadores 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 o ecrã principal; um tour Tooltips passo a passo de 3–4 passos nesse ecrã, 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 utilizadores 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 mostrarLogo ao carregar a página
    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)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
    Checklist
    FormatoChecklist de onboarding
    Onde mostrar (URL da página)Secção por prefixo /admin
    Quando mostrarNa N.ª visita: 2
    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 (onboarding de utilizadores 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 (onboarding de utilizadores com o Qwen Code)
    Passo 7 · ilustração esquemática

Armadilhas: onboarding de utilizadores 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 utilizadores 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 onboarding de utilizadores com sessão iniciada como um funcionário típico, para escolher os elementos que ele vê.

As boas-vindas não podem aparecer para utilizadores antigos

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

Não dispare tudo na mesma página

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

Perguntas e respostas

Serve para ferramentas da equipa?

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 resolve; é 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, 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.