## 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

1. **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.
2. **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.
3. **Assista aos vídeos**: algumas etapas trazem um vídeo tutorial curto para complementar o texto.
4. **Saia quando quiser**: você pode pular ou fechar o tour a qualquer momento.
5. **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).
6. **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_BR` ou `es`) 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.

## Veja também

- [Conhecendo a interface](/hc/ajuda/articles/getting-started-tour-interface-pt-br)
- [Onboarding com o Cérebro Maestro](/hc/ajuda/articles/getting-started-onboarding-cerebro-maestro-pt-br)