Visão geral
Os tours guiados interativos são um passo a passo sobreposto à própria tela da Conversa Labs: a plataforma escurece o fundo, ilumina o item em foco (a barra lateral, um botão) e mostra um balão explicando o que fazer ali. Diferente do artigo estático "Conhecendo a interface", aqui você é conduzido pela interface real, clicando e avançando etapa a etapa.
Os tours são sensíveis ao papel do usuário: existem tours de primeira execução diferentes para agentes e para administradores, cada um destacando o que importa para aquele perfil. Além disso, há tours por módulo — CRM, Agenda, Pagamentos, WhatsApp Hub, Contatos, Relatórios e outros — para você conhecer cada área no seu ritmo.
Pré-requisitos
- Recurso Tours guiados (
guided_tours) habilitado para a conta. Sem ele, nenhum tour aparece. - Usuário autenticado na plataforma.
- O conjunto de tours por módulo segue os módulos habilitados na conta e o seu perfil de acesso.
Passo a passo
- Primeiro acesso: se o início automático estiver ligado, ao entrar pela primeira vez o tour de boas-vindas inicia sozinho — o de administrador se você for admin, ou o de agente nos demais casos.
- Avance pelas etapas: cada etapa fica ancorada a um ponto real da tela (itens da barra lateral, como Conversas e Notificações) ou centralizada (telas de boas-vindas e de conclusão). Use os botões para ir para a próxima/anterior.
- Assista aos vídeos: algumas etapas trazem um vídeo tutorial curto para complementar o texto.
- Saia quando quiser: você pode pular ou fechar o tour a qualquer momento.
- Reabra um tour: use a barra de comandos (⌘K) e busque o tour desejado, ou clique no botão lançador de tours (ícone de capelo) na barra lateral. Se o tour já foi concluído, ele é reproduzido novamente (replay).
- Administre a conta: com a permissão de configurações da conta, acesse Configurações → Onboarding e tours para ligar ou desligar o início automático e, após confirmação, reapresentar os tours para todos.
Configurações & opções
- Progresso por usuário: o estado de cada tour (concluído, dispensado ou em andamento) fica salvo
nas suas preferências (
ui_settings.product_tours). Um tour em andamento retoma de onde parou. - Retomar de onde parou: se você fechou no meio, o tour volta na última etapa vista.
- Vídeos tutoriais por idioma: são gerenciados pelo operador em Super Admin → Vídeos de tour.
Cada combinação de etapa e idioma (
en,pt_BRoues) pode ter seu próprio vídeo. A plataforma pede o idioma atual do painel; sem uma versão exata, usa inglês e depois outra versão disponível de forma determinística. Registros legados sem idioma também continuam funcionando até a migração. - Início automático por conta: em Configurações → Onboarding e tours, o administrador decide
se tours ainda não vistos podem começar sozinhos (
custom_attributes.guided_tours.autoplay). Desligar não esconde nem apaga tours: o lançador, a barra de comandos e o replay continuam disponíveis. - Reiniciar para toda a conta (admin): um administrador pode reapresentar os tours de
primeira execução para todos os usuários da conta em Configurações → Onboarding e tours. Após
confirmação, o servidor grava um marcador de data
(
custom_attributes.guided_tours.reset_at): qualquer progresso anterior a essa data passa a ser tratado como "não visto", sem excluir o histórico individual. Os tours só iniciam automaticamente se a opção de início automático estiver ligada. - Nova versão de um tour: quando um tour é atualizado, ele volta a ser tratado como novo.
Casos de uso
- Onboarding de novos agentes: o tour de agente apresenta a caixa de entrada e as conversas logo no primeiro acesso, sem treinamento manual.
- Atualizar a equipe após uma novidade grande: o administrador reinicia os tours para a conta inteira e todos voltam a ver a apresentação atualizada.
- Aprender um módulo específico: abra o tour de CRM, Agenda ou Pagamentos pelo lançador quando for usar aquela área pela primeira vez.
- Operar o histórico comercial com segurança (admin): o tour de Catálogo mostra onde visualizar e selecionar explicitamente vendas anteriores da Hotmart ou da Kiwify, inspecionar ou desfazer uma importação elegível e revisar ou repetir entregas de webhooks do catálogo. O tour de Configurações aponta o histórico de entregas dos webhooks da conta; cada etapa preserva os controles de papel, permissão e recurso habilitado.
Dicas, limites e boas práticas
- Você pode pular ou dispensar o tour a qualquer momento — ele não trava o seu trabalho.
- Agentes e administradores veem tours diferentes; é normal um colega ver outra sequência.
- Os tours só aparecem com o recurso Tours guiados ligado na conta.
- Para revisitar um conteúdo, prefira o replay pelo ⌘K ou pelo lançador em vez de procurar o artigo — o tour mostra a tela real.
Solução de problemas
- O tour não apareceu no primeiro acesso: verifique se o recurso Tours guiados está habilitado, se o início automático está ligado, se você já não o concluiu/dispensou antes, e se o tour corresponde ao seu papel (agente x administrador).
- Quero ver de novo: abra a barra de comandos (⌘K) e busque o tour, ou use o lançador de tours (ícone de capelo) na barra lateral — tours concluídos são reproduzidos em replay.
- Um tour de módulo não está na lista: o módulo pode estar desabilitado na conta ou fora do seu perfil de acesso.
- Quero reapresentar para todo mundo: um administrador pode reiniciar os tours de primeira execução para a conta inteira em Configurações → Onboarding e tours. A ação pede confirmação.