Ajouter un blog à votre site créé avec l’IA
Pour les sites avec leur propre interface, y compris ceux créés avec l’IA.
Gardez votre site et ajoutez un blog à son image. Structura recherche et rédige les articles ; votre site les affiche sur votre domaine. L’envoi des articles transmet un article complet lorsque vous le publiez.
Avant de commencer
Il vous faut un site publié, un backend acceptant les requêtes HTTPS et une base de données. Votre outil peut les créer, mais vous devez tester le résultat. Il s’agit d’une intégration personnalisée, pas d’un connecteur officiel Lovable, Bolt, v0 ou Replit.
L’envoi des articles est disponible pour les sites Headless dans le portail client. Les sites WordPress ne le proposent pas.
Les sites sur un framework ne l’utilisent pas non plus. Si vous choisissez Next.js, Astro, Nuxt, SvelteKit ou Un autre framework ou une autre app comme Plateforme de votre site, votre site récupère les articles publiés depuis la Content API, et l’assistant de configuration vous montre les requêtes.
L’envoi nécessite un forfait Structura de base payant, sans l’extension Channels. Pour un blog headless gratuit, utilisez la Content API publique. L’IA et l’hébergement peuvent entraîner des frais supplémentaires.
Étapes
Le chemin le plus rapide commence par l’adresse de votre site : Connecter un site ouvre l’assistant de configuration du site, et sa dernière étape, Connexion, vous guide pour le récepteur.
-
Dans le portail client, sélectionnez Connecter un site. Saisissez votre URL publique du site et sélectionnez Continuer. Structura lit votre site, le crée et ouvre Infos du site.
-
Sous Plateforme, vérifiez que votre outil est sélectionné, ou choisissez Mon propre backend pour un site que vous avez développé vous-même. Si Structura a reconnu votre outil, le champ indique Détectée sur votre site. Un domaine personnalisé masque souvent l’outil ; le champ indique alors Non détectée et vous le choisissez dans la liste (ou via Changer de plateforme si la détection s’est trompée). Structura reconnaît un site v0 au marqueur que v0 ajoute à ses pages, même sur un domaine personnalisé. Sans ce marqueur, il propose Next.js, qui récupère les articles depuis la Content API ; choisissez v0 si vous avez créé votre site avec v0.
-
Parcourez l’assistant. Sa dernière étape avant la fin est Connexion. Copiez le prompt dans votre outil ; c’est le même prompt que dans l’onglet de votre outil ci-dessous, et il renvoie votre outil au contrat d’envoi. Lovable ajoute une route de réception à l’intérieur de votre site, généralement
/api/public/structura-articles; Bolt crée une Supabase Edge Function nomméestructura-articles; v0 et Replit ajoutent une route/api/structura. Sur un site développé sur mesure, suivez directement le contrat. Collez ensuite l’URL du récepteur que votre outil vous donne et sélectionnez Continuer. -
À l’étape Vérifier, stockez le Secret de signature dans le backend sous
STRUCTURA_SIGNING_SECRET. Il n’est affiché qu’une fois. Ne le collez jamais dans le chat, le code public ou les variables du navigateur. Votre outil peut proposer un formulaire de secrets dans son chat ; utilisez-le plutôt que de coller le secret en clair. La connexion est enregistrée dès que le secret apparaît : vous pouvez donc passer dans votre outil et revenir quand vous voulez pour envoyer le test. L’étape Connexion affiche alors la connexion enregistrée comme Non testé, avec Envoyer un article de test. -
Choisissez Envoyer un article de test maintenant pour vérifier le récepteur tout de suite. Votre site l’enregistre sous « Structura test article » ; supprimez-le ensuite. Un test réussi marque aussitôt la connexion comme Connecté. Ou choisissez Tester avec mon premier vrai article, puis Tester plus tard : rien n’est envoyé, et votre premier article publié sert de test. Pas encore prêt à coller une URL de récepteur ? Sélectionnez Connecter plus tard et revenez depuis la page Canaux.
-
Créez une campagne dans la langue souhaitée. Utilisez le mode de relecture pour le premier article. Publiez un brouillon, puis consultez Activité et l’URL publique. Vérifiez le titre, le texte, les images, la langue, les métadonnées et l’affichage mobile.
Une connexion créée dans l’assistant envoie les articles de toutes les campagnes. Pour la renommer ou choisir les campagnes, ouvrez-la sur la page Canaux de votre site.
La Vue d’ensemble de votre site indique l’état de l’envoi des articles : Connecté, Non testé ou Non connecté.
Connecter un site déjà présent dans Structura
La boîte de dialogue Connecter votre site fonctionne toujours pour tout site headless que vous avez déjà. Sur la page Canaux du site, sélectionnez Installer sur la carte Envoi des articles. Choisissez votre plateforme, copiez le prompt dans votre outil et collez l’URL du récepteur qu’il vous donne, puis poursuivez avec les étapes 4 et 5 ci-dessus. Si vous fermez la boîte de dialogue avant le test, la connexion est déjà enregistrée : dans l’onglet Connexions, sélectionnez Configurer, puis Envoyer un article de test et Enregistrer. À l’étape Terminé, renommez la connexion si vous le souhaitez et choisissez les campagnes.
Prompt pour votre outil
Ajoute un blog à mon site en conservant son design, ses polices, ses couleurs et sa navigation. Crée /blog et /blog/[slug], de vraies erreurs 404 pour les articles absents, des pages explorables, les métadonnées, URL canoniques et entrées du sitemap.
Connecte l’envoi des articles de Structura. Suis le contrat d’envoi sur https://docs.structurawp.com/en/reference/article-delivery
Ajoute le récepteur de la façon dont ce projet le permet : une route HTTPS POST publique à l’intérieur du site, sur /api/public/structura-articles, ou, seulement si ce projet ne peut pas héberger de route, une Supabase Edge Function nommée structura-articles avec la vérification JWT désactivée (verify_jwt = false). Ajoute une table d’articles persistante. Lis le corps brut de la requête avant de l’analyser. Garde STRUCTURA_SIGNING_SECRET uniquement dans les secrets du projet.
Vérifie X-Structura-Signature avec le corps UTF-8 brut et X-Structura-Timestamp via HMAC-SHA256(secret, timestamp + "." + rawBody). Rejette les horodatages décalés de plus de cinq minutes et les signatures invalides avant de modifier les données. Le seul événement pris en charge est "post.published" dans le champ event du corps JSON, avec schema_version 1 ; il n’y a pas d’en-tête d’événement. Rejette les autres événements ou versions de schéma avec le code 422. Lis STRUCTURA_SIGNING_SECRET dans l’environnement ou les secrets du récepteur, uniquement au moment de traiter chaque requête ; ne le stocke jamais dans une base de données ni dans un vault, et ne l’expose jamais via une fonction, un RPC ou un endpoint que le navigateur peut appeler.
Utilise une transaction avec event_id unique pour dédupliquer et mets les articles à jour par site.id + post.id + post.locale. Refuse les révisions anciennes. Le corps de l’article arrive dans post.html (HTML assaini), avec post.markdown à côté ; il n’existe pas de champ post.content. Stocke post.html et les champs SEO disponibles. post.featuredImage vaut null ou un objet avec url et alt ; utilise son url pour l’image principale de l’article et pour og:image, et son alt comme texte alternatif. Assainis le HTML au rendu. Dans le head de la page d’article, émets chaque entrée de post.jsonLd dans l’ordre reçu, y compris la première (BlogPosting), chacune sérialisée de façon sûre dans son propre <script type="application/ld+json"> ; ne les fusionne pas, n’en écarte aucune comme doublon, ne les réécris pas, ne les remplace pas et n’ajoute pas ton propre nœud BlogPosting ou Article. Affiche post.author (name, avatarUrl, bio, lien vers url) comme signature d’auteur quand il n’est pas null. Réponds 2xx après stockage durable uniquement ; les doublons valides reçoivent aussi 2xx.
Ne me demande pas encore la valeur de STRUCTURA_SIGNING_SECRET : utilise une valeur provisoire pour tes propres tests, et demande-moi la vraie après m’avoir répondu avec l’URL du récepteur ; je l’obtiens auprès de Structura dès que j’y colle ton URL. Teste un envoi valide, une signature invalide et un rejeu, puis ouvre la page d’un article reçu et vérifie que l’URL canonique, l’image à la une et chaque script JSON-LD apparaissent vraiment dans la page rendue, avant de dire que c’est terminé. Si l’hébergement ne peut pas renvoyer de vrais codes d’état 404 ni servir /sitemap.xml en XML, dis-le au lieu d’ajouter des substituts côté client. Ensuite, réponds avec l’URL publique du récepteur pour que je puisse la coller dans Structura.Ce qui se passe ensuite
Chaque nouvelle publication envoie un article, y compris les brouillons validés plus tard. Les brouillons restent privés. La langue du contenu est conservée ; celle des notifications ne le traduit pas. Les articles existants ne sont pas importés automatiquement.
Les modifications et suppressions ultérieures ne sont pas synchronisées. Mettez à jour votre copie ou utilisez la Content API pour lire l’état actuel. Plusieurs envois sont possibles ; le récepteur doit les dédupliquer.
Problèmes courants
-
Non testé : la connexion est enregistrée, mais aucun test ni vrai article n’a atteint votre récepteur depuis sa configuration ou le changement de son URL ou de son secret. Sélectionnez Envoyer un article de test à l’étape Connexion de l’assistant, ou ouvrez la connexion dans l’onglet Connexions, sélectionnez Envoyer un article de test, puis Enregistrer. Vous pouvez aussi publier un nouvel article et vérifier Activité et campagnes.
-
HTTP 401/403 : vérifiez le secret, la validation du corps brut et la protection de l’hébergement. Sur Bolt, vérifiez aussi que la fonction
structura-articlesn’exige pas de JWT. -
HTTP 404 : utilisez l’URL déployée du récepteur, pas l’aperçu du site.
-
HTTP 429/5xx ou délai dépassé : Structura réessaie immédiatement une seule fois. Il n’y a ni file durable ni nouvelle tentative ultérieure. Corrigez le récepteur et récupérez les publications via la Content API.
-
Article indisponible : l’article doit être public, avoir du contenu et une URL publique.
-
Article trop volumineux : le JSON complet doit tenir dans 1 Mo. Utilisez la Content API pour les articles plus volumineux.
-
Offre non éligible : L’envoi d’articles nécessite un abonnement payant actif. Vérifiez votre offre et votre paiement. L’option Channels n’est pas nécessaire.
Pages connexes
Dernière vérification :