Skip to main content
En vez de preguntar cada cinco minutos si cambió algo, deja que EdTools te avise. Los administradores registran endpoints HTTPS en Ajustes → API e integraciones → Webhooks.
Requiere EDTOOLS_CLIENT_WEBHOOKS_ENABLED=1 además del módulo platform_integrations.
Se entregan los cambios cubiertos por v1, vengan de donde vengan: del dashboard, del propio Client API o de un proceso interno. No solo los que provocaste tú.

​
Los dieciséis eventos

  • student.created · student.updated
  • admission_application.created · admission_application.updated
  • payment.created · payment.updated
  • program.created
  • course.created
program.updated y course.updated no existen todavía. Si tu integración necesita enterarse de cambios en el catálogo, por ahora tiene que consultar con updatedSince.

​
Cada entrega

Event-Id identifica el hecho; Delivery-Id identifica el intento. Si reintentamos, el Event-Id se repite y el Delivery-Id no — desduplica por Event-Id.

​
La firma

Tres detalles que hay que respetar, o la verificación falla sin motivo aparente:
Si tu framework parsea el body antes de que lo veas, guarda el texto original. Un JSON.parse seguido de JSON.stringify cambia los bytes y rompe la firma.
Un === sobre la firma filtra información por el tiempo de comparación. Usa timingSafeEqual o el SDK.
La tolerancia por defecto es de 5 minutos en cualquiera de las dos direcciones. Sin esa ventana, una entrega capturada sirve para siempre.

​
Verificar con el SDK

Acepta un objeto Headers o un diccionario plano, y toleranceSeconds si necesitas otra ventana. Para probar tu receptor en local, signEdToolsWebhook genera firmas válidas con el mismo algoritmo.

​
Reintentos

Éxito es cualquier 2xx antes de 10 segundos. Los 3xx, 4xx, 5xx y los timeouts quedan registrados y se reintentan desde Trigger.dev; un administrador también puede reintentar a mano desde Entregas.
Responde 200 en cuanto valides la firma y encola el trabajo. Si procesas de forma síncrona y tardas once segundos, EdTools lo cuenta como fallo y te manda el evento otra vez — con lo que acabas haciendo el trabajo dos veces.