Docs › Para clientes › Perguntas frequentes
Perguntas frequentes
Respostas curtas para dúvidas de administradores e tutores. Para o passo a passo, veja o guia do administrador, o guia do tutor, o guia do aluno e o guia do supervisor.
Botão do chat e lista de tutores
O botão do chat não aparece para o aluno
O botão só aparece quando todas estas condições são verdadeiras:
- A página é de um curso (não a página inicial do site) e o usuário está autenticado e não é convidado.
- O usuário tem
local/tutorchat:chat("Conversar com os tutores de um curso") nesse curso. O papel Estudante a tem por padrão; ela pode ter sido proibida nas permissões do curso. - O curso tem pelo menos um tutor que o aluno possa contatar (próxima pergunta).
- A página não usa um layout sem a moldura normal do Moodle, como tentativas de prova em modo seguro, impressão, janelas ou páginas de redirecionamento.
- O chat está ativo no curso: se o administrador escolheu categorias ou cursos em Onde o chat funciona, o curso precisa estar entre eles, e o curso não pode estar terminado com a opção de esconder cursos terminados ligada (veja "Por que o chat sumiu de um curso?" mais abaixo).
Depois de instalar ou atualizar o plugin, purgue os caches (Administração do site → Desenvolvimento → Limpar todos os caches).
O tutor não aparece na lista do aluno
- O papel do tutor precisa estar marcado em Chat com tutor → Papéis de tutor, e o tutor precisa estar inscrito no curso com esse papel (inscrição ativa).
- A capability
local/tutorchat:tutornão pode estar proibida nesse curso. - Em cursos com grupos separados, o aluno só vê tutores que estão em algum grupo dele (e quem não tem grupo não vê nenhum, salvo se tiver
moodle/site:accessallgroups). - Um usuário nunca aparece como tutor para si mesmo.
O tutor não vê o link "Área do tutor"
O link aparece para quem tem local/tutorchat:tutor em pelo menos um curso onde o chat está ativo. Peça ao administrador que confira os Papéis de tutor, a atribuição do papel no curso e se o curso está em Onde o chat funciona. Se o curso mudou de categoria ou de data de término há pouco, o link pode levar até 10 minutos para aparecer ou sumir. A Área do tutor abre pelo endereço direto mesmo sem o link.
Os alunos veem "Deixar recado", mas o tutor diz que está disponível
A disponibilidade exige que a Área do tutor esteja aberta em uma aba do navegador. Sem ela, o tutor deixa de aparecer como disponível após a Expiração da disponibilidade (90 segundos por padrão), mesmo com a chave ligada. Ao reabrir a Área do tutor com a chave ainda ligada, o tutor volta a ficar disponível na hora. Veja também a pergunta seguinte.
A disponibilidade do tutor "caiu" sozinha
Isso acontece quando a Área do tutor foi fechada ou o computador ficou sem conexão por mais que a expiração configurada. Uma aba em segundo plano continua mantendo a disponibilidade (ela consulta o servidor a cada 25 segundos por padrão, e a cada 3 a 15 segundos com a janela visível). Alguns navegadores reduzem a atividade de abas inativas; se isso acontecer, mantenha a Área do tutor numa janela visível ou peça ao administrador para aumentar a Expiração da disponibilidade.
Cursos onde o chat funciona
Por que o chat sumiu de um curso?
Há duas razões possíveis, definidas pelo administrador em Onde o chat funciona (veja a seção 5-A do guia do administrador):
- O curso não está na lista. Quando o administrador escolhe categorias ou cursos, o chat só funciona neles. Nos demais o curso fica inativo: o aluno só vê o botão se já tem conversa lá, e a conversa abre somente leitura, com o aviso "O chat foi desativado neste curso. Você ainda pode ler suas conversas." Ninguém inicia conversa nova.
- O curso terminou. Com Esconder o chat em cursos terminados ligada, depois da data de término do curso (mais os dias de tolerância) o chat some. As conversas que estavam abertas são fechadas pela tarefa agendada e continuam legíveis para quem participou. Um curso sem data de término nunca é considerado terminado.
O aluno não consegue enviar mensagem, embora o curso esteja ativo
Escrever exige inscrição ativa. Se a inscrição do aluno (ou a do tutor) está suspensa ou encerrada, a mensagem é recusada, mesmo que o papel ainda esteja atribuído. Só a inscrição de quem escreve é conferida.
O tutor vê a marca "Chat desativado neste curso" ou "Curso terminado"
A conversa é de um curso onde o chat foi desativado ou que terminou. Ela fica somente leitura: o campo de mensagem não aparece e o tutor não consegue responder, mas o histórico e o painel do aluno continuam disponíveis. Se o curso voltar a ficar ativo, a conversa volta a aceitar mensagens (conversas já fechadas pela tarefa não são reabertas).
Mensagens
As mensagens demoram a aparecer
O chat usa consultas curtas e repetidas, sem conexão contínua. Com os valores padrão, uma conversa na tela é verificada a cada 3 segundos enquanto há troca de mensagens; depois de 1 minuto de silêncio o intervalo cresce aos poucos até 15 segundos, e volta a 3 segundos assim que chega ou sai uma mensagem. Quem tem um atendimento aberto mas com a janela fechada (ou na lista de tutores) é verificado a cada 25 segundos. O aluno sem atendimento aberto e com a janela fechada não consulta o servidor, e a janela do aluno também não consulta enquanto a aba do navegador está oculta, voltando a consultar assim que a aba é exibida. Se o servidor está lento, o navegador espera mais entre as consultas. Os intervalos são configuráveis (Intervalo de atualização com o chat aberto, Maior intervalo de atualização com a conversa em silêncio e Intervalo de atualização em espera).
O botão do chat demora a mudar para "Tutor online"?
Pode demorar. O aluno que não está em um atendimento e está com a janela do chat fechada não consulta o servidor: o estado do botão vem junto com a página e só é atualizado quando a janela é aberta, quando a aba volta a ser exibida depois de mais de 1 minuto, ou quando a página é recarregada. Quem está com a janela aberta ou com um atendimento aberto vê a mudança no próximo ciclo de consulta (de 3 a 25 segundos, conforme o caso).
Por que a primeira mensagem às vezes demora alguns segundos para o outro lado?
Porque o outro lado só pergunta ao servidor de tempos em tempos. A Área do tutor consulta a cada 3 segundos enquanto há movimento e a cada 15 segundos quando está em silêncio há mais de 1 minuto; em uma aba oculta, a cada 25 segundos. Por isso a primeira mensagem de um atendimento novo pode levar até cerca de 15 segundos (25 com a aba oculta) para aparecer ao tutor. Depois que a conversa começa, o ritmo volta a ser de 3 segundos.
O que acontece com as mensagens antigas?
Por padrão, nada: elas ficam guardadas. Se o administrador definir Meses para guardar as mensagens, o texto das mensagens dos atendimentos encerrados há mais tempo que esse prazo é apagado em definitivo, todo dia às 03:30. O atendimento em si (curso, aluno, tutor, datas), a avaliação e as estatísticas permanecem, e quem abre o atendimento vê o aviso "As mensagens deste atendimento foram removidas pelo prazo de retenção."
Aparece "Reconectando…" ou "Sua sessão expirou. Entre novamente."
"Reconectando…": o navegador não conseguiu falar com o servidor; ele tenta de novo, esperando um pouco mais a cada falha (até 60 segundos). "Sua sessão expirou. Entre novamente.": o login do Moodle expirou; entre de novo.
Uma mensagem aparece como "Não enviada"
A mensagem não chegou ao servidor. Use Tentar novamente. Causas comuns: conexão instável, sessão expirada ou os limites abaixo.
Mensagem recusada
| Aviso | Motivo |
|---|---|
| "A mensagem está vazia." | O texto só tem espaços |
| "O texto é longo demais." | Mais de 2000 caracteres (avaliação: comentário com mais de 1000) |
| "Você está enviando mensagens rápido demais. Aguarde um instante e tente novamente." | Mais de 20 mensagens em um minuto |
| "Este atendimento já foi encerrado." | O atendimento terminou; o aluno pode usar Iniciar novo atendimento |
| "O chat foi desativado neste curso." | O curso saiu da lista de Onde o chat funciona ou terminou; a conversa passa a somente leitura |
| "Você não tem permissão para fazer isso." | Perdeu-se a permissão no curso ou o usuário não participa do atendimento |
| "Este site não consegue gravar emojis. Remova-os e tente novamente." | O banco de dados não aceita caracteres de quatro bytes; é preciso usar uma collation utf8mb4 no MySQL/MariaDB |
O seletor de emojis não aparece
O site está num banco de dados que não guarda emojis (no MySQL/MariaDB, sem collation utf8mb4). O seletor é escondido para evitar mensagens que não poderiam ser gravadas.
O atendimento foi encerrado sem ninguém pedir
Um atendimento sem mensagens novas por 24 horas (valor padrão de Encerramento automático) é encerrado pela tarefa agendada, que roda a cada hora. Nada é apagado: o atendimento continua legível. O aluno pode iniciar um novo.
Os atendimentos não são encerrados sozinhos
O cron do Moodle não está rodando ou a tarefa "Encerrar atendimentos inativos do chat com tutor" está desabilitada (Administração do site → Servidor → Tarefas → Tarefas agendadas). A mesma tarefa fecha as conversas abertas dos cursos terminados.
Avaliação
O aluno não consegue avaliar
Um atendimento só pode ser avaliado quando todas estas condições são verdadeiras:
- A Avaliação do atendimento está ativada nas configurações.
- O atendimento está encerrado e o tutor respondeu pelo menos uma vez (um recado nunca respondido, que é encerrado sozinho após o tempo de inatividade, não pode ser avaliado).
- Quem avalia é o aluno do atendimento.
- O atendimento terminou há menos que o Prazo para avaliar (7 dias por padrão).
- Ele ainda não foi avaliado: cada atendimento recebe uma só avaliação.
Se uma dessas condições falha, aparece "Este atendimento não pode ser avaliado." ao tentar enviar. O comentário aceita até 1000 caracteres.
O tutor quer ver as avaliações que recebeu
Os tutores não veem avaliações nem médias. Elas aparecem apenas na supervisão, para quem tem a permissão local/tutorchat:viewreports.
Som e avisos
O som não toca
- Confira o botão Som: ligado / Som: desligado (cabeçalho da janela do aluno; barra do topo da Área do tutor). Por padrão vem ligado.
- O som só toca para mensagens de uma conversa que o usuário não está vendo no momento.
- Navegadores podem bloquear som até o usuário interagir com a página; ao ligar o botão de som, o chat toca um som curto de confirmação.
Os avisos do navegador não funcionam
Os avisos existem na Área do tutor (o aluno só tem o som). Por padrão vêm desligados.
- Ligue Avisos do navegador; o navegador pede permissão.
- Se aparece "Os avisos estão bloqueados para este site nas configurações do navegador.", a permissão foi negada: libere as notificações para o site nas configurações do navegador e atualize a página.
- "Este navegador não oferece avisos." significa que o navegador não suporta notificações.
O aviso só é mostrado quando a aba está em segundo plano, e traz o nome do aluno e "Nova mensagem", sem o conteúdo da mensagem.
Cartões de atividade
Por que o cartão mostra "Item indisponível"?
Porque, para quem está lendo, o item não existe mais ou não pode ser visto: foi apagado do curso, foi ocultado pelo professor (depois de enviado), ou o cartão aponta para um item de outro curso. O texto da mensagem continua lá. Peça ao tutor que confirme o item. O tutor, que vê itens ocultos, pode continuar vendo o cartão normalmente.
Por que o cartão mostra o motivo e não tem o botão Abrir?
O item está restrito para o aluno: existe e aparece na página do curso, mas ainda não abre (uma data, a conclusão de outra atividade, um grupo...). O motivo é o texto que o próprio Moodle calcula para aquele aluno. Quando a condição for cumprida, o cartão passa a mostrar Abrir.
O tutor não consegue enviar um item: ele aparece desabilitado
A marca Oculto para o aluno significa que o aluno não pode saber que o item existe. Torne o item visível no curso (ou aguarde a data de exibição) e recarregue a Área do tutor. Itens apenas restritos podem ser enviados.
O destaque não apareceu depois de "Ver no curso"
O item é procurado na página do curso por até 3 segundos. Se não for encontrado, o botão do chat mostra "Procure por: nome do item". As causas mais comuns: o formato do curso não é um dos verificados (Tópicos, Semanal, Atividade única e Tiles; veja a seção 5-B do guia do administrador); o item está em uma seção recolhida que o formato só carrega depois; o item foi movido de seção ou apagado; ou o navegador bloqueia o sessionStorage (então a navegação acontece sem destaque). Se você abriu o botão em outra aba (Ctrl+clique), o destaque pode não aparecer.
O atalho "Anexar" não aparece para o aluno
Ele só aparece na página de uma atividade ou de uma seção do curso, para itens que o aluno vê, e com a conversa aberta ou prestes a começar. Na página inicial do curso (sem seção selecionada), em páginas de notas ou de participantes e em cursos onde o chat está desativado ele não é oferecido.
As atividades atrasadas ou os próximos prazos não aparecem no painel do tutor
O painel usa o calendário do Moodle com as datas do aluno. Não aparecem: atividades já entregues ou concluídas, eventos de abertura ("abre em"), atividades sem data de entrega e atividades que o papel do tutor não pode ver. Limite conhecido: a lista de atrasadas parte das 50 atividades vencidas mais antigas do aluno. Cada prazo aparece com data e hora, escritas pelo servidor no fuso horário do perfil do tutor (o mesmo das páginas do Moodle).
As atividades de uma subseção não aparecem no seletor
Elas aparecem em um grupo próprio, logo depois da seção que contém a subseção, com o nome da subseção como título. O título do grupo não é selecionável (a subseção em si é enviada pela atividade "subseção" listada na seção onde ela está). Uma subseção oculta ou restrita para o aluno lista as atividades como Oculto para o aluno; uma subseção que o tutor não pode ver, ou sem nenhum item visível para ele, não aparece.
As datas do cartão são diferentes das que vejo na página da atividade
O cartão mostra sempre as datas do aluno da conversa (com as prorrogações individuais e de grupo dele), em qualquer tela, inclusive a sua. Na página da atividade você vê as datas da sua própria visão, que podem diferir se o aluno tem uma prorrogação. A hora segue o fuso horário do perfil de quem lê.
O seletor de atividades demora para abrir
O estado "como o aluno vê" exige ler o curso como duas pessoas e é calculado uma vez por atendimento, na primeira abertura do seletor. Em um curso com algumas centenas de atividades isso pode levar alguns segundos. As demais aberturas usam a lista guardada no navegador.
Painel do aluno (tutor)
O painel não mostra a nota, a conclusão ou algum link
Cada item respeita as permissões do tutor no Moodle. Por exemplo, a nota exige moodle/grade:viewall e o relatório "Relatório do usuário" ativado; a conclusão exige o acompanhamento de conclusão no curso e report/progress:view; o administrador pode desativar o bloco com Mostrar desempenho. Um campo personalizado só aparece se o administrador o escolheu, o tutor pode vê-lo e ele tem valor. A nota total também é omitida de tutores sem moodle/grade:viewhidden quando o curso tem itens de nota ocultos.
Supervisão
A pessoa não vê a Supervisão do chat
Ela precisa de local/tutorchat:viewreports no contexto do sistema. Conceder em um curso ou categoria não funciona, e nenhum papel a recebe por padrão. Ver conversas exige também local/tutorchat:viewconversations.
"Os dados ainda não foram calculados."
O resumo de estatísticas nunca rodou. Use Atualizar agora ou aguarde a tarefa das 03:00 (com o cron do Moodle funcionando).
"Os dados foram atualizados há menos de 5 minutos."
O botão Atualizar agora se recusa a recalcular enquanto o resumo tem menos de 5 minutos. Se aparece "Não foi possível atualizar agora.", houve uma falha na chamada ao servidor; tente de novo.
Os números da supervisão não batem com o que acabou de acontecer
As abas Visão geral, Tutores e Atendimentos vêm do resumo, atualizado de madrugada ou por Atualizar agora. A aba Agora lê o estado atual e se atualiza sozinha a cada 30 segundos; ela ignora o período e só aplica os filtros de categoria, curso e tutor.