Agendamento

O gatilho Agendamento executa o agente em horarios fixos — diario, semanal ou mensal — sem precisar de mensagem de entrada. Você pode salvar o resultado apenas no banco (visivel na página Execuções) ou entregar a resposta em um canal já conectado (Telegram, WhatsApp ou um webhook de API).

Cada agente pode ter vários agendamentos ativos ao mesmo tempo. Cada execução consome créditos normalmente, como qualquer conversa.

Antes de criar

Confirme que:

o agente está ativo e com prompt pronto para rodar sem mensagem do usuário;
se você vai entregar em outro canal, esse canal já está conectado no próprio agente (Telegram, WhatsApp Oficial, etc.);
a organização tem créditos suficientes.

O prompt do agente deve assumir que a mensagem de disparo e automática, no formato [Execucao automatica do agendamento "<nome>"] Inicie sua tarefa programada. — escreva o prompt para reagir a isso.

Criando um agendamento

Abra o agente no painel admin.
Vá para Gatilhos.
No card Agendamentos, clique em + Adicionar Agendamento.
Escolha a Frequência: diaria, semanal ou mensal.
Defina o Horario (no fuso do seu navegador — o sistema converte para UTC automaticamente).
Se semanal, escolha o Dia da semana. Se mensal, escolha o Dia do mês (1 a 28).
Em Canal de entrega, escolha como o agente vai entregar o resultado:
- Salvar apenas no banco (ver em Execuções) — o resultado fica disponível na página Execuções, sem enviar para fora.
- Telegram — envia para um Chat ID. Precisa do bot do Telegram já conectado no agente.
- WhatsApp (QR ou Oficial) — envia para um número de telefone.
- API (webhook) — dispara o webhook configurado no canal API.
Clique em Salvar.

Canal de entrega: detalhes

Cole o Chat ID de destino. Se não sabe onde achar, veja Como obter o Chat ID do Telegram.

Cuidado: não cole o ID do próprio bot (o número antes do : no token). O sistema bloqueia esse erro porque bots não podem enviar mensagens para si mesmos — envie /start para o bot no Telegram e use o ID do seu usuário ou grupo.

Informe o Telefone completo com código do pais, sem + ou espacos. Exemplo: 5511999999999.

API (webhook)

Usa o webhook_url configurado no gatilho API do mesmo agente. Se você não definiu um, o agendamento dispara em modo sincrono e o resultado fica registrado na conversa.

Testando uma execução

Cada agendamento tem um botão Testar. Ele roda o agente agora, como se o horario tivesse chegado, e mostra a mensagem enviada e a resposta na mesma janela. O teste consome créditos.

Use o teste sempre que mudar prompt, ferramentas ou canal de entrega — antes de esperar o próximo disparo agendado.

Editando e removendo

O icone de lapis abre o formulario com a configuração atual. Salvar substitui o agendamento (remove o antigo e cria um novo).
O icone de lixeira remove o agendamento. Os disparos param imediatamente; o histórico de execuções já realizadas continua disponível em Execuções.

Limites e observações

Fuso horario: o horario que você ve no formulario e o do seu navegador. O backend grava em UTC e o pg_cron da Supabase roda em UTC. Por isso, fusos que observam horario de verão podem deslocar 1h duas vezes por ano. O Brasil não tem horario de verão, então o caso comum não e afetado.
Dia do mês máximo: 28. Garantia de que o disparo existe em todos os meses (sem 29, 30, 31).
Modelo do agente: se o agente não tiver LLM configurada, o agendamento usa openai/gpt-4o-mini como fallback.
Falhas: quando o canal de destino não existe mais ou esta inativo, a execução registra um erro visivel em Execuções com a causa.

Problemas comuns

“Canal de destino não encontrado ou inativo”: o gatilho do canal escolhido (Telegram, WhatsApp, API) foi desconectado depois que o agendamento foi criado. Reconecte o canal e tente novamente.
Agendamento não disparou no horario: confira o fuso horario do seu navegador na hora de criar e se o is_active continua marcado.
Telegram retorna erro: confira o Chat ID e se o bot tem acesso ao chat (em grupo, o bot precisa estar adicionado).