Por qué es importante
Los webhooks envían datos de eventos a tus sistemas en el momento en que algo ocurre: un candidato se postula, se programa una entrevista, una oferta de empleo se publica. En lugar de consultar una API continuamente, tus integraciones reciben callbacks HTTP instantáneos con la carga útil completa del evento.
Lo que necesitas
- Una cuenta de Kit con acceso de administrador
- Un endpoint HTTPS que pueda recibir solicitudes POST
Configuración
Navega a Integrations > Webhooks, haz clic en New Webhook y completa:
| Campo |
Obligatorio |
Descripción |
| URL |
Sí |
El endpoint HTTPS que recibirá los eventos |
| Description |
No |
Una etiqueta para ayudarte a identificar este webhook |
| Events |
Sí |
Los tipos de evento a los que quieres suscribirte |
Selecciona eventos individuales o suscríbete a categorías completas. Haz clic en Create Webhook para guardar. Kit genera un secreto de firma que usarás para verificar las cargas útiles.
Eventos disponibles
Kit dispara webhooks en ocho categorías:
Eventos de candidatura
| Evento |
Se dispara cuando |
application.submitted |
Un candidato envía una candidatura |
application.rejected |
Una candidatura es rechazada |
application.rejection_reverted |
Una candidatura previamente rechazada se restablece |
application.advanced |
Una candidatura avanza a la siguiente etapa |
application.withdrawn |
Un candidato retira su candidatura |
application.offer_extended |
Se extiende una oferta a un candidato |
Eventos de oferta
| Evento |
Se dispara cuando |
offer.accepted |
Un administrador acepta una oferta |
offer.declined |
Un administrador rechaza una oferta |
Eventos de entrevista
| Evento |
Se dispara cuando |
interview.scheduled |
Se programa una entrevista |
interview.confirmed |
Un candidato confirma la entrevista |
interview.completed |
Una entrevista se marca como completada |
interview.cancelled |
Una entrevista es cancelada |
interview.no_show |
Un candidato es marcado como ausente |
Eventos de ejercicio de código
| Evento |
Se dispara cuando |
code_assignment.submitted |
Un candidato envía su ejercicio de código |
code_assignment.auto_submitted |
Un ejercicio de código se envía automáticamente al vencer el plazo |
Eventos de revisión
| Evento |
Se dispara cuando |
review.submitted |
Un miembro del equipo envía una revisión |
Eventos de oferta de empleo
| Evento |
Se dispara cuando |
job_posting.published |
Una oferta de empleo se publica |
job_posting.paused |
Una oferta de empleo se pausa |
job_posting.closed |
Una oferta de empleo se cierra |
job_posting.reopened |
Una oferta de empleo se reabre |
Eventos de informes de CSIRT
| Evento |
Se dispara cuando |
csirt.report.submitted |
Un investigador envía un informe de vulnerabilidad |
csirt.report.triaged |
Un informe pasa por el triaje |
csirt.report.validated |
Un informe es validado |
csirt.report.resolved |
Un informe es resuelto |
csirt.report.fix_verified |
Se verifica la corrección de un informe |
csirt.report.dismissed |
Un informe es desestimado |
csirt.report.assessed |
Un informe es evaluado |
csirt.report.assigned |
Un informe es asignado a un miembro del equipo |
csirt.report.bounty_approved |
Se aprueba una recompensa para un informe |
csirt.report.paid |
Se paga una recompensa |
Eventos de Outreach
| Evento |
Se dispara cuando |
outreach.prospect.drafted |
Se redacta un mensaje para un prospecto |
outreach.message.approved |
Un mensaje de outreach es aprobado |
outreach.message.sent |
Un mensaje de outreach es enviado |
outreach.message.bounced |
Un mensaje de outreach rebota |
outreach.message.failed |
Un mensaje de outreach no se puede enviar |
Gestión de webhooks
Cada webhook muestra su estado, los eventos suscritos y el historial reciente de entregas.
-
Pause — Detiene las entregas. Los eventos que ocurran mientras está pausado no se encolan.
-
Resume — Reactiva un webhook pausado o deshabilitado automáticamente. Reinicia el contador de fallos.
-
Edit — Modifica la URL, la descripción o los eventos suscritos.
-
Rotate Secret — Genera un nuevo secreto de firma. Actualiza tu endpoint antes de rotar.
-
Delete — Elimina permanentemente el webhook y su historial de entregas.
Probar tu endpoint
Haz clic en Send Test Ping en cualquier webhook para enviar un evento test.ping a tu endpoint. Úsalo para verificar la conectividad y la validación de firmas antes de suscribirte a eventos reales.
La pestaña Deliveries muestra los encabezados de solicitud, el código de estado de la respuesta y el tiempo de cada intento de entrega.
En resumen