Como corrigir notificações de Q&A que não chegam aos instrutores no Tutor LMS
O que é notificação de QA no Tutor LMS?
As notificações de Q&A do Tutor LMS são os e-mails enviados ao instrutor sempre que um aluno pública uma nova pergunta no painel de Perguntas e Respostas de um curso. Esse aviso é gerado pelo addon Email do Tutor LMS Pro, por meio do gatilho chamado New Q&A Message na lista de e-mails do instrutor. Quando tudo funciona, o instrutor recebe o e-mail e responde sem precisar abrir o painel toda hora.
A falha aparece quando o aluno pergunta e nenhum e-mail chega à caixa do instrutor, embora a pergunta apareça normalmente dentro do Tutor LMS. Segundo a documentação oficial do Themeum, o recurso depende de três condições: o addon Email ativado em Tutor LMS Pro, o gatilho New Q&A Message ligado nas Configurações de E-mail e um SMTP devidamente configurado, já que o Tutor LMS recomenda SMTP em vez de confiar apenas na função padrão de e-mail do WordPress.
Como identificar
- O aluno pública uma pergunta no painel de Q&A do curso, ela aparece na aba Q&A do Tutor LMS, mas o instrutor não recebe nenhum e-mail de aviso.
- Na lista de e-mails do instrutor, em Configurações de E-mail do Tutor LMS, o gatilho ‘New Q&A Message’ aparece desligado.
- Outros e-mails do Tutor LMS (como matrícula ou conclusão) também não chegam, indicando que o problema é de entrega de e-mail no site todo, não só do Q&A.
- O addon Email não está listado como ativo em Tutor LMS Pro, na seção de Add-ons, então nenhum gatilho de e-mail é disparado.
- Em testes, o e-mail de teste do próprio Tutor LMS ou de um plugin SMTP volta com erro de envio ou simplesmente não é entregue.
Como prevenir
- Mantenha o addon Email do Tutor LMS Pro sempre ativo e revise a lista de gatilhos do instrutor após cada atualização, já que um update pode reverter ajustes.
- Configure um SMTP confiável desde o início do site, com domínio próprio e autenticação SPF e DKIM, em vez de depender da função padrão de e-mail do WordPress.
- Use um cron real no servidor para os e-mails em lote do Tutor LMS, evitando que avisos de Q&A fiquem presos quando o site recebe poucas visitas.
- Envie um e-mail de teste pelo plugin SMTP sempre que mudar de provedor de envio ou de hospedagem, para detectar falhas de entrega antes que um instrutor reclame.
Causa
- O addon Email do Tutor LMS Pro está desativado em Tutor LMS Pro, na seção de Add-ons; sem ele nenhum gatilho de e-mail, incluindo o New Q&A Message, é disparado.
- O gatilho 'New Q&A Message' está desmarcado na lista de e-mails do instrutor dentro de Configurações de E-mail do Tutor LMS, então o aviso da pergunta nunca é gerado.
- O site não tem um SMTP configurado e a função wp_mail do WordPress falha na hospedagem, fazendo o e-mail do Tutor LMS ser recusado ou cair em spam, conforme a recomendação de SMTP da documentação do Themeum.
- O WP-Cron está travado ou desabilitado e os e-mails enfileirados do Tutor LMS, que dependem do cron para envio em lote, ficam parados sem nunca sair.
- O endereço de remetente (From Email) configurado nas Configurações de E-mail do Tutor LMS usa um domínio sem autenticação SPF ou DKIM, e o provedor do instrutor bloqueia a mensagem antes da entrega.
Como resolver
- Ative o addon Email do Tutor LMS Pro: O addon Email é o que dispara os e-mails do Tutor LMS. Sem ele ativo, nenhum aviso de pergunta sai. Ative o addon antes de qualquer outro ajuste, pois ele é a base das notificações.
Painel WP -> Tutor LMS Pro -> Add-ons Localize o cartão 'Email' e ligue a chave para ativar o addon - Ligue o gatilho New Q&A Message para o instrutor: Com o addon ativo, abra as Configurações de E-mail e, na lista de e-mails do instrutor, marque o gatilho que avisa sobre novas perguntas. Esse é o e-mail específico do Q&A.
Painel WP -> Tutor LMS -> Configurações -> Email Settings Na lista de e-mails 'To Instructors', ligue o gatilho 'New Q&A Message' Salve as configurações - Configure um SMTP confiável no site: A documentação do Tutor LMS recomenda SMTP em vez de confiar na função padrão do WordPress. Instale um plugin SMTP, conecte um provedor de envio e envie um e-mail de teste para confirmar a entrega antes de testar o Q&A.
Painel WP -> Plugins -> Adicionar novo -> instale e ative um plugin SMTP (ex.: WP Mail SMTP) Configure o host, porta, usuário e autenticação do seu provedor de e-mail Use a aba de teste do plugin SMTP para enviar um e-mail de verificação - Confira o remetente nas Configurações de E-mail: Ajuste o From Email e o From Name do Tutor LMS para um endereço do seu próprio domínio, com SPF e DKIM válidos. Remetente de domínio diferente do servidor costuma ser bloqueado pelo provedor do instrutor.
Painel WP -> Tutor LMS -> Configurações -> Email Settings Defina o 'From Email' com um endereço do domínio do site Confirme com seu provedor de e-mail que SPF e DKIM do domínio estão válidos - Garanta que o WP-Cron está rodando: Os e-mails do Tutor LMS dependem do cron para sair em lote. Se o cron estiver travado, dispare-o manualmente e, em produção, configure um cron real no servidor para não depender de visitas ao site.
wp cron event list --path=/caminho/do/wordpress wp cron event run --due-now --path=/caminho/do/wordpress Configure um cron real no servidor chamando wp-cron.php e defina DISABLE_WP_CRON true no wp-config
<?php
// Loga no debug.log toda tentativa de e-mail do Tutor LMS e captura
// falhas de entrega, para diagnosticar a notificacao de Q&A que nao chega.
add_action( 'phpmailer_init', function ( $phpmailer ) {
error_log( 'TUTOR QA MAIL -> assunto: ' . $phpmailer->Subject . ' | para: ' . implode( ',', array_keys( $phpmailer->getToAddresses() ) ) );
} );
add_action( 'wp_mail_failed', function ( $error ) {
error_log( 'TUTOR QA MAIL FALHOU -> ' . $error->get_error_message() );
} );














