Cas d'usage agence
Ce guide raconte, étape par étape, comment une agence web peut livrer et faire vivre un site complet pour son client avec Le Labo du Yeti. De la prise de brief jusqu'au désengagement, en passant par la création de contenu SEO local et le suivi opérationnel.
Vue d'ensemble du parcours
Le Labo du Yeti suit un modèle d'hébergement appelé SaaS hybride : chaque client dispose de sa propre instance dédiée (son domaine, sa base de données, ses contenus). Cela protège ses données et permet à votre agence de gérer plusieurs sites sans les mélanger. Le parcours type se déroule en quinze étapes :
- Prise de brief avec le prospect.
- Création d'une nouvelle instance CMS sur Plesk.
- Bootstrap du compte Administrateur de l'agence.
- Mise en place du branding et du layout HTML.
- Création des pages principales du site.
- Construction du cocon SEO local (services × villes).
- Configuration éditoriale du blog.
- Activation des sources d'images et du moteur de recherche.
- Paramétrage des formulaires de contact.
- Configuration du serveur d'envoi d'emails (SMTP).
- Build et mise en ligne du site.
- Création d'un compte Client à droits limités.
- Mise en place du suivi et du reporting.
- Maintenance courante.
- Désengagement et transfert du site.
Étape 1 — Recueillir le brief client
Avant toute chose, posez les bonnes questions au prospect. Notez précisément :
- L'industrie ou le secteur (artisanat, services à la personne, e-commerce, B2B…).
- La liste exacte des services à mettre en avant.
- Les villes cibles si la stratégie inclut du référencement local.
- L'identité visuelle (charte graphique, polices, logo, couleurs).
- Les adresses email qui doivent recevoir les formulaires de contact.
- Le ton éditorial souhaité pour le blog (expert, accessible, technique, etc.).
Ces informations conditionnent toutes les étapes suivantes : un cocon SEO de 100 pages ne se construit pas sans une liste validée de services et de villes.
Étape 2 — Créer l'instance CMS dans Plesk
Chaque client reçoit sa propre instance Node. La procédure est expliquée en détail dans la documentation technique Plesk, mais voici la version courte :
- Connectez-vous au panneau Plesk de votre hébergement.
- Créez un nouveau domaine (ou sous-domaine) pour le client.
- Clonez le dépôt Git du CMS dans le dossier de ce domaine.
- Lancez
npm installpour installer les dépendances. - Configurez les variables d'environnement Plesk (clé JWT, SMTP, etc.).
- Redémarrez l'application Node depuis le panneau Plesk.
JWT_SECRET entre deux clients. Chaque instance doit avoir ses propres variables d'environnement, gérées dans Plesk et non dans un fichier .env commité.
Étape 3 — Bootstrap du compte Administrateur
Au tout premier accès à l'interface d'administration (l'URL ressemble à https://domaine-client.fr/admin), le CMS détecte qu'aucun compte n'existe et propose un écran de création. C'est l'agence qui crée ce premier compte, avec le rôle owner (Administrateur).
Choisissez une adresse email agence (pas celle du client) et un mot de passe long. Ce compte est le seul à pouvoir, plus tard, déléguer les rôles. Voir Premiers pas pour le détail.
Étape 4 — Mettre en place le branding et le layout
Le layout HTML est le squelette commun à toutes les pages : il contient le header, le footer, les polices, les couleurs. C'est lui qui porte la charte graphique du client.
- Dans le menu latéral, cliquez sur Configuration → Layout global.
- Uploadez le fichier HTML produit par votre équipe design.
- Activez ce layout pour qu'il s'applique à toutes les pages.
- Allez ensuite dans Configuration → Header / Footer et remplissez les champs dynamiques (logo, menu, mentions légales).
- Terminez par Réglages → Branding : photo, slogan, favicon (le CMS recadre automatiquement en WebP 512×512).
Consultez la page Gestion du Layout pour les bonnes pratiques de structure HTML.
Étape 5 — Créer les pages principales
Le minimum vital pour un site vitrine se compose de quatre pages : Accueil, À propos, Services, Contact. Toutes se créent depuis le menu Contenu → Pages.
Pour chaque page, cliquez sur le bouton orange « Ajouter une page » en haut à droite, choisissez un template depuis la bibliothèque ou uploadez votre propre HTML, puis ouvrez le builder visuel pour ajuster textes, couleurs et boutons sans toucher au code.
Étape 6 — Construire le cocon SEO local
C'est ici que le CMS révèle toute sa puissance. Si le client cible 5 services dans 20 villes, vous pouvez générer 100 pages optimisées en quelques minutes grâce à un content group.
- Allez dans Contenu → Cocon SEO puis Nouveau groupe.
- Définissez la variable parente :
serviceavec la liste des 5 services. - Définissez la variable enfant :
villeavec la liste des 20 villes. - Uploadez un template HTML qui contient les balises
{{service}}et{{ville}}. - Lancez la génération IA. Le CMS produit toutes les combinaisons en parallèle.
Un quota anti-spam limite par défaut à 5 pages tous les 7 jours par groupe (modifiable). Les pages parents sont générées et publiées avant les enfants, pour préserver la cohérence du maillage interne.
Étape 7 — Configurer le blog éditorial
Le blog accueille les contenus de fond : guides, actualités, études de cas. Pour le mettre en route :
- Ouvrez Réglages → IA et renseignez la clé Anthropic (Claude). Cette clé reste confidentielle, elle n'est jamais exposée aux extensions.
- Créez 3 à 5 catégories cohérentes avec le métier du client.
- Rédigez ou faites générer 3 à 5 articles fondateurs pour structurer l'arborescence.
- Si vous avez un calendrier rédactionnel, planifiez les publications futures via la date de publication programmée.
Voir le guide Blog pour le workflow détaillé.
Étape 8 — Activer le moteur de recherche web
Le CMS intègre une recherche web (SerpAPI, Brave ou Tavily) qui sert à deux choses : enrichir les articles avec des sources fraîches et proposer des suggestions de titres lors de la rédaction. Allez dans Réglages → API, choisissez votre fournisseur et collez la clé d'API. Faites un test depuis le panneau pour valider la connexion.
Étape 9 — Paramétrer les formulaires
Tous les formulaires de contact sont détectés automatiquement dès qu'ils contiennent l'attribut data-cms-form. Une fois détectés, vous pouvez :
- Définir l'adresse email qui recevra les soumissions (généralement l'email du client).
- Ajouter en copie cachée une adresse agence pour le suivi qualité.
- Tester l'envoi depuis le panneau avant de communiquer le formulaire au client.
Voir Formulaires pour les options avancées (webhook, protection anti-spam, etc.).
Étape 10 — Configurer le SMTP
Le serveur SMTP sert à deux fonctions critiques : envoyer les codes de double authentification par email et acheminer les soumissions de formulaires. Sans SMTP correctement configuré, ces fonctions ne marchent pas.
Dans Réglages → Général → SMTP, saisissez l'hôte, le port, l'identifiant et le mot de passe fournis par le service mail du client (Postmark, Brevo, OVH, etc.). Envoyez ensuite un email de test depuis l'interface.
Étape 11 — Build et mise en ligne
Quand tout est prêt, lancez le build depuis Configuration → Build du site. Le CMS compile l'ensemble des pages, articles et pages cocon en HTML statique dans le dossier public/, puis génère le sitemap XML et le fichier robots.txt. Le client peut désormais consulter son site public à l'adresse de son domaine.
Voir Publication pour la séquence détaillée et les vérifications post-build.
Étape 12 — Créer un compte Client à droits limités
Une fois le site livré, le client veut souvent pouvoir modifier ses pages ou écrire des articles, mais pas toucher à la stratégie SEO ni aux clés d'API. Le rôle editor (intitulé « Client » dans l'interface) est conçu pour cela.
Voici la matrice des accès :
| Fonction | Agence (owner) | Client (editor) |
|---|---|---|
| Pages, Blog, Médias, Formulaires | Oui | Oui |
| Cocon SEO | Oui | Non |
| Réglages IA, API, Tokens | Oui | Non |
| Branding sidebar, SMTP | Oui | Non |
| Header / Footer / Layout | Oui | Non |
| Logs et audit | Oui | Non |
Créez ce compte depuis Réglages → Comptes, rôle Client, et transmettez les identifiants par un canal sécurisé (gestionnaire de mots de passe partagé, jamais par email simple).
Étape 13 — Mettre en place le suivi
Trois outils permettent à l'agence de garder un œil sur le site sans connecter manuellement :
- API Tokens : créez un jeton dédié au reporting depuis Réglages → Tokens API. Il permettra à une future plateforme d'agence d'appeler
/api/statspour agréger les métriques de tous vos clients. - Logs : tout événement important (connexion, modification de config, suppression) est tracé dans Outils → Logs. C'est précieux pour l'audit ou pour répondre à un client qui demande « qui a modifié cette page ? ».
- Dashboard IA : Réglages → IA contient un onglet « Consommation » qui affiche les tokens consommés, le coût estimé et le détail par type d'opération. Indispensable pour facturer au juste prix.
Étape 14 — Maintenance courante
Une instance bien tenue demande peu d'effort, mais quelques gestes réguliers évitent les mauvaises surprises :
- Sauvegardes : exportez régulièrement un ZIP complet depuis Réglages → Sécurité → Backup. Stockez ces archives hors de l'hébergeur.
- Mises à jour CMS : quand une nouvelle version est taguée, faites
git pullsur l'instance puis redémarrez Node depuis Plesk. Aucun risque pour les données : tout ce qui appartient au client (base, médias, brouillons) est exclu du dépôt Git. - Audit sécurité : tous les trimestres, vérifiez la liste des comptes, révoquez les tokens API inutilisés, et passez la matrice des permissions en revue.
Étape 15 — Désengagement du client
Si la collaboration se termine et que le client souhaite reprendre son site en main (ou le confier à une autre agence), le processus est simple et propre :
- Faites un backup complet (ZIP) depuis Réglages → Sécurité.
- Transférez ce ZIP au client via un canal sécurisé.
- Donnez les instructions Plesk : nouveau domaine, clone du dépôt, restauration du ZIP.
- Une fois le site basculé, supprimez l'instance hébergée chez vous.
Le client repart avec l'intégralité de ses contenus, médias, utilisateurs et configurations. Aucune donnée n'est captive de l'agence : c'est une garantie commerciale forte à mettre en avant dès le devis.
En résumé
Le Labo du Yeti permet à une agence de fonctionner avec un modèle simple : un site = une instance = un domaine. La même équipe peut gérer 5 ou 50 clients sans confusion entre les données. Les rôles permettent de déléguer juste ce qu'il faut au client tout en gardant la main sur la stratégie. Et le format ouvert garantit que personne ne se retrouve prisonnier d'un outil propriétaire.