> ## Documentation Index
> Fetch the complete documentation index at: https://help.comunicain.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Trilhas

> Percursos com módulos, reels, páginas, quizzes opcionais, progresso e pontos

**Trilhas** são percursos de aprendizado organizados por tema. Elas ajudam a transformar conteúdos do Loop em uma jornada clara, com módulos, ordem sugerida, progresso e acompanhamento.

Uma trilha pode combinar vídeos curtos em formato reel com páginas de conhecimento, materiais de apoio e quizzes opcionais por módulo.

## Estrutura de uma trilha

<CardGroup cols={2}>
  <Card title="Configurações" icon="settings">
    Nome, descrição, hashtag, ícone, tempo estimado, status ativo/inativo e pontos de conclusão.
  </Card>

  <Card title="Módulos" icon="layers-3">
    Etapas internas da trilha. Cada módulo tem título, descrição, ordem, conteúdos e pontos próprios quando aplicável.
  </Card>

  <Card title="Reels" icon="film">
    Conteúdos rápidos em vídeo, usados para explicar, demonstrar ou provocar ação.
  </Card>

  <Card title="Páginas" icon="file-text">
    Materiais de conhecimento adicionados à trilha para aprofundamento, regras, guias ou instruções.
  </Card>
</CardGroup>

## Criar uma trilha

<Steps>
  <Step title="Abra o Painel de Gestão">
    Vá em **Desenvolvimento** e acesse a área de trilhas.
  </Step>

  <Step title="Crie a trilha">
    Defina nome, descrição, hashtag, ícone, tempo estimado e se ela já deve ficar ativa.
  </Step>

  <Step title="Configure a trilha">
    Ajuste a descrição e, se quiser, ative gamificação com pontos ao concluir a trilha.
  </Step>

  <Step title="Crie módulos">
    Divida o conteúdo em etapas, como "Comece por aqui", "Prática", "Política" ou "Checklist final".
  </Step>

  <Step title="Adicione conteúdos">
    Inclua reels e páginas de conhecimento em cada módulo.
  </Step>

  <Step title="Revise e publique">
    Ordene módulos e conteúdos, valide a experiência e deixe a trilha ativa.
  </Step>
</Steps>

## Módulos

Módulos ajudam a organizar trilhas maiores. Cada módulo pode ter:

* título;
* descrição;
* ordem;
* reels;
* páginas de conhecimento;
* quiz opcional;
* pontos próprios quando a trilha está gamificada.

Ao criar uma trilha sem módulos, o sistema pode criar um módulo padrão de conteúdos principais para manter a organização.

## Adicionar reels

Admins podem buscar reels publicados no ambiente e adicioná-los à trilha.

A busca considera:

* legenda;
* autor;
* conteúdos já adicionados;
* duração e preview do reel.

Depois de adicionados, reels podem ser reordenados dentro do módulo.

## Adicionar páginas de conhecimento

Além de reels, a trilha pode incluir páginas da base de conhecimento. Isso é útil para:

* políticas internas;
* guias;
* documentos;
* instruções;
* FAQs;
* materiais de apoio de um módulo.

Quando o colaborador abre uma página pela trilha, ela também conta como conteúdo concluído.

## Quiz opcional por módulo

Um módulo pode ter quiz opcional associado. O quiz aparece no módulo como uma etapa complementar, com pontuação mínima quando configurada.

Use quiz para reforçar entendimento, checar retenção ou criar uma pausa de revisão ao final de um módulo.

## Experiência do colaborador

Ao abrir uma trilha, o colaborador vê:

* botão **Começar** ou **Continuar**;
* progresso total;
* módulos;
* reels em sequência;
* materiais de apoio recolhíveis;
* páginas de conhecimento;
* status de conteúdos concluídos;
* pontos disponíveis quando a trilha está gamificada.

O botão **Continuar** abre o próximo conteúdo não concluído. Se o próximo item for uma página, ela abre dentro da trilha. Se for um reel, abre a experiência de reels com retorno para a trilha.

## Progresso

O progresso é calculado por conteúdo concluído. Reels e páginas contam como itens da trilha.

Quando um conteúdo é concluído, o Loop atualiza:

* progresso do item;
* progresso do módulo;
* progresso total da trilha;
* estado do botão continuar;
* insights do admin.

## Gerenciar trilhas existentes

Admins podem:

* editar descrição;
* ativar/desativar gamificação;
* definir pontos ao concluir a trilha;
* criar, editar, excluir e reordenar módulos;
* adicionar reels;
* adicionar páginas;
* reordenar conteúdos;
* remover conteúdos;
* configurar ou remover quiz de módulo;
* abrir insights.

## Regras e limites

* Apenas admins e proprietários gerenciam trilhas.
* Trilhas ativas aparecem para os colaboradores.
* Conteúdos são isolados por tenant.
* Páginas adicionadas precisam estar ativas na base de conhecimento.
* Se um conteúdo for removido da trilha, ele deixa de contar para o progresso.
* Excluir uma trilha apaga sua estrutura e seus registros associados.
* Recursos antigos sem módulos continuam funcionando por fallback.

## Boas práticas

<AccordionGroup>
  <Accordion title="Use módulos como narrativa">
    Organize a trilha em começo, desenvolvimento e fechamento. Isso ajuda o colaborador a entender onde está e por que cada conteúdo existe.
  </Accordion>

  <Accordion title="Misture formatos com intenção">
    Use reels para explicar rápido e páginas para detalhes. Evite colocar uma página longa sem contexto antes de um vídeo introdutório.
  </Accordion>

  <Accordion title="Crie pontos de vitória">
    Módulos curtos dão sensação de avanço. Uma trilha com 4 módulos de 3 conteúdos costuma parecer mais leve do que uma lista única com 12 conteúdos.
  </Accordion>

  <Accordion title="Use quiz quando ele ajuda">
    Quiz deve reforçar aprendizado, não virar burocracia. Use em módulos críticos, como compliance, segurança, atendimento ou processos internos.
  </Accordion>

  <Accordion title="Revise pelos insights">
    Se um módulo tem baixo consumo ou muita queda, revise título, ordem e qualidade dos primeiros conteúdos.
  </Accordion>
</AccordionGroup>

## Veja também

<CardGroup cols={2}>
  <Card title="Analytics" icon="chart-line" href="/pt-br/desenvolvimento/analytics">
    Como acompanhar consumo por módulo, conteúdo e colaborador.
  </Card>

  <Card title="Aprendizado Gamificado" icon="trophy" href="/pt-br/desenvolvimento/aprendizado-gamificado">
    Como funcionam pontos por trilha e por módulo.
  </Card>
</CardGroup>