Saltar al contenido principal
Guía de desarrollador
Disponible ahora
Professional (plan)

Recibe avisos en el momento exacto en que pasan las cosas

Tu backend recibe un POST en segundos cuando un empleado ficha o se aprueba un permiso — sin polling, sin tareas programadas. Entregas firmadas, reintentos automáticos y una cola de entregas fallidas (cola dead-letter) si tu endpoint deja de responder.

Lo que puedes hacer

Resultados desde el primer día. Sin desarrollo: lo configura el administrador de una pyme.

Tiempo real, sin polling

Fichajes, aprobaciones de permiso, cambios de estado de procesos: tu endpoint recibe un POST en segundos. No hace falta consultar la API cada 5 minutos (más barato y más rápido).

Entregas a prueba de manipulación

Cada petición incluye X-SVDY-Signature: sha256=… calculado sobre el cuerpo JSON con tu secreto. Verifica la firma en tu endpoint para rechazar peticiones falsificadas.

Reintentos y cola de entregas fallidas

Las respuestas no 2xx se reintentan a 1m, 5m, 30m, 2h, 12h. Tras 5 fallos la entrega queda en la cola de entregas fallidas (cola dead-letter), visible en /system/integrations/webhooks. No pierdes eventos cuando tu endpoint tiene un mal día.

Configúralo en 4 pasos

Tiempo estimado: menos de 5 minutos para un administrador que tenga las credenciales a mano.

1

Crea el webhook en la administración de tu organización

Integraciones → Webhooks → Añadir webhook. Introduce la URL del endpoint y elige los eventos que te interesan. SVDY muestra el secreto de firma UNA VEZ — guárdalo ya.

2

Construye el receptor

Tu endpoint acepta POST application/json. Verifica la firma HMAC antes de procesar. Devuelve 200 en menos de 10 segundos (si no, SVDY asume fallo y reintenta).

# 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

Prueba con el botón "Enviar evento de prueba"

Dentro del panel del webhook — dispara un evento sintético a tu endpoint. El código de respuesta + el cuerpo aparecen en el log de entregas al instante.

4

Reenvía entregas fallidas

Cada entrega aparece en el panel de actividad con su estado (entregada / reintentando / fallida). Pulsa "Reenviar" en una entrega fallida para volver a dispararla tras arreglar tu endpoint.


¿Listo para conectarlo?

Abre el panel de administración de tu organización → Integraciones y conecta esta integración en menos de 5 minutos.