Descripción general de webhooks

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 seis categorías:

Eventos de candidatura

Evento	Se dispara cuando
application.submitted	Un candidato envía una candidatura
application.rejected	Una candidatura es rechazada
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
offer.candidate_accepted	Un candidato acepta una oferta
offer.candidate_declined	Un candidato rechaza una oferta
offer.revised	Una oferta es revisada con nuevas condiciones

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 evaluación

Evento	Se dispara cuando
review.submitted	Un miembro del equipo envía una evaluació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

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.

Lista de verificación rápida

• Navega a Integrations > Webhooks
• Añade la URL de tu endpoint HTTPS
• Selecciona los eventos que quieres recibir
• Copia tu secreto de firma
• Envía un ping de prueba para verificar la conectividad
• Implementa la verificación de firmas en tu endpoint
• Devuelve un código de estado 2xx para confirmar la recepción