Saltar al contenido principal
Webhooks y automatización

Eventos de InTransparency en cualquier herramienta

Cinco eventos firmados con HMAC-SHA256, entregados a tu endpoint HTTPS. Funcionan hoy con Zapier, Make, n8n o cualquier receptor personalizado.

Eventos disponibles

match.created

A talent search produced a match for one of your watchlists/searches.

credential.issued

A W3C Verifiable Credential was issued (project, stage, endorsement).

credential.revoked

A previously issued credential was revoked.

stage.completed

An internship (stage) was completed and evaluated.

exchange.completed

An international exchange enrollment was marked completed.

1. Crea la subscription

Necesitas una clave API (gratuita, desde tu workspace). La subscription acepta cualquier URL HTTPS — incluido un Catch Hook de Zapier o un Custom Webhook de Make.

curl -X POST https://www.in-transparency.com/api/agents/webhooks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://hooks.zapier.com/hooks/catch/123456/abcdef/",
    "events": ["match.created", "credential.issued"]
  }'

# Response — store the secret, it is shown exactly once:
# {
#   "id": "whsub_...",
#   "url": "https://hooks.zapier.com/hooks/catch/123456/abcdef/",
#   "events": ["match.created", "credential.issued"],
#   "secret": "3f8a…64-hex-chars…c1",
#   "active": true
# }

2. Recibe las entregas

Cada evento es un POST JSON. Las entregas fallidas se reintentan; X-InTransparency-Delivery es tu clave de idempotencia.

POST <your-url>
User-Agent: InTransparency-Webhook/1.0
X-InTransparency-Signature: sha256=<hex hmac of the raw body>
X-InTransparency-Delivery: <delivery id, idempotency key>

{
  "event": "match.created",
  "eventId": "cme41…",
  "occurredAt": "2026-06-10T09:30:00.000Z",
  "data": {
    "matchId": "cme41…",
    "candidateId": "ckx91…",
    "candidateName": "Marco B.",
    "matchScore": 87,
    "decisionLabel": "STRONG_MATCH",
    "jobId": null,
    "url": "https://www.in-transparency.com/en/matches/cme41…/why"
  }
}

3. Verifica la firma

Cada entrega se firma con el secret de la subscription. Verifícala antes de confiar en el payload (en Zapier/Make puedes omitir la verificación siempre que la URL del hook se mantenga secreta).

// Node.js — verify the HMAC before trusting the payload
import crypto from 'crypto'

function isValid(rawBody, signatureHeader, secret) {
  const expected = 'sha256=' +
    crypto.createHmac('sha256', secret).update(rawBody).digest('hex')
  return crypto.timingSafeEqual(
    Buffer.from(signatureHeader),
    Buffer.from(expected),
  )
}

Recetas para herramientas no-code

Zapier

Webhooks by Zapier
  1. Nuevo Zap → disparador "Webhooks by Zapier" → Catch Hook
  2. Copia la URL del hook
  3. Regístrala como subscription (paso 1 arriba)
  4. Conecta las acciones: Slack, Sheets, CRM…

Make

Custom webhook
  1. Nuevo escenario → módulo "Webhooks" → Custom webhook
  2. Copia la URL generada
  3. Regístrala como subscription
  4. Make detecta la estructura del payload en el primer evento

n8n

Webhook node
  1. Añade un nodo "Webhook" (POST)
  2. Usa la URL de producción del nodo
  3. Regístrala como subscription
  4. Verifica el HMAC en un nodo Function

¿Necesitas una clave API?

Las claves API y la gestión de subscriptions están incluidas en todos los planes. Escríbenos y te activaremos el acceso.

Solicitar acceso API