Um job agendado tem dois resultados possíveis: rodou e entregou; ou rodou, disse
“concluído” e ninguém recebeu nada. O segundo caso é o mais comum — e o mais difícil de ver,
porque o status é verde.
O que faz um job “concluir” sem entregar
- Plataforma não configurada no processoVocê habilita o canal na configuração, mas
o processo que entrega já estava no ar e leu a configuração antiga. O job termina com
“plataforma não configurada” e status de sucesso.
- Execução manual ≠ execução agendadaRodar o job à mão usa outro caminho de entrega
que o do agendador. O teste manual fica verde e o agendado nunca entrega.
- Arquivo de saída sem o canalO job grava o texto em um arquivo em vez de falar com
a API do canal. Parece entrega, é log.
- Token no lugar erradoA credencial existe no ambiente do seu shell, mas não no
ambiente do agendador — e o erro aparece como “sem permissão”, não como “sem token”.
A prova que não engana
Só existe uma prova de entrega: o identificador que o canal devolveu quando aceitou a
mensagem. Guarde e mostre esse id no relatório do job.
OK sendMessage message_id=48293 chat=-100...
Status do job, código de saída e log “sucesso” são todos compatíveis com a mensagem nunca ter
saído. O id não.
Como testar de verdade
- Force a condição de entregaUm job que “não tem nada a fazer” não testa nada.
Rode uma vez com conteúdo garantido.
- Leia o resultado do lado do canalConfirme no canal (ou pela API) que a mensagem
chegou — não no log do agendador.
- Registre o caminho usado“Executado pelo agendador” e “executado à mão” precisam
aparecer no log: sem isso, você está testando o caminho errado.
Se o job é silencioso quando não há nada a fazer
Silêncio por design precisa de prova de que o job rodou: uma linha de log por execução.
Sem isso, “não recebi nada” e “o job não rodou” ficam indistinguíveis — e você descobre a falha
semanas depois.
Ver o pacote completo
Ver todas as skills
Quer isso montado no seu projeto? Setup guiado a partir de
R$ 1.500, com o primeiro ciclo rodado junto.
← todas as skills
Receba o próximo artigo
Sai quando eu publicar, junto com a skill grátis usada aqui. Sem spam, e o descadastro é de um clique.
Pagamento processado pelo
Stripe — nenhum dado de cartão passa por este servidor. Entrega imediata após a confirmação.
Termos, entrega e reembolso.