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

Intégrer votre portail carrière

Comment intégrer votre portail carrière sur le site web de votre entreprise à l'aide d'un iframe, y compris les options de personnalisation et l'accès à l'API.

Pourquoi c’est important

La plupart des entreprises souhaitent afficher les offres d’emploi sur leur propre site web plutôt que de rediriger les candidats vers une URL distincte. Le mode d’intégration de Kit vous permet d’ajouter votre portail carrière à n’importe quelle page sous forme d’iframe, ce qui maintient les candidats sur votre site pendant que Kit gère le processus de candidature.

Intégration avec un iframe

Ajoutez votre portail carrière à n’importe quelle page web à l’aide d’un iframe. Le code d’intégration de base est :

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

Le paramètre ?embed=true active le mode d’intégration, qui :

  • Supprime l’en-tête et la navigation du portail
  • Utilise une mise en page compacte optimisée pour les iframes
  • Envoie les mises à jour de hauteur à la fenêtre parente via postMessage (pour le redimensionnement automatique)
  • Supprime les en-têtes X-Frame-Options afin que l’iframe se charge correctement

Paramètres de personnalisation

Ajoutez des paramètres de requête à l’URL d’intégration pour personnaliser l’apparence :

Paramètre Valeurs Description
embed true Active le mode d’intégration (obligatoire)
theme light, dark Remplace le thème par défaut du portail
bg Couleur hexadécimale (par ex. %23ffffff) Définit une couleur d’arrière-plan personnalisée pour correspondre à votre site

Exemple avec un thème sombre et une couleur d’arrière-plan personnalisée :

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

Remarque : Utilisez %23 au lieu de # pour les couleurs hexadécimales dans les URL.

Redimensionnement automatique

Kit envoie la hauteur du contenu du portail à la fenêtre parente via postMessage. Ajoutez ce script à votre page pour redimensionner automatiquement l’iframe :

<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>

Cela évite les barres de défilement à l’intérieur de l’iframe et offre aux candidats une expérience de navigation fluide.

API JSON

Kit fournit également une API JSON pour votre portail carrière si vous souhaitez créer une page d’offres d’emploi entièrement personnalisée. Effectuez une requête vers l’URL du portail carrière avec un en-tête Accept: application/json ou ajoutez .json :

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

La réponse inclut toutes les offres d’emploi publiées avec leurs métadonnées (titre, localisation, département, salaire, etc.). La réponse JSON est mise en cache pendant 5 minutes.

Utilisez cette méthode lorsque vous avez besoin d’un contrôle total sur le design et que vous souhaitez afficher les offres d’emploi avec votre propre code frontend. Chaque offre dans la réponse inclut un champ url qui renvoie vers la page publique de détail de l’offre où les candidats peuvent postuler.

Format lisible par les LLM (llms.txt)

Kit fournit un fichier llms.txt pour votre portail carrière – un document Markdown unique que les assistants IA et les LLM peuvent consulter pour comprendre l’ensemble de vos postes ouverts en une seule fois :

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

Le fichier inclut chaque offre d’emploi publiée avec sa description complète, sa localisation, son type de contrat, sa fourchette salariale, son URL de candidature et les étapes du processus de recrutement. Lorsqu’aucun poste n’est ouvert, il redirige vers votre vivier de talents.

Ce format suit la spécification llms.txt et est automatiquement lié dans le <head> HTML du portail carrière pour faciliter sa découverte. Aucune configuration n’est nécessaire : il est toujours disponible et reste synchronisé avec vos offres publiées.

SEO et sitemap

Kit génère un sitemap pour votre portail carrière à l’adresse :

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

Le sitemap inclut toutes les offres d’emploi publiées avec leurs dates de dernière mise à jour. Soumettez-le aux moteurs de recherche pour améliorer la visibilité de vos offres d’emploi. Kit génère également des données structurées (JSON-LD au format JobPosting) sur chaque page de détail d’offre pour des résultats de recherche enrichis.

Liste de vérification rapide

  • Ajoutez le code d’intégration iframe sur le site web de votre entreprise
  • Définissez embed=true pour activer le mode compact
  • Adaptez le thème et la couleur d’arrière-plan au design de votre site
  • Ajoutez le script de redimensionnement automatique pour un ajustement fluide de la hauteur
  • Testez l’intégration sur ordinateur et sur mobile
  • Soumettez le sitemap de votre portail carrière à Google Search Console
  • Envisagez d’utiliser l’API JSON si vous avez besoin d’un design entièrement personnalisé

Tapez pour rechercher...