ForHosting KIT · Avisos e automações

Agendar tarefa

O flow.schedule dispara uma tarefa ou um fluxo no horário que você marcar, de novo e de novo, sem ninguém apertar o botão. Todo dia às 8h, toda segunda de manhã, todo dia 1º do mês — você define o ritmo e a capacidade cuida do relógio. Cada execução custa US$ 0,002.

● Estávelpor execuçãoUS$ 0,002

Ver a API — US$ 0,002 Ver a API

Use pelo WebAPIE-mailApp em breveTelegram em breve

O cron que ninguém quer manter

Tarefa recorrente sempre esbarra na mesma pergunta: onde isso vai rodar às 8h da manhã? Montar um servidor só para disparar um relatório diário é caro e chato — máquina ligada o tempo todo, atualização de segurança, o dia em que ela cai sem ninguém ver e o relatório simplesmente não sai. O agendamento tira esse peso: você declara o horário e a execução acontece na nuvem, sem máquina sua no meio para cuidar.

Marque o horário no fuso certo

Você diz quando: uma hora fixa do dia, um dia da semana, um dia do mês, ou um intervalo regular. O horário é o de Brasília, então “todo dia às 8h” é 8h para você, sem conta de fuso na cabeça. A partir daí, a tarefa roda sozinha no ritmo marcado e cada execução deixa seu registro. Quer parar? Desliga o agendamento; a próxima simplesmente não acontece.

O que roda no horário

O agendamento não faz o trabalho — ele dá a partida. No horário, ele dispara a tarefa ou o fluxo que você apontar: um resumo por e-mail, uma leitura de página, um lote de processamento, uma cadeia inteira de ponta a ponta. Combinar agendamento com encadeamento é o que transforma “eu faço isso toda segunda de manhã” em algo que acontece sem você — o relatório está pronto quando você abre o computador.

Preço por execução, e o que fazer se falhar

Cada disparo agendado custa US$ 0,002, mais o preço da tarefa ou do fluxo que ele roda. Um relatório diário durante o mês são trinta execuções, US$ 0,06 na partida, além do custo do relatório em si. Se uma execução falhar — porque um passo caiu —, o erro fica registrado, e para as que não podem falhar vale combinar com a nova tentativa automática. Cobrança por uso, preço publicado.

Casos de uso

Fechamento diário às 20h

Às 20h todo dia, o agendamento dispara o fechamento da Padaria Pão Dourado: vendas, encomendas e estoque baixo num e-mail. A dona não aperta nada — o resumo chega no celular como um acerto de ponteiro.

Consolidado de segunda de manhã

Toda segunda às 7h, a Distribuidora Horizonte Verde gera o consolidado semanal de entregas para a diretoria. Quando a reunião das 9h começa, o relatório já está na caixa de todo mundo.

Preços de concorrentes toda manhã

Rafael Almeida Costa acompanha preços de concorrentes: todo dia de manhã, o agendamento lê as páginas e manda o resumo. Ele começa o dia com a foto pronta, sem abrir nada.

Fechamento fiscal no dia 1º

No dia 1º de cada mês, o agendamento da TecnoSul Soluções Digitais processa as notas fiscais do período e monta a planilha para o contador. O fechamento vira rotina automática, não corrida de fim de mês.

Perguntas frequentes

Em que fuso horário o horário é interpretado?

No horário de Brasília. “Todo dia às 8h” é 8h para você, sem precisar fazer conta de fuso. Isso vale para horas, dias da semana e dias do mês.

O que pode ser agendado?

Qualquer tarefa do KIT ou um fluxo inteiro — um e-mail de resumo, uma leitura de página, um lote, uma cadeia de ponta a ponta. O agendamento dá a partida; o trabalho é da tarefa que ele dispara.

E se uma execução agendada falhar?

O erro fica registrado, em vez de sumir em silêncio. Para as execuções que não podem falhar, combine com a nova tentativa automática, que refaz antes de desistir.

Quanto custa deixar algo rodando todo dia?

US$ 0,002 por execução, mais o preço da tarefa que roda. Um disparo diário no mês são trinta execuções, US$ 0,06 na partida — o resto é o custo do trabalho em si. Cobrança por uso.

Preciso manter um servidor ligado para isso?

Não. Essa é a graça: a execução acontece na nuvem no horário marcado, sem máquina sua para manter, atualizar ou vigiar. Você declara o quando, e pronto.

Como pago, e aceita Pix?

O pagamento é via PayPal, em dólar, com compra direta e sem cadastro; Pix ainda não. Preferimos a resposta honesta ao botão que não funciona — e quem tira dúvida é gente de verdade, em espanhol ou inglês.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/flow/schedule

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/flow/schedule \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/flow/schedule", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "input": "…"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/flow/schedule",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "input": "…"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/flow/schedule", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"input":"…"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/flow/schedule", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "input": "…"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "flow.schedule",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →