Onboarding

Resumo

Plataforma de tours guiados interativos com gatilhos comportamentais, progresso individual por usuário e integração bidirecional com o Help Center. O plugin atende a dois públicos: (1) equipes de produto que precisam ativar novos usuários dentro do próprio painel P8W e (2) clientes que desejam aplicar tours dinâmicos no próprio site ou aplicação externa via SDK/embed assinado. Passos em formato tooltip, spotlight, modal ou beacon, com cooldown, limite de exibições e prioridade configuráveis por gatilho.

Para quem é

• Equipes de produto em SaaS que precisam aumentar ativação e reduzir ticket de suporte por recursos não utilizados.
• Administradores de tenant do P8W que querem orientar seus próprios usuários dentro do painel.
• Agências e consultorias que implantam o P8W para clientes e precisam entregar onboarding whitelabel.
• Donos de site externo que usam o SDK para embutir tours no próprio domínio, com autenticação HMAC assinada.

O que você pode fazer

Criação de tours

• Montar tours passo a passo com seletor CSS, posição do balão, conteúdo rich text e ação esperada.
• Escolher o formato visual de cada passo: tooltip, spotlight (destaque com máscara), modal centralizado ou beacon pulsante.
• Reaproveitar tours entre plugins via biblioteca compartilhada.

Gatilhos automáticos

• Primeira visita ao recurso.
• Recurso não utilizado após N dias.
• Evento JavaScript customizado (integração com qualquer CTA do front-end).
• Manual (acionado por botão de ajuda).
• Regras de cooldown, limite de exibições e prioridade por gatilho evitam fadiga de notificações.

Progresso e retomada

• Progresso individual por usuário persistido em banco.
• Retomada automática do passo onde o usuário parou, mesmo em outro dispositivo.
• Reset de progresso controlado por permissão granular.

Analytics

• Taxa de conclusão por tour.
• Drop-off por passo (identifica pontos de atrito).
• Tendência diária de engajamento.
• Segmentação por persona, plano e recurso.

Help Center bidirecional

• Sugestão automática de artigos relacionados ao fim de cada tour.
• Links de artigos apontam de volta para tours relevantes.
• Tabela onboarding_article_links mantém a relação n:n.

SDK embed para site externo

• Snippet JavaScript assinado por HMAC.
• Endpoint público com tenant e domínio autorizados.
• Possibilita colocar tours do P8W em domínio do cliente sem abrir a sessão interna.

Como começar

1. Ative o plugin Onboarding no painel administrativo.
2. Na tab Tours, clique em "Novo tour" e selecione o plugin-alvo (ou "global").
3. Adicione passos: para cada passo, escolha um seletor CSS, o formato (tooltip/spotlight/modal/beacon) e o texto.
4. Em Triggers, associe o tour a um gatilho (primeira visita, recurso ocioso, evento JS ou manual) e defina cooldown e limite.
5. Acompanhe em Progress quem iniciou, pausou e concluiu.
6. Para uso externo, gere um token em Settings → SDK e cole o snippet no site do cliente.

Tutoriais

• Criar o primeiro tour guiado no painel — do zero ao gatilho de primeira visita.
• Integrar tour com evento customizado — disparar tour ao clicar em um botão específico.
• Conectar tour a artigo do Help Center — sugestão ao final do tour.
• Medir ativação — ler o funil de passos no tab Analytics.
• Embutir tour em site externo — gerar token, configurar domínio autorizado e colar o snippet.

Integrações com outros plugins

• Help Center: vínculo bidirecional entre tours e artigos.
• Accounts: branching por role (admin x editor x viewer) no mesmo tour.
• Push: disparar notificação lembrando usuário de retomar tour abandonado.
• Analytics/Observability: eventos de conclusão alimentam o funil geral do tenant.

Perguntas frequentes

O Onboarding funciona só dentro da plataforma P8W? Não. Há dois modos: uso interno (dentro do painel do tenant) e SDK embed para colocar tours no site externo do cliente final, com assinatura HMAC.

Consigo ter tours diferentes para admins e usuários comuns? Sim. Cada tour pode ser vinculado a roles específicas; o mesmo gatilho escolhe a variação correta.

Posso limitar quantas vezes um tour aparece? Sim. Cada gatilho tem cooldown (tempo mínimo entre exibições) e máximo total de exibições.

Como é contado o progresso de um tour? Cada passo concluído grava em onboarding_user_progress. A retomada busca o último passo visto por usuário.

O que acontece se o seletor CSS mudar? O passo é pulado e registrado em analytics como erro de seletor, evitando bloquear o fluxo do usuário.

Dá para reaproveitar tours entre plugins? Sim. A biblioteca permite importar um tour existente como base para criar variação contextual.

A integração com Help Center é automática? A sugestão de artigo ao fim do tour é automática quando o vínculo está configurado; caso contrário, nenhum artigo é exibido.

Existe confetti ou celebração ao concluir? Sim. A flag completion_confetti ativa animação de conclusão.

Glossário

• Tour: sequência ordenada de passos interativos.
• Gatilho: condição que inicia um tour (visita, inatividade, evento, manual).
• Passo: unidade de exibição (tooltip, spotlight, modal, beacon).
• Cooldown: intervalo mínimo antes de reexibir o mesmo tour ao mesmo usuário.
• SDK embed: biblioteca JavaScript assinada para incorporar tours em site externo.

Limitações e avisos

• O SDK embed valida o domínio: tours só carregam em domínios previamente autorizados no painel.
• Mudanças de layout no alvo podem invalidar seletores CSS — revisar após grandes atualizações visuais.
• Limite padrão de exibições protege contra fadiga; remover o limite não é recomendado.
• Analytics só conta usuários autenticados no modo interno; no SDK embed depende do identificador fornecido pelo cliente.

Relacionados

• Pages — onde hospedar landing pages de boas-vindas.
• Push — lembretes automatizados de retomada de tour.
• Prospect — tour contextual para equipes comerciais.