Saltar al contenido principal
SVDY Logo
Guía de desarrollador
Disponible ahora
Professional tier

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, cola dead-letter si tu endpoint cae.

Lo que puedes hacer

Las primeras victorias del día. Sin ingeniería: un admin de pyme lo configura.

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 + cola dead-letter

Las respuestas no 2xx se reintentan a 1m, 5m, 30m, 2h, 12h. Tras 5 fallos la entrega va a la 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 admin que tenga las credenciales a mano.

1

Crea el webhook en el admin 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.