Logo StartupKit
ES
English Deutsch Français Español Polski
Career Portal

Integrar tu portal de empleo

Cómo integrar tu portal de empleo en el sitio web de tu empresa usando un iframe, incluyendo opciones de personalización y acceso a la API.

Por qué es importante

La mayoría de las empresas quieren mostrar las ofertas de empleo en su propio sitio web en lugar de enviar a los candidatos a una URL separada. El modo de integración de Kit te permite añadir tu portal de empleo a cualquier página como un iframe, manteniendo a los candidatos en tu sitio mientras Kit se encarga del flujo de postulaciones.

Integración con un iframe

Añade tu portal de empleo a cualquier página web usando un iframe. El código de integración básico es:

<iframe
  src="https://startupkit.app/careers/your-subdomain?embed=true"
  width="100%"
  height="800"
  frameborder="0"
  style="border: none;"
></iframe>

El parámetro ?embed=true activa el modo de integración, que:

  • Elimina el encabezado y la navegación del portal
  • Usa un diseño compacto optimizado para iframes
  • Envía actualizaciones de altura a la ventana principal mediante postMessage (para el redimensionamiento automático)
  • Elimina los encabezados X-Frame-Options para que el iframe se cargue correctamente

Parámetros de personalización

Añade parámetros de consulta a la URL de integración para personalizar la apariencia:

Parámetro Valores Descripción
embed true Activa el modo de integración (obligatorio)
theme light, dark Anula el tema predeterminado del portal
bg Color hexadecimal (ej. %23ffffff) Establece un color de fondo personalizado para que coincida con tu sitio

Ejemplo con tema oscuro y fondo personalizado:

<iframe
  src="https://startupkit.app/careers/your-subdomain?embed=true&theme=dark&bg=%231a1a2e"
  width="100%"
  height="800"
  frameborder="0"
></iframe>

Nota: Usa %23 en lugar de # para los colores hexadecimales en las URLs.

Redimensionamiento automático

Kit envía la altura del contenido del portal a la ventana principal mediante postMessage. Añade este script a tu página para redimensionar el iframe automáticamente:

<script>
  window.addEventListener("message", function(event) {
    if (event.data && event.data.type === "resize") {
      var iframe = document.querySelector("iframe");
      iframe.style.height = event.data.height + "px";
    }
  });
</script>

Esto evita las barras de desplazamiento dentro del iframe y ofrece a los candidatos una experiencia de navegación fluida.

API JSON

Kit también proporciona una API JSON para tu portal de empleo si quieres crear una página de ofertas completamente personalizada. Solicita la URL del portal de empleo con un encabezado Accept: application/json o añade .json:

GET https://startupkit.app/careers/your-subdomain.json

La respuesta incluye todas las ofertas de empleo publicadas con sus metadatos (título, ubicación, departamento, salario, etc.). La respuesta JSON se almacena en caché durante 5 minutos.

Usa esto cuando necesites control total sobre el diseño y quieras renderizar las ofertas de empleo con tu propio código frontend. Cada empleo en la respuesta incluye un campo url que enlaza a la página pública de detalle del empleo donde los candidatos pueden postularse.

Formato legible por LLM (llms.txt)

Kit sirve un archivo llms.txt para tu portal de empleo — un documento markdown único que los asistentes de inteligencia artificial y los LLMs pueden consumir para comprender todas tus posiciones abiertas de una sola vez:

https://startupkit.app/careers/your-subdomain/llms.txt

El archivo incluye cada oferta de empleo publicada con su descripción completa, ubicación, tipo de empleo, rango salarial, URL de postulación y etapas del proceso de contratación. Cuando no hay posiciones abiertas, redirige a tu bolsa de talento.

Esto sigue la especificación llms.txt y se enlaza automáticamente en el <head> HTML del portal de empleo para su descubrimiento. No requiere configuración: siempre está disponible y se mantiene sincronizado con tus ofertas publicadas.

SEO y sitemap

Kit genera un sitemap para tu portal de empleo en:

https://startupkit.app/careers/your-subdomain/sitemap.xml

El sitemap incluye todas las ofertas de empleo publicadas con sus marcas de tiempo de última actualización. Envíalo a los motores de búsqueda para mejorar la visibilidad de tus ofertas de empleo. Kit también genera datos estructurados (JSON-LD en el esquema JobPosting) en cada página de detalle de empleo para resultados de búsqueda enriquecidos.

Lista de verificación rápida

  • Añade el código de integración del iframe al sitio web de tu empresa
  • Establece embed=true para activar el modo compacto
  • Haz coincidir el tema y el color de fondo con el diseño de tu sitio
  • Añade el script de redimensionamiento automático para un ajuste de altura fluido
  • Prueba la integración tanto en escritorio como en dispositivos móviles
  • Envía el sitemap de tu portal de empleo a Google Search Console
  • Considera el uso de la API JSON si necesitas un diseño completamente personalizado

Escriba para buscar...