Introducción a los webhooks

¿Qué son los webhooks?

Un webhook es un mensaje que se envía automáticamente entre aplicaciones cuando ocurre un evento específico. Es una forma ideal de conectar aplicaciones y automatizar flujos de trabajo. En Role.so, puedes enviar sin problemas los datos de los candidatos, tanto si han mostrado interés como si han rechazado la oportunidad, a cualquier plataforma compatible con webhooks, como Make, Zapier y otras.

Casos de uso y ejemplos

Puedes automatizar y adaptar tu flujo de trabajo a cada situación:

• enviar a una hoja de cálculo de Google la información de contacto que proporcionan los candidatos interesados
• enviar un mensaje de texto automático a un candidato que ha mostrado interés por un puesto
• enviar una notificación a Slack cuando un candidato muestra interés o rechaza un puesto
• guardar los datos de los candidatos en el sistema de seguimiento de candidatos que elijas

Eventos

Al crear un webhook, puedes elegir entre dos tipos de evento: Interested y Declined. Estos eventos corresponden directamente a los dos formularios presentes en cada pack candidato. Cuando se envía un formulario, enviaremos un mensaje a todos tus webhooks activos que correspondan al tipo de evento.

Datos

Según el tipo de evento (interested o declined), enviamos una estructura de datos fija. Puedes utilizar estos datos para crear automatizaciones en tus aplicaciones y ampliar tu flujo de trabajo.

Datos de interés

Si no se envía ninguna respuesta a preguntas personalizadas, la propiedad custom_answers se omite del payload en lugar de establecerse en null. Los demás campos escalares no utilizados o desactivados aparecerán como null, mientras que attachments siempre es una matriz y su valor es [] cuando no se suben archivos. Por ejemplo, si el formulario de interés de tu pack candidato solo tiene activados los campos name y email, enviaremos los siguientes datos:

Datos de rechazo

Los datos de rechazo tienen una estructura similar a los datos de interés:

Si has configurado motivos de rechazo personalizados en tu formulario, enviaremos estos datos en su lugar. Por ejemplo, si los motivos personalizados están configurados como Motivo n.º 1 y Motivo n.º 2, enviaremos los siguientes datos:

Preguntas frecuentes

P: ¿Está disponible esta función en el plan Starter?

R: El acceso depende de las funciones incluidas en tu plan actual. Si tu cuenta tiene habilitada la función de webhooks, puedes utilizarla; de lo contrario, el panel mostrará las opciones de mejora disponibles.

P: ¿Cuántos webhooks puedo crear?

R: Actualmente puedes crear un máximo de 4 webhooks.

P: ¿Los eventos y las notificaciones se envían en tiempo real?

R: En la mayoría de los casos, sí. Sin embargo, los datos pueden tardar entre 1 y 5 minutos en enviarse a tu aplicación.

P: ¿Puedo enviar eventos de prueba?

R: Sí, puedes enviar notificaciones de prueba para configurar fácilmente tu flujo sin afectar a las estadísticas de tus packs candidatos. Para obtener más información, consulta el artículo de ayuda Enviar un evento de prueba.

P: ¿Cómo se gestionan los errores?

R: Los errores reintentables, como los errores de red, los tiempos de espera, las respuestas HTTP 5xx y determinadas respuestas 4xx transitorias, reciben hasta 8 intentos de entrega en total: el intento inicial y hasta 7 reintentos. Los errores permanentes, como los payloads no válidos, los endpoints bloqueados por la política de seguridad y otras respuestas 4xx, se detienen después del primer intento. Un webhook puede marcarse como fallido tras un solo error de entrega y una entrega que haya fallado de forma permanente puede reintentarse manualmente. Para obtener más información, consulta el artículo de ayuda Supervisar los webhooks.

P: ¿Qué ocurre si un webhook falla durante un periodo prolongado? ¿Recibiré una notificación?

R: No directamente. Marcaremos el webhook como fallido y verás una etiqueta Con errores junto a él. Los fallos de entrega persistentes no desactivan automáticamente el webhook. Revisa el endpoint y desactiva el webhook manualmente desde la página de webhooks si es necesario. Para obtener más información, consulta el artículo de ayuda Supervisar los webhooks.