Como agendar tarefa no Plesk sem errar o tipo
O caminho pela tela real do Plesk, do tipo de tarefa ao histórico de execução, que é onde se descobre se ela rodou e falhou ou simplesmente não rodou.

Resposta curta: O Plesk pede o tipo de tarefa antes do comando. São três opções: Run a command, Run a PHP script e Fetch a URL. Escolher a errada tanto faz a tarefa falhar na execução quanto registrar sucesso sem efeito nenhum no site, caso típico do Fetch a URL que recebe 200 de uma página qualquer e dá a execução por boa.
Neste artigo
- Onde fica a tela de tarefas agendadas no Plesk
- Os três tipos de tarefa, e qual deles usar em cada caso
- Por que o caminho do interpretador precisa ir escrito por extenso
- Montar o agendamento sem errar o horário
- Qual opção de notificação escolher sem transformar e-mail em ruído
- Como ler o histórico de execução para separar os três tipos de falha
- Checklist antes de sair da tela
- Como desfazer sem quebrar nada
No Plesk, tarefa agendada não começa pelo comando. Começa por uma pergunta: que tipo de tarefa é essa. A tela oferece três opções antes de você digitar qualquer coisa, e escolher a errada é o motivo mais comum de a tarefa não produzir o efeito esperado, seja porque falha na execução, seja porque registra sucesso sem fazer nada.
Este guia segue a tela do Plesk Onyx, conforme o Plesk Onyx Customer Guide. Em versões mais novas do painel os nomes dos itens podem ter mudado de lugar ou de rótulo; a verificação aqui se apoia só no guia do Onyx. Os caminhos de arquivo e horários usados aqui são exemplos, não parâmetros obrigatórios.
Onde fica a tela de tarefas agendadas no Plesk
Entre no Plesk com o login do seu domínio. No menu da esquerda, clique em Websites & Domains (ou Sites e Domínios, se o painel estiver em português).
Role a página até achar Scheduled Tasks (Tarefas Agendadas). Em alguns temas o item fica dentro de Dashboard ou atrás do botão Show More / Mostrar mais, no fim do bloco do domínio.
Se o item não aparece de jeito nenhum, a permissão de tarefas agendadas não foi liberada para a sua assinatura. Isso é controlado pelo provedor, não por você. Nesse caso, pedir a liberação ao suporte é o único caminho; não existe ajuste no painel do cliente que crie o item sozinho.
Dentro de Scheduled Tasks, clique em Add Task (Adicionar Tarefa). É aqui que aparece a pergunta que muda tudo.
Os três tipos de tarefa, e qual deles usar em cada caso
O Plesk pede, antes do resto, o Task type. São três opções, e elas não são equivalentes.
| Tipo na tela | O que o Plesk executa | Quando usar |
|---|---|---|
| Run a command | Um comando de shell, como se você estivesse no terminal | Scripts de sistema, wp-cli, chamadas a binários, comandos compostos |
| Run a PHP script | Um arquivo .php do seu site, usando o PHP do domínio |
Rotinas internas do site que precisam da versão de PHP configurada no painel |
| Fetch a URL | Faz uma requisição HTTP para o endereço informado | Endpoints web, webhooks, WP-Cron chamado por URL |
A diferença prática que mais pega gente:
- Run a PHP script usa a versão de PHP que você escolheu para o domínio em PHP Settings. Você não precisa escrever o caminho do interpretador.
- Run a command não assume nada. Se você digitar só
script.php, o shell não sabe o que fazer com isso. Precisa do interpretador escrito na linha. - Fetch a URL não executa arquivo nenhum: ele busca uma página. Se a URL responder 200 e a página não disparar o processo que você queria, o histórico vai registrar sucesso mesmo assim.
Como agendar o WP-Cron do WordPress pelo Plesk
Passar o WP-Cron para o Plesk tem dois passos: agendar a chamada externa e, depois, desativar o cron interno do WordPress. Para a chamada agendada, os dois caminhos documentados funcionam:
- Fetch a URL apontando para
https://seudominio.com.br/wp-cron.php?doing_wp_cron(exemplo). - Run a PHP script apontando para o arquivo
wp-cron.phpdentro dehttpdocs.
Se você usa wp-cli, aí é Run a command, e com caminho absoluto do interpretador. Veja a próxima seção.
Desativar o cron interno do WordPress no wp-config.php
Enquanto o WordPress não for avisado, ele continua disparando o wp-cron.php a cada visita, e a tarefa do Plesk vira a segunda chamada em vez da única. O desligamento é feito no wp-config.php, na raiz do site.
Antes de editar: faça uma cópia do arquivo. No File Manager do Plesk, abra a pasta httpdocs, marque o wp-config.php, clique em Copy e guarde a cópia (ou use Download e salve no seu computador). Se o site sair do ar depois da edição, é essa cópia que você restaura por cima.
Com a cópia feita, selecione o wp-config.php e clique em Edit (editor de código do Plesk). Procure a linha:
/* That's all, stop editing! Happy publishing. */
Em instalações mais antigas ela aparece como /* That's all, stop editing! Happy blogging. */. Insira, em uma linha acima dela:
define('DISABLE_WP_CRON', true);
Salve e abra o site em uma aba anônima. Se carregar normalmente, deu certo. Se aparecer tela branca ou erro, você provavelmente colou depois da linha de parada ou deixou uma aspa fora do lugar: restaure a cópia e tente de novo.
Para confirmar que a troca funcionou, agende a tarefa a cada 15 minutos por um dia e veja se as rotinas do site (envio de e-mail agendado, publicação programada, backup de plugin) continuam saindo no horário. Se pararem, religue o cron interno trocando true por false enquanto investiga.
Por que o caminho do interpretador precisa ir escrito por extenso
Em Run a command, a linha roda em um ambiente enxuto. Execução agendada costuma não carregar o seu perfil de shell, e isso não é item do guia do Onyx: é comportamento geral de cron, que vale tratar como hipótese a confirmar no seu servidor. Isso significa que atalhos que funcionam quando você está logado por SSH podem simplesmente não existir na hora da execução agendada.
A regra é: escreva o caminho completo do interpretador e o caminho completo do script.
Exemplo de linha para um script PHP, usando o PHP 8.2 do Plesk:
/opt/plesk/php/8.2/bin/php /var/www/vhosts/seudominio.com.br/httpdocs/rotina.php
Exemplo para um script em Python:
/usr/bin/python3 /var/www/vhosts/seudominio.com.br/scripts/importa.py
Duas coisas desse exemplo você precisa confirmar no seu servidor antes de salvar:
- A versão de PHP disponível. O caminho
/opt/plesk/php/8.2/bin/phpsó existe se o PHP 8.2 estiver instalado. Em Websites & Domains > PHP Settings você vê qual versão o domínio usa. Se o painel mostra 8.1, troque o8.2por8.1na linha. - O caminho real do seu site. O padrão do Plesk em Linux é
/var/www/vhosts/SEU-DOMINIO/httpdocs, mas o diretório do documento pode ter sido alterado. O File Manager do Plesk mostra o caminho completo quando você abre as propriedades de um arquivo.
Se você errar o caminho, a tarefa não fica silenciosa: ela roda, falha, e o erro fica registrado. A seção do histórico mostra onde ler isso.
Montar o agendamento sem errar o horário
Depois do tipo e do comando, o Plesk pede o Run (quando rodar). A tela oferece atalhos prontos (a cada hora, diariamente, semanalmente, mensalmente, anualmente) e a opção Cron style, que aceita a expressão de cinco campos clássica.
A ordem dos campos no estilo cron é sempre a mesma:
minuto hora dia-do-mês mês dia-da-semana
Exemplos, todos fictícios, para calibrar a leitura:
| Expressão | Significado |
|---|---|
*/15 * * * * |
A cada 15 minutos |
0 3 * * * |
Todo dia às 03:00 |
30 2 * * 1 |
Toda segunda-feira às 02:30 |
0 0 1 * * |
No dia 1 de cada mês, à meia-noite |
O campo Description é opcional e vale a pena preencher. Daqui a oito meses, 0 3 * * * com um caminho longo não diz nada; "limpeza de carrinhos abandonados" diz.
O agendamento usa o relógio do servidor, não o seu
O agendamento usa o relógio do servidor, não o do seu navegador. Se o servidor está em UTC e você mora no horário de Brasília, 0 3 * * * dispara às 00:00 no seu relógio. Antes de assumir que a tarefa "não rodou no horário", confira o horário do sistema. Via SSH, o comando é:
date
A saída traz data, hora e a sigla do fuso (por exemplo UTC ou -03). Compare com o horário que você esperava.
Qual opção de notificação escolher sem transformar e-mail em ruído
O Plesk pergunta o que fazer com a saída da tarefa (o que o comando imprime na tela quando roda). Os nomes da coluna abaixo são paráfrases em português, não o rótulo literal: o texto exato do item muda de uma versão do painel para outra, e no Onyx em inglês ele aparece na lista suspensa logo abaixo do campo do comando, na mesma tela de Add Task. Procure pelo item que descreve o comportamento, não pela frase idêntica. As opções que mais importam no diagnóstico são estas (a lista não esgota o que o painel oferece):
| Comportamento na tela (paráfrase) | O que acontece | Boa para |
|---|---|---|
| Não notificar | A saída não vira e-mail | Tarefas frequentes e barulhentas, como algo a cada 5 minutos |
| Notificar só quando houver saída | E-mail só se o comando imprimir alguma coisa | Scripts silenciosos, que só imprimem algo quando dá problema |
| Notificar só quando houver erro | E-mail quando a execução termina reclamando de algum problema | Rotina já estável que você quer acompanhar sem ruído |
| Notificar sempre | E-mail em toda execução | Fase de teste de uma tarefa nova |
| Enviar para um endereço específico | Direciona o e-mail para a caixa que você digitar | Quando quem monitora não é quem administra o painel |
"Notificar só quando houver saída" parece a opção equilibrada, e é, desde que o script fique calado quando tudo dá certo. Muito script bem-escrito imprime um resumo em toda execução bem-sucedida. Aí a opção vira armadilha: isso dá um e-mail por dia, o e-mail vira ruído, o ruído vira filtro, e o filtro engole justamente o dia em que a mensagem era um erro. Antes de escolher essa opção, rode o comando uma vez e veja se ele imprime algo quando termina bem.
Recomendação prática, contra o impulso de monitorar tudo: ligue notificar sempre durante os primeiros dias, confirme que a saída é a esperada, e depois troque para não notificar se você já tem o histórico de execução como fonte de verdade. Monitorar duas vezes a mesma coisa não é redundância, é cegueira por volume.
Como ler o histórico de execução para separar os três tipos de falha
O Plesk guarda um histórico de execução, e é nele que o diagnóstico começa.
Na lista de Scheduled Tasks, o Plesk mostra, para cada tarefa, informação da última execução: quando rodou e o resultado. Ao abrir a tarefa, você encontra o registro de execuções, com o número que o comando devolveu ao terminar e a saída que ele imprimiu. Esse número é o jeito de o Plesk dizer se deu certo: zero significa que o comando terminou sem reclamar, e qualquer outro número significa que ele terminou acusando algum problema.
A leitura é direta:
- Tarefa nunca executada. A linha de última execução está vazia. Então o problema é o agendamento ou a tarefa está desativada. Confira o botão de ativar/desativar na própria lista e reveja a expressão de horário.
- Tarefa executada com erro. Existe registro, e o número que o comando devolveu é diferente de zero, ou seja, ele terminou reclamando. Então o agendamento está certo e o problema é o comando. Caminho errado, permissão, interpretador inexistente, dependência faltando.
- Tarefa executada com sucesso e nada aconteceu no site. Aqui o suspeito número um é o tipo errado. Em Fetch a URL, uma página de erro amigável que responde 200 tende a ser contabilizada como sucesso, porque o que se verifica é a resposta HTTP, não o que o código fez por dentro. O guia do Onyx não detalha esse critério, então confirme no seu próprio histórico: dispare a tarefa, abra o registro e compare o resultado com o efeito esperado no site.
Tratar esses três casos como "a tarefa não rodou" é o erro que mais custa tempo. O histórico separa os três em dois cliques.
Use Run Now em vez de esperar as 03:00
Não espere até as 03:00 para descobrir que o caminho estava errado. Na lista de tarefas, selecione a tarefa e use Run Now (Executar Agora). O Plesk dispara na hora e grava o resultado no histórico, igual a uma execução agendada.
Faça isso logo depois de salvar. Se o retorno for erro, você corrige com o problema fresco na cabeça.
Checklist antes de sair da tela
Antes de salvar a tarefa, confira, nesta ordem:
- O tipo está certo. Comando, script PHP ou URL. Se você digitou um caminho de arquivo no campo de um tipo que espera URL, volte.
- O interpretador está escrito por extenso, se o tipo for comando.
/opt/plesk/php/8.2/bin/php, nãophp. - O caminho do script é absoluto e bate com o que o File Manager mostra.
- A versão de PHP do caminho existe e é a mesma que o site usa, se a rotina depende de extensões do site.
- A expressão de horário foi lida em voz alta na ordem minuto, hora, dia, mês, dia da semana.
- A notificação está em "sempre" durante o período de teste.
- A descrição foi preenchida com uma frase em português que o você do ano que vem vai entender.
Depois de salvar, clique em Run Now e abra o histórico. Se o retorno foi sucesso e o efeito apareceu no site, a tarefa está pronta. Se o retorno foi sucesso e nada mudou, volte ao item 1: quase sempre é o tipo.
Como desfazer sem quebrar nada
Tarefa agendada mexe em dados. Antes de colocar no ar uma rotina que apaga, importa ou reescreve qualquer coisa, faça backup do site e do banco em Websites & Domains > Backup Manager. Um script de limpeza com um caminho a mais no lugar errado apaga mais do que você imaginava, e às 03:00 não tem ninguém olhando.
Para parar uma tarefa sem perder a configuração, use o controle de ativar/desativar na lista de Scheduled Tasks. A tarefa continua salva, com histórico, e não dispara. Isso é melhor que excluir: se o problema era outro, você religa em um clique em vez de reconstruir a linha de comando de memória.
Excluir só quando tiver certeza de que a rotina não volta. O histórico de execução vai junto.
Referências
- Documentação oficial (plesk) — Plesk Onyx Customer Guide. Consultado em 2026-10-28.