🧩 Qué resuelve
Los webhooks permiten conectar Viterbit con otros sistemas externos para automatizar procesos e intercambiar información en tiempo real.
Cada vez que ocurre un evento configurado, Viterbit enviará automáticamente una petición a tu endpoint con los datos correspondientes.
⚙️ Cómo acceder a los Webhooks
Para configurar un webhook navega a:
Ajustes → Integraciones → Webhooks
📸 Imagen sugerida: Vista de la sección Webhooks en Ajustes.
➕ Cómo crear un nuevo Webhook
Haz clic en Nuevo Webhook.
Completa la configuración del webhook.
Deberás indicar:
La URL del endpoint.
El evento asociado al webhook.
Guarda la configuración.
A partir de ese momento, Viterbit realizará automáticamente peticiones hacia tu endpoint cuando ocurra el evento configurado.
📨 Cómo funciona la petición
Cuando se dispare el evento asociado, Viterbit enviará una petición tipo:
POST {url-configurada-en-el-webhook}Incluyendo información relacionada con:
Candidato.
Oferta.
Cuestionarios.
Campos personalizados.
Estado de candidatura.
Respuestas enviadas.
🧾 Información enviada
El payload puede incluir datos como:
Nombre y email del candidato.
Dirección y localización.
Respuestas de cuestionarios.
Campos personalizados.
Estado de la candidatura.
Información de la oferta.
⚠️ Importante: Los campos con visibilidad limitada no serán enviados en la petición del webhook.
🆕 Logs y trazabilidad de Webhooks
Ahora Viterbit incluye una nueva vista de logs para facilitar el seguimiento y diagnóstico de los webhooks configurados.
Esto permite visualizar de forma mucho más clara:
Las peticiones realizadas.
Los datos enviados.
Las respuestas recibidas.
El estado de cada ejecución.
🔍 Qué puedes consultar en los logs
Desde la nueva sección de logs podrás revisar:
Endpoint al que se realizó la llamada.
Fecha y hora de ejecución.
Payload enviado.
Código de respuesta recibido.
Resultado correcto o fallido.
Esto facilita enormemente el diagnóstico de integraciones.
✅ Tip útil: Utiliza los logs para validar rápidamente si un endpoint está respondiendo correctamente o si existe algún error en la integración.
🔄 Reintento manual de Webhooks
Ahora también es posible reintentar manualmente la ejecución de un webhook específico.
Esto permite:
Volver a lanzar llamadas fallidas.
Validar cambios en el endpoint.
Probar integraciones sin necesidad de repetir acciones dentro de Viterbit.
⚡ Reintentos automáticos
Viterbit ya cuenta con un sistema automático de reintentos cuando un endpoint devuelve una respuesta incorrecta.
El sistema utiliza:
Reintentos automáticos.
Backoff exponencial.
Con la nueva funcionalidad, ahora también tendrás control manual sobre cada ejecución.
⚠️ Importante: Si tu endpoint devuelve errores o tiempos de respuesta elevados, Viterbit seguirá intentando automáticamente la entrega del webhook.
🚀 Beneficios de las nuevas funcionalidades
Más visibilidad sobre las integraciones.
Mejor capacidad de diagnóstico.
Gestión más ágil de errores.
Mayor control sobre los eventos enviados.
Posibilidad de validar integraciones fácilmente.
🧠 Casos de uso habituales
Los webhooks son especialmente útiles para:
Integraciones con ERPs.
Automatizaciones externas.
Sincronización con CRMs.
Sistemas de reporting.
Herramientas de comunicación.
Procesos internos automatizados.
💪 Ventajas principales
Información en tiempo real.
Automatización de procesos.
Integraciones más flexibles.
Mayor trazabilidad.
Menos intervención manual.
Mejor control sobre eventos y respuestas.