ForHosting KIT · Ferramentas para dev

Webhook com atraso

O serviço de callback com atraso recebe uma URL e um intervalo — dez minutos, duas horas, três dias — e chama esse endereço uma única vez quando o prazo vence. É o “me avise depois” do mundo dos sistemas, sem fila própria, sem worker e sem servidor esperando.

● Estávelpor callbackUS$ 0,002

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

Use pelo WebAPIE-mailApp em breveTelegram em breve

Atraso não é agendamento recorrente

Aqui a lógica é de tiro único: você informa uma URL, um intervalo — dez minutos, seis horas, três dias — e, se quiser, um corpo de dados. Quando o prazo vence, o serviço chama o endereço uma única vez e pronto. Para rotinas que se repetem todo dia no mesmo horário, o caminho é o agendamento com cron; o callback com atraso existe para o “daqui a X tempo”, contado a partir de agora.

O padrão “lembre-me depois” sem fila própria

Implementar isso em casa exige fila, worker e monitoramento — três peças a mais para manter de pé. Com o callback como serviço, o seu código faz uma única chamada HTTP no momento em que o evento acontece (“pedido criado”, “boleto emitido”) e esquece o assunto. Quem lembra é a gente: no vencimento do prazo, sua URL recebe a chamada com os dados que você mandou junto ao agendar.

Bons prazos para começar

Trinta minutos depois do carrinho abandonado, um e-mail de lembrete. Quarenta e oito horas depois de emitir um boleto, uma conferência de pagamento. Vinte e quatro horas depois de um chamado respondido, a checagem de satisfação. Repare no padrão: o valor não está na chamada em si, e sim em ela chegar exatamente quando o contexto ainda está quente — nem antes, nem tarde demais.

Preço: US$ 0,002 por callback

Cada callback agendado custa US$ 0,002 — dois décimos de centavo de dólar. Não há mensalidade, franquia nem custo de fila parada: mil lembretes programados saem por US$ 2. A compra é direta, sem cadastro, e o pagamento é via PayPal. Para quem hoje mantém um worker rodando só para “esperar a hora”, a conta costuma fechar já no primeiro mês.

Casos de uso

Conferência de boleto 48 horas depois

Uma loja virtual de Belo Horizonte emite o boleto e, na mesma hora, agenda um callback para dali a 48 horas. Quando a chamada volta, o sistema confere se o pagamento compensou e libera o pedido — ou dispara o lembrete.

Carrinho abandonado com o timing certo

O e-commerce da Distribuidora Horizonte Verde S.A. agenda um callback 30 minutos depois que o cliente some do checkout. Se o pedido não fechou, o endpoint manda o e-mail de lembrete com o link do carrinho.

Follow-up de atendimento sem planilha

No sistema de chamados da TecnoSul Soluções Digitais ME, cada resposta ao cliente agenda um callback de 24 horas. Sem réplica nesse prazo, o chamado é encerrado automaticamente e a pesquisa de satisfação sai.

Perguntas frequentes

Qual a diferença entre isso e um cron?

O cron repete: todo dia às 8h, toda segunda. O callback com atraso dispara uma única vez, contado a partir do momento em que você o cria — “daqui a 30 minutos”, “daqui a 3 dias”. São ferramentas irmãs para problemas diferentes.

Posso mandar dados junto para receber de volta?

Sim: os dados que você incluir ao agendar acompanham o callback. É assim que o seu endpoint sabe de qual pedido, boleto ou chamado se trata, sem precisar consultar mais nada.

Quanto custa agendar mil lembretes?

US$ 2 — o preço é US$ 0,002 por callback, sem mensalidade. Você paga pelo que agendar, e o pagamento é direto, via PayPal.

Preciso de servidor para receber a chamada?

Precisa de uma URL sua acessível pela internet — pode ser uma função serverless de custo quase zero ou uma rota no sistema que você já tem. O callback é uma chamada HTTP comum.

O que acontece com os dados depois da entrega?

Eles existem para uma coisa só: ser entregues no seu endpoint na hora marcada. Não são reaproveitados para nenhuma outra finalidade.

Tem versão grátis no navegador?

Não — agendar uma chamada para o futuro exige um serviço rodando do lado de cá o tempo todo, então esta capacidade é só via API, paga por uso, com o preço publicado nesta página.

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/dev/delay

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/dev/delay \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"input":"…"}'

const res = await fetch("https://api.kit.forhosting.com/dev/delay", {
  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/dev/delay",
    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/dev/delay", 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/dev/delay", 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": "dev.delay",
  "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 →