Pular para o conteúdo principal
SVDY Logo
Guia para desenvolvedores
Disponível agora
Professional tier

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, fila dead-letter se seu endpoint cair.

O que você pode fazer

As primeiras vitórias do dia. Sem necessidade de engenharia para um admin de PME configurar.

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.

Retry + dead-letter queue

Respostas não-2xx fazem retry em 1m, 5m, 30m, 2h, 12h. Após 5 falhas, a entrega vai para a 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 admin com as credenciais em mãos.

1

Crie o webhook no admin 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.

2

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 "", 200
3

Teste 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.

4

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 o admin da sua organização → Integrações e conecte esta integração em menos de 5 minutos.