Solução de problemas: erros comuns e como resolver

Este guia reúne os problemas operacionais mais frequentes na Studeia e como resolvê-los. Em quase todos os casos, comece verificando o que mudou recentemente (uma publicação, uma config, uma matrícula).

Resposta rápida

Aluno não vê o curso → matrícula ativa? turma alocada? curso publicado?
SSO falhando → config do IdP, domínios permitidos, relógio, URL de callback
Aula indisponível → não publicada, publishAt futuro ou pré-requisito pendente
Tutor IA bloqueado → quarentena/cooldown do supervisor (bem-estar = acolhimento)
E-mail não chega → provedor, SPF/DKIM, opt-out, logs de e-mail

Aluno não vê o curso ou a turma

Verifique	Como resolver
Matrícula ativa?	Confirme o status da matrícula no curso
Turma alocada?	Aloque a turma na matrícula (sem turma, não há fórum/ao vivo/anúncios de turma)
Curso publicado?	Publique o curso (rascunho não aparece para alunos)

Login/SSO falhando

Provedor de identidade configurado corretamente (Azure AD, Okta, Google)?
Domínio do usuário na lista de domínios permitidos?
Relógio do IdP sincronizado (assertion expirada é causa comum)?
URL de callback igual à configurada?

Aula aparece indisponível

A aula está publicada (isPublished)?
Há data futura de publicação (publishAt)?
Existe pré-requisito não concluído?

Tutor IA bloqueado

O supervisor de IA modera o chat. Um bloqueio pode ser:

Quarentena (após infrações reincidentes) — o aluno pode apelar.
Cooldown de acolhimento (casos de bem-estar) — não é punição; o tutor é interrompido com mensagem de apoio e recursos.

O admin institucional revisa em Supervisor IA e libera quando apropriado.

E-mails não chegam

Configuração do provedor (SMTP/Resend/SendGrid) correta?
Domínio remetente autenticado (SPF/DKIM)?
Usuário fez opt-out?
Cheque os logs de e-mail — eles indicam o motivo da falha.

Ainda com problema?

Reúna: o que você esperava, o que aconteceu, prints e horário. Em seguida, abra um chamado pela página de suporte com esses detalhes — isso acelera muito o diagnóstico.

Perguntas frequentes

Aluno não vê o curso? Matrícula ativa, turma alocada e curso publicado.

SSO não funciona? IdP, domínios permitidos, relógio e URL de callback.

Aula indisponível? Publicação, publishAt ou pré-requisito.

Tutor bloqueado? Quarentena/cooldown do supervisor — bem-estar é acolhimento.

E-mail não chega? Provedor, SPF/DKIM, opt-out e logs.

Veja o guia Comece aqui e o agente supervisor.

FAQ

O aluno não vê o curso ou a turma. O que verificar?

Confira três pontos: (1) a matrícula está ativa no curso? (2) o aluno foi alocado a uma turma? Sem turma, ele acessa o conteúdo, mas não fóruns, aulas ao vivo e anúncios de turma. (3) o curso está publicado? Alunos só veem cursos publicados. Para alocar a turma, use o painel institucional na matrícula do aluno.

O login com SSO não funciona. Como diagnosticar?

Verifique se o provedor de identidade (Azure AD, Okta, Google) está configurado corretamente em SSO, se o domínio do usuário está na lista de domínios permitidos e se os metadados/URLs de retorno batem. Erros comuns: relógio do servidor IdP fora de sincronia (assertion expirada) e URL de callback divergente da configurada.

A aula aparece como indisponível para o aluno. Por quê?

A aula pode não estar publicada (isPublished) ou ter data de publicação futura (publishAt). Também pode haver um pré-requisito não concluído, se a aula depende de outra. Verifique o status de publicação da aula e os pré-requisitos do módulo no editor do curso.

O tutor IA está bloqueado para um aluno. O que significa?

Pode ser quarentena ou período de acolhimento (cooldown) do supervisor de IA, que modera o chat. Em casos de bem-estar (safety), o tutor é interrompido com mensagem de acolhimento — não é punição. O aluno pode enviar um apelo, e o admin institucional revisa o incidente e libera quando apropriado em Supervisor IA.

Os e-mails da plataforma não estão chegando. Como resolver?

Verifique a configuração de e-mail do tenant (provedor SMTP/Resend/SendGrid), se o domínio remetente está autenticado (SPF/DKIM) e se o usuário não optou por sair (opt-out). Cheque também os logs de e-mail no painel — eles indicam falhas de entrega e o motivo.