Receba aviso no momento em que algo acontece
Seu backend recebe um POST em segundos quando alguém bate ponto ou uma folga é aprovada — sem polling, sem jobs agendados. Entregas assinadas, retentativas automáticas e uma fila de entregas com falha (fila dead-letter) se seu endpoint parar de responder.
O que você pode fazer
Ganhos desde o primeiro dia. Sem desenvolvimento: um administrador de PME configura.
Tempo real, sem polling
Pontos batidos, aprovações de folga, mudanças de status — seu endpoint recebe um POST em segundos. Sem precisar consultar a API a cada 5 minutos (mais barato e mais rápido).
Entregas à prova de adulteração
Cada request inclui X-SVDY-Signature: sha256=… computado sobre o body JSON com seu secret. Verifique a assinatura no endpoint para rejeitar requests forjados a frio.
Retentativas e fila de entregas com falha
Respostas não-2xx fazem retry em 1m, 5m, 30m, 2h, 12h. Após 5 falhas, a entrega fica na fila de entregas com falha (dead-letter queue), visível em /system/integrations/webhooks. Você não perde eventos quando seu endpoint tem um dia ruim.
Configure em 4 passos
Tempo estimado: menos de 5 minutos para um administrador com as credenciais em mãos.
Crie o webhook na administração da organização
Integrações → Webhooks → Adicionar webhook. Insira a URL do endpoint + escolha os eventos. SVDY mostra o secret de assinatura UMA VEZ — salve agora.
Construa o receiver
Seu endpoint aceita POST application/json. Verifique a assinatura HMAC antes de processar. Retorne 200 em até 10 segundos (caso contrário SVDY assume falha e retenta).
# Python receiver — Flask sketch
import hmac, hashlib, json
from flask import request, abort
SVDY_SECRET = b"<paste-from-svdy-admin>"
@app.post("/webhooks/svdy")
def receive():
sig = request.headers.get("X-SVDY-Signature", "")
expected = "sha256=" + hmac.new(
SVDY_SECRET, request.data, hashlib.sha256
).hexdigest()
if not hmac.compare_digest(sig, expected):
abort(401)
event = json.loads(request.data)
# ... handle event["type"], event["data"]
return "", 200Teste com o botão "Enviar evento de teste"
Dentro do painel de detalhes do webhook — dispara um evento sintético para o endpoint. O código de resposta + body aparece no log de entregas instantaneamente.
Reenvie entregas falhadas
Cada entrega aparece no painel de atividade com seu status (entregue / em retry / morta). Clique "Reenviar" em uma entrega morta para re-disparar após corrigir o endpoint.
Pronto para conectar?
Abra a administração da sua organização → Integrações e conecte esta integração em menos de 5 minutos.