Webhooks

Los webhooks envían un pequeño mensaje a una URL que tú controlas en cuanto ocurre algo en PeekHire — para reaccionar en tiempo real en vez de consultar la API.

Cómo funcionan

1. Creas un endpoint (una URL en tu servidor o una herramienta de automatización) en Herramientas para desarrolladores → Webhooks.
2. Eliges qué eventos debe recibir.
3. Cuando ocurre un evento, PeekHire envía un POST HTTP con carga JSON a tu endpoint.

Las cargas son intencionadamente pequeñas — indican qué pasó y a qué objeto afecta. Obtén los detalles con la API REST.

Eventos disponibles

Los eventos cubren el ciclo de reclutamiento, incluidos:

• Candidaturas — application.submitted, application.updated, application.stage_changed, application.rated, application.archived, application.restored, application.deleted.
• Comentarios — application.comment.created, application.comment.updated, application.comment.deleted.
• Campañas — campaign.created, campaign.activated, campaign.paused, campaign.archived, campaign.restored.

Verificar las entregas

Cada entrega va firmada para confirmar que viene de PeekHire. Verifica la firma antes de confiar en la carga y responde con 2xx para confirmar la recepción.

Inspeccionar entregas

La vista Entregas muestra los intentos recientes y sus resultados — para confirmar que llegan los eventos y depurar un endpoint que no responde.

Consejos

• Responde rápido con 2xx y haz el trabajo pesado de forma asíncrona.
• Haz tu handler idempotente — el mismo evento puede llegar más de una vez.
• Empieza con Make, Zapier o n8n si prefieres no gestionar un servidor.