Cómo conectar Pinpoint a Job Today

Job Today lee tus ofertas a través de la API de Pinpoint. Todas las ofertas con el estado Activas y la visibilidad Externa se publican en Job Today. Las ofertas en borrador, cerradas o solo internas no se publican.

Se ejecuta una sincronización unos minutos después de cada notificación de webhook (oferta creada, actualizada o eliminada) y, como medida de seguridad, una vez cada noche (hacia las 01:30 UTC). Sin webhook, las ofertas y los cambios llegan igualmente con la sincronización nocturna.

De Pinpoint se toman los siguientes datos: el título, la descripción (que combina las secciones Descripción, Responsabilidades Clave, Habilidades, Conocimiento y Ventajas Laborales), la ubicación, el tipo de contrato, el salario (solo si está configurado como visible en la oferta) y las preguntas de inscripción de la oferta. La categoría de la oferta en Job Today se asigna automáticamente a partir del título. Las imágenes y los vídeos no se transfieren.

Para publicarse, una oferta necesita título, descripción y una ubicación con ciudad y país: los campos Ciudad y País del registro de ubicación de la oferta deben estar rellenados, no basta con el nombre de la ubicación. Si la oferta tiene una ubicación para feeds de empleo (los campos Ciudad / Pueblo y País de la sección Portales de empleo; Comunidad / Estado es opcional), Job Today la usa en lugar del registro de ubicación, igual que otros feeds de empleo. Job Today es un portal de empleo basado en la ubicación, así que las ofertas en remoto también necesitan una ubicación. Las ofertas cuya fecha límite de inscripción ya ha pasado no se publican.

Cada oferta se publica con el usuario de Job Today cuyo correo electrónico coincide con el del responsable de selección de la oferta en Pinpoint. Si no hay coincidencia, la oferta se publica con la cuenta principal de tu empresa o con un usuario predeterminado que acuerdes con tu responsable de Experiencia del Cliente.

Pinpoint es la fuente de referencia. Los cambios que hagas en una oferta en Pinpoint llegan a Job Today con la siguiente sincronización, y los cambios hechos directamente en la oferta importada en Job Today se sobrescriben. Edita siempre tus ofertas en Pinpoint.

Si cierras o eliminas una oferta en Pinpoint, o cambias su visibilidad a interna, la oferta se cierra en Job Today. Si vuelves a ponerla como abierta y externa, se reabre la misma oferta en Job Today, junto con las candidaturas que ya había recibido.

Las preguntas personalizadas del formulario de inscripción de la oferta se importan como preguntas de filtrado. Los candidatos las responden al inscribirse en Job Today. Se admiten estos tipos de pregunta: texto corto, texto largo, número, URL, fecha, sí/no y opción múltiple (incluidas las preguntas limitadas a una sola respuesta).

Las preguntas que requieren subir documentos o indicar un rango de fechas no están disponibles en Job Today, así que se omiten. Si una de estas preguntas es obligatoria en Pinpoint, la oferta se publica igualmente y las candidaturas llegan sin respuesta a esa pregunta. Si prefieres que estas ofertas se omitan, tu responsable de Experiencia del Cliente puede configurar la integración para ello.

Las preguntas condicionales (de seguimiento) se importan como preguntas opcionales. Se colocan justo después de su pregunta principal, con la condición añadida al título, por ejemplo: Si "Sí": Explícalo, por favor. La respuesta solo se envía a Pinpoint cuando se cumple la condición. Las preguntas de seguimiento anidadas dentro de otras preguntas de seguimiento no se importan.

Los candidatos se inscriben en tus ofertas en Job Today. Cada candidatura se envía automáticamente a Pinpoint en cuanto el candidato responde a las preguntas de filtrado (o de inmediato si la oferta no tiene ninguna). La candidatura aparece entre las de la oferta en Pinpoint, con Job Today como fuente.

Cada candidatura incluye el nombre y los apellidos del candidato, su correo electrónico, su número de teléfono, su resumen personal, su localidad y su país (y el código postal en algunos países), un CV en PDF generado a partir de su perfil de Job Today y sus respuestas a las preguntas de filtrado. Job Today nunca comparte la dirección postal del candidato.

Si el candidato modifica una respuesta más adelante, la candidatura existente en Pinpoint se actualiza y no se crea ningún duplicado.

Las candidaturas viajan en un solo sentido. La revisión de candidatos, el cambio de fase, el rechazo y la contratación se gestionan en Pinpoint y no se reflejan en Job Today. Los mensajes que intercambies con los candidatos en el chat de Job Today no se transfieren.

Abre el webhook en Configuración → API & Webhooks → Webhooks y comprueba que está activado y suscrito a Oferta creada, Oferta actualizada y Oferta eliminada.

Cuando un envío falla, Pinpoint lo reintenta hasta 10 veces durante 24 horas. Después, desactiva el webhook y te avisa por correo electrónico. Soluciona la causa y vuelve a activar el webhook.

Usa Enviar evento de prueba en la página del webhook. Una respuesta 2xx indica que Job Today ha aceptado el envío. Una respuesta 401 indica que la URL del webhook o el secreto de firma (signing secret) no coinciden con los que Job Today tiene registrados. Esto ocurre, por ejemplo, si el webhook se ha eliminado y se ha vuelto a crear, porque Pinpoint genera un nuevo secreto de firma. Envía el secreto de firma actual a tu responsable de Experiencia del Cliente.

Aunque el webhook no funcione, los cambios llegan con la sincronización nocturna. Si las actualizaciones aparecen siempre al día siguiente, lo más probable es que haya un problema con el webhook.

Revisa la clave de API: debe seguir existiendo y tener todos los permisos necesarios, y el interruptor Pinpoint API debe estar activado.

Busca la candidatura entre las de la oferta en Pinpoint; la fuente es Job Today.