Skip to Content
DémarrerCréer un espace headless

Créer un espace headless

Vous allez créer un espace headless — un site Structura qui vit entièrement dans le portail client, sans installation WordPress — et voir où vos articles apparaissent une fois les campagnes exécutées. Cette page s’adresse aux sites créés avec Lovable, Bolt, v0 ou Replit, avec Next.js, Astro, Nuxt ou SvelteKit, aux autres frameworks et apps, et à votre propre backend. Un site WordPress commence de la même façon, et l’extension arrive en dernier ; voir Installer l’extension.

Un espace headless fonctionne comme tout autre site Structura : vous configurez votre marque, exécutez des campagnes et révisez les articles. La différence réside dans l’endroit où les articles aboutissent. Au lieu de publier dans WordPress, Structura les stocke dans le cloud. Soit votre site les récupère depuis l’API de contenu publique, et Structura devient votre backend de contenu, soit, si vous avez construit votre site avec un créateur IA ou si vous avez votre propre backend, Structura lui envoie chaque article dès que vous le publiez ; voir plus bas.

Avant de commencer

Vous aurez besoin de :

  • Un compte Structura — connectez-vous sur app.structurawp.com .
  • L’adresse de votre site web public (ex. https://example.com) — le site où vos lecteurs verront réellement les articles.

Vous n’avez pas besoin d’un développeur pour créer l’espace ou générer du contenu. Vous (ou votre développeur) n’avez besoin de modifications de code qu’à la toute fin, pour afficher les articles sur votre site — voir Ce qui se passe ensuite.

Étapes

Vous commencez par l’adresse de votre site. Structura lit le site en ligne, remplit ce qu’il peut et ne crée rien sur une plateforme où il ne peut pas encore publier.

  1. Dans le portail client, sélectionnez Connecter un site sur la page d’accueil de votre workspace ou sur la page Sites. L’assistant de configuration du site s’ouvre à sa première étape, Adresse, et demande Où se trouve votre site ?

  2. Saisissez l’URL publique du site — là où se trouvent réellement vos lecteurs — et sélectionnez Continuer. Structura l’utilise pour ancrer les suggestions SEO et s’assurer que les liens dans les articles diffusés pointent vers votre vrai domaine.

  3. Structura lit votre site, puis :

    • Nous ne pouvons pas encore publier sur Webflow. (ou Shopify, Wix, Squarespace ou Framer) : rien n’est créé. Sélectionnez Me prévenir et nous vous écrivons dès que c’est prêt, ou Essayer une autre adresse.
    • Ce site utilise déjà Structura. : c’est un site WordPress avec l’extension Structura. Collez la clé de licence affichée dans wp-admin, sous Structura → Compte et Licence. Dès que l’extension se connecte, l’assistant s’ouvre pour ce site ; voir Activer votre licence.
    • Nous n’avons pas pu joindre cette adresse. : vérifiez l’adresse et que le site est en ligne, puis sélectionnez Réessayer. Ou sélectionnez Ou continuez quand même et choisissez la plateforme vous-même.
    • Tout autre site : Structura le crée et ouvre Infos du site.
  4. Dans Infos du site, vérifiez le Nom du site, que Structura a rempli à partir de l’adresse, et choisissez votre Plateforme. Si Structura l’a reconnue, le champ n’affiche que cette plateforme avec Détectée sur votre site ; Changer de plateforme ouvre la liste complète si la détection s’est trompée. Sinon il indique Non détectée et affiche la liste tout de suite. Vous ne pouvez pas continuer sans plateforme, car elle détermine comment les articles arrivent sur votre site :

    • WordPress : notre plugin publie directement dans votre éditeur. Voir Installer l’extension.
    • Créateurs IA : Lovable, Bolt, v0 ou Replit. Vous collez un prompt dans votre outil, et chaque article arrive sur le blog de votre site. Structura reconnaît un site v0 au marqueur que v0 ajoute à ses pages ; sans ce marqueur, il propose Next.js : choisissez alors v0 vous-même.
    • Frameworks et apps : Next.js, Astro, Nuxt, SvelteKit ou Un autre framework ou une autre app. Votre site récupère les articles publiés depuis l’API de contenu.
    • Votre propre backend : Mon propre backend. Structura envoie chaque article à une route de votre serveur sous forme de requête signée : Rails, Django, Laravel, tout ce qui parle HTTPS.

    Avec le forfait gratuit, les créateurs IA et Mon propre backend portent la mention Forfaits payants, car l’envoi d’articles à votre site nécessite un forfait payant. WordPress et l’API de contenu fonctionnent avec tous les forfaits.

    Le même écran affiche aussi la Langue de votre site. Structura la lit sur votre page d’accueil ; si elle indique Détectée sur votre site, continuez simplement. Si elle indique À confirmer, choisissez la langue dans laquelle vous publiez et sélectionnez Confirmer la langue. Les nouvelles campagnes démarrent dans cette langue. Vous pouvez la modifier plus tard dans la carte Identité du site de la page Profil du site.

    La même carte contient le Modèle d’URL du blog, l’adresse à laquelle votre site affiche chaque article, par exemple /blog/%postname%. %postname% correspond au slug de l’article. L’URL canonique de chaque article et les liens entre vos articles en découlent. Les sites créés avec notre prompt sur Lovable, Bolt, v0 ou Replit utilisent /blog/%postname% ; si aucun modèle n’est encore enregistré pour le vôtre, la carte le propose : sélectionnez L’utiliser, puis Enregistrer les modifications. Une modification s’applique à partir de ce moment. Les liens des articles que vous avez déjà et les articles déjà envoyés à votre site gardent leurs anciennes adresses.

  5. Parcourez le reste de l’assistant : Moteur IA (uniquement sur les forfaits où vous apportez votre propre clé), SEO, Visuels et Persona. Configurer avec l’assistant décrit chaque étape. Vous pouvez ignorer des étapes et revenir plus tard ; l’espace existe déjà. Terminer la configuration à l’étape Persona enregistre tout et ouvre la dernière étape, Connexion.

  6. Connexion dépend de votre plateforme :

    • Next.js, Astro, Nuxt et SvelteKit : choisissez le flux du blog et copiez le prompt dans votre agent de développement. Il couvre l’index du blog, les articles et les archives de catégories et d’étiquettes avec pagination par curseur. Le prompt est aussi disponible sur la page API de livraison.
    • Un autre framework ou une autre app : Copiez le prompt d’intégration du blog. Il demande à votre agent d’identifier les technologies du projet et d’en suivre les conventions pour les articles, l’index du blog et les archives de catégories et d’étiquettes. L’index et les archives utilisent la pagination par curseur.
    • Créateurs IA et Mon propre backend : l’envoi des articles ; voir plus bas.
    • WordPress : installez l’extension et collez votre clé de licence ; voir Installer l’extension.

    Pas encore prêt ? Connecter plus tard est toujours disponible. Le prompt d’intégration reste sur la page API de livraison de votre site.

  7. Créez votre première campagne. Le processus est identique à celui de WordPress — voir Votre première campagne ; tout ce qui figure sur cette page s’applique, à l’exception des écrans spécifiques à WordPress.

Si Structura envoie les articles à votre site

Lorsque vous choisissez Lovable, Bolt, v0, Replit ou Mon propre backend, l’étape Connexion configure l’envoi des articles, qui transmet chaque article à votre site dès que vous le publiez : votre site n’a rien à récupérer. Vous collez le prompt pour votre outil (avec votre propre backend, vous ajoutez la route vous-même), collez l’URL du récepteur qu’il vous renvoie, enregistrez le secret de signature et faites un test. Comptez environ cinq minutes.

Pas encore prêt ? Sélectionnez Connecter plus tard. La page Canaux de votre site propose la même configuration à tout moment. Configurer avec l’assistant décrit l’étape, et Ajouter un blog à votre site créé avec l’IA contient les prompts et les solutions aux erreurs courantes du récepteur.

Ce qui se passe ensuite

  • Les articles générés apparaissent sous Articles de votre site dans le portail, en attente de révision. Publier un article le rend disponible sur l’API de diffusion — il n’apparaît pas sur votre site web de lui-même, sauf si vous avez connecté l’envoi des articles, qui le transmet à votre site.
  • La page API de livraison de votre site indique les adresses web exactes que votre site utilise pour récupérer les articles publiés, un flux par langue dans laquelle vous publiez. Envoyez cette page à votre développeur — les détails techniques se trouvent dans la Référence de l’API de diffusion headless.
  • Un site sur un framework affiche Pas encore récupéré dans votre liste Sites jusqu’à sa première récupération depuis l’API de contenu, puis Connecté.
  • Une fois que votre site récupère et affiche le flux, les nouveaux articles transitent automatiquement : exécutions de campagnes → vous révisez → publier → votre site le récupère.

Problèmes courants

  • « …est déjà connecté à ce workspace. » Chaque domaine peut être connecté une seule fois par espace de travail. Sélectionnez Ouvrir le site pour accéder au site existant. Si le domaine appartient à un ancien site que vous avez supprimé, supprimez-le entièrement d’abord (voir Supprimer un site).
  • Les créateurs IA et Mon propre backend affichent « Forfaits payants ». Avec le forfait gratuit, Structura ne peut pas envoyer d’articles à votre site. Sélectionnez Voir les forfaits sous le champ pour passer à un forfait payant, ou choisissez votre framework ou Un autre framework ou une autre app pour récupérer vos articles gratuitement depuis l’API de contenu.
  • Les articles sont publiés mais mon site web ne les affiche pas. L’API de diffusion ne fait que stocker et servir le contenu — votre site web doit le récupérer. Vérifiez avec votre développeur que l’intégration depuis la page API de livraison est en place, et que votre site se reconstruit ou se revalide lorsque le contenu change.
  • Mon blog est en plusieurs langues. Exécutez une campagne par langue. Chaque langue devient son propre flux sur la page API de livraison.

Pages connexes

Dernière vérification :