Gérer son vivier
Le vivier permet au recruteur de constituer un pool de candidats réutilisable sur plusieurs offres.
Architecture
1. Créer un vivier
POST /v1/api/vivier HTTP/1.1
Authorization: Bearer <RECRUTEUR_TOKEN>
Content-Type: application/json
{
"nom": "Senior Java — pipeline 2026",
"description": "Profils backend Java pour futures ouvertures",
"tags": ["Java", "Senior", "Backend"],
"partageEntreprise": true
}
{ "id": 55, "nom": "Senior Java — pipeline 2026", "totalCandidats": 0 }
2. Ajouter un candidat inscrit
Via la recherche de profils publics.
POST /v1/api/vivier/55/candidats HTTP/1.1
Content-Type: application/json
{ "candidatId": 42, "note": "Contacté lors du JobDay Douala" }
3. Ajouter un candidat externe (manuel)
POST /v1/api/vivier/55/candidats/external HTTP/1.1
Content-Type: application/json
{
"firstName": "Alain",
"lastName": "Mvondo",
"email": "alain.mvondo@example.com",
"phone": "+237690111222",
"competences": ["Java", "Spring Boot"],
"source": "LINKEDIN",
"note": "Rencontré à la conf Yaoundé"
}
4. Import CSV bulk
Format attendu :
firstName,lastName,email,phone,competences,source,note
Alain,Mvondo,alain@ex.com,+237690111222,"Java,Spring",LINKEDIN,Conf Yaoundé
Célestine,Kamga,c.kamga@ex.com,,"React,TS",RECOMMANDATION,Recommandée par Paul
POST /v1/api/vivier/55/candidats/import-csv HTTP/1.1
Content-Type: multipart/form-data
file=@pipeline.csv
5. Inviter un externe à s’inscrire
6. Suivre le statut
PATCH /v1/api/vivier/candidats/702 HTTP/1.1
{ "statut": "CONTACTE", "note": "Premier appel fait, revient vers nous" }
7. Lister les candidats d’un vivier
GET /v1/api/vivier/55?statut=CONTACTE&page=0&size=20 HTTP/1.1
8. Partager avec l’équipe
Le champ partageEntreprise: true rend le vivier visible à tous les MEMBER de l’entreprise. Le créateur reste le propriétaire administratif.
9. Associer à une offre
Un candidat du vivier peut être invité à postuler à une offre :
POST /v1/api/vivier/candidats/701/invite-to-offre HTTP/1.1
{ "offreId": 123 }
Quotas par plan
| Plan | Viviers max | Candidats par vivier | Imports CSV / mois |
|---|
| Gratuit | 1 | 50 | 0 |
| Essentiel | 5 | 500 | 5 |
| Pro | 20 | 5000 | 50 |
| Entreprise | ∞ | ∞ | ∞ |
Cas d’usage
Les candidats externes n’ont pas accès aux fonctionnalités candidat tant qu’ils ne se sont pas inscrits. Leurs données restent isolées dans external_candidats.
