TutorChat Docs

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:

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

AvisoMotivo
"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:

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

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.

  1. Ligue Avisos do navegador; o navegador pede permissão.
  2. 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.
  3. "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)

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.