# Configurer votre portail carrières, domaine personnalisé et intégration web (Bêta)

Source: https://docs.coworkies.com/fr/spaces/career-portal/

> Connectez un sous-domaine personnalisé par CNAME DNS, intégrez votre tableau d’offres sur votre site web et personnalisez vos couleurs dans Space Admin.

Découvrez comment activer un portail carrières en marque blanche pour votre espace de coworking, connecter un sous-domaine personnalisé (comme `careers.votreespace.com`), intégrer vos offres en direct sur votre site web et appliquer vos couleurs de marque.

**Note:**
**Bêta (En test) :** Les domaines personnalisés, le widget d’intégration et les thèmes de couleurs du portail carrières sont actuellement en phase de test Bêta dans Space Admin. Toutes les offres actives rattachées à votre espace (celles de l’opérateur comme celles des entreprises membres) y apparaissent automatiquement.


## Prérequis

- **Accès Space Admin :** Vous devez être connecté avec un rôle **Admin/propriétaire** ou **Team Member/équipe** pour l’espace. Consultez [Ouvrir et utiliser Space Admin](https://docs.coworkies.com/fr/spaces/space-administration/).
- **Fiche d’espace confirmée :** Votre espace doit être validé et disposer d’une adresse publique (`/spaces/{space_slug}`).
- **Accès DNS (facultatif) :** Pour utiliser un sous-domaine personnalisé (`careers.votreespace.com`), vous devez pouvoir ajouter un enregistrement `CNAME` chez votre hébergeur DNS (Cloudflare, GoDaddy, Namecheap, OVH, Gandi ou Route 53).

## Ouvrir Career portal & brand colors (Beta)

1. Connectez-vous à Coworkies et ouvrez **Space Admin** pour votre espace (`/spaces/{space_id}/editspace`).
2. Sélectionnez **Jobs** dans le menu latéral gauche.
3. Dans la barre d’outils supérieure, cliquez sur **Career portal & brand colors `Beta`**.

La page est structurée en trois étapes dans l’ordre : **1. Custom domain**, **2. Share & website embed** et **3. Brand colors & theme**.

---

## 1. Connecter votre propre sous-domaine (Facultatif)

Vous pouvez héberger votre portail carrières sur votre propre sous-domaine avec certificat SSL Cloudflare automatique. Si vous passez cette étape, votre portail est déjà accessible sur `https://www.coworkies.com/careers/{space_slug}`.

### Étape 1 : Saisir votre sous-domaine personnalisé

Dans la carte **1. Custom domain**, saisissez le sous-domaine complet que vos candidats visiteront :

```text
careers.votreespace.com
```

Vous pouvez choisir n’importe quel préfixe de sous-domaine valide, tel que `careers.votreespace.com`, `jobs.votreespace.com` ou `talents.votreespace.com`.

### Étape 2 : Ajouter l’enregistrement DNS CNAME

Chez votre fournisseur DNS, créez un enregistrement `CNAME` pointant vers `careers-proxy.coworkies.com` :

| Type | Hôte / Nom | Cible / Valeur | TTL | Statut Proxy (Cloudflare) |
|---|---|---|---|---|
| `CNAME` | `careers` (ou `jobs`) | `careers-proxy.coworkies.com` | Auto / 300s | DNS uniquement ou Proxifié |

### Étape 3 : Enregistrer et vérifier le DNS

1. Revenez dans Space Admin et cliquez sur **Save & Verify DNS**.
2. Coworkies vérifie l’enregistrement `CNAME` et met à jour le badge de statut :
   - **`Active & SSL Ready`** : Votre `CNAME` pointe bien vers `careers-proxy.coworkies.com`. Le certificat SSL est émis automatiquement et l’URL principale de votre portail devient `https://careers.votreespace.com`.
   - **`Pending DNS CNAME`** : Votre sous-domaine est enregistré, mais la propagation DNS est en cours. Dès que l’enregistrement `CNAME` est publié, cliquez à nouveau sur **Save & Verify DNS** ou ouvrez directement `https://careers.votreespace.com` pour activer la résolution automatique.

### Vérifier le DNS depuis un terminal

Vous pouvez vérifier la propagation de votre enregistrement `CNAME` avec `dig` :

```bash
dig +short CNAME careers.votreespace.com
# Résultat attendu :
# careers-proxy.coworkies.com.
```

### Contraintes sur les domaines personnalisés

- **Un domaine par espace :** Chaque sous-domaine personnalisé ne peut être rattaché qu’à un seul espace.
- **Sous-domaine requis :** Le protocole DNS standard n’autorise pas d’enregistrement `CNAME` sur le domaine racine (`votreespace.com`). Utilisez toujours un sous-domaine tel que `careers.votreespace.com`.
- **Domaines réservés :** Les domaines `coworkies.com`, `coworkiesbook.com`, `workers.dev` et `localhost` ne sont pas autorisés.

---

## 2. Partager le lien direct ou intégrer sur votre site web

Dans la carte **2. Share & website embed**, choisissez comment diffuser vos offres.

### Option A : Lien direct vers le portail carrières

Ajoutez le lien direct de votre portail dans le menu de votre site web, votre pied de page, votre page LinkedIn ou votre newsletter :

```text
https://www.coworkies.com/careers/votre-espace
```

Lorsqu’un sous-domaine personnalisé est actif, ce champ affiche automatiquement `https://careers.votreespace.com`. Cliquez sur **Copy Portal URL** pour le copier ou sur **View career portal ↗** pour l’ouvrir.

### Option B : Extrait d’intégration web (Recommandé)

Intégrez vos offres en direct dans une page existante de votre site (WordPress, Webflow, Squarespace, Wix, Framer ou HTML personnalisé) :

```html
<div id="coworkies-jobs" data-space="votre-espace" data-accent="#38315f"></div>
<script src="https://www.coworkies.com/static/embed/jobs.js" async></script>
```

Fonctionnement du widget JavaScript :
- **Isolation Shadow DOM :** Le widget s’affiche dans un conteneur Shadow DOM isolé afin que le CSS de votre site n’altère jamais les cartes d’emploi.
- **SEO Google Jobs automatique :** Le script injecte automatiquement les données structurées `schema.org/JobPosting` (JSON-LD) dans la balise `<head>` de votre page pour l’indexation Google Jobs.
- **Regroupement des offres :** Lorsque votre espace publie à la fois ses propres postes et ceux d’entreprises membres, le portail les distingue automatiquement.

### Option C : Intégration Iframe (Solution de repli)

Si votre CMS bloque les balises `<script>`, utilisez le code `<iframe>` :

```html
<iframe src="https://www.coworkies.com/careers/votre-espace?embed=1&accent=%2338315f" width="100%" height="800" style="border:0;" loading="lazy"></iframe>
```

---

## 3. Personnaliser les couleurs de marque et les palettes

Dans la carte **3. Brand colors & theme**, adaptez le portail et le widget à votre charte graphique :

1. **Primary brand accent :** Choisissez une couleur ou saisissez un code hexadécimal (par exemple `#016e68`) pour les titres, les badges et le bouton **Continue to apply**.
2. **Portal page background :** Choisissez une couleur d’arrière-plan claire (par exemple `#f3f6f5`) pour votre portail hébergé.
3. **Palette presets :** Cliquez sur l’une des pastilles circulaires (**Coworkies Plum**, **Coworkies Green**, **Royal Blue**, **Warm Terracotta** ou **Minimalist Charcoal**) pour appliquer une palette prédéfinie et vérifier le rendu dans l’aperçu en direct.
4. Cliquez sur **Save Brand Colors** pour enregistrer.

---

## Flux JSON public (API)

Pour construire une page carrières sur mesure, vous pouvez interroger le flux JSON public en lecture seule sans clé API :

```bash
curl --fail-with-body --max-time 30 \
  'https://www.coworkies.com/api/v2/careers/votre-espace'
```

Pour résoudre un sous-domaine personnalisé vers l’identifiant de l’espace :

```bash
curl --fail-with-body --max-time 30 \
  'https://www.coworkies.com/api/v2/careers?host=careers.votreespace.com&resolve_only=1'
```

## Guides associés

- [Utiliser les offres publiques de votre espace](https://docs.coworkies.com/fr/spaces/space-job-board/)
- [Ouvrir et utiliser Space Admin](https://docs.coworkies.com/fr/spaces/space-administration/)
- [Lire, créer et retirer des offres par API](https://docs.coworkies.com/fr/api/jobs/)
- [Référence API de l’annuaire et des contenus](https://docs.coworkies.com/fr/api/reference/)