Integrations

Les intégrations permettent à Mediastilo de publier vos brouillons terminés là où votre public lit vraiment. Vous connectez une destination une fois par marque, puis vous pouvez envoyer directement n'importe quel brouillon prêt. Les connexions se gèrent depuis la section Integrations de votre tableau de bord.

Destinations prises en charge

Mediastilo propose aujourd'hui trois destinations de publication :

Chaque destination est une connexion par marque : connecter WordPress pour une marque ne le connecte pas pour les autres. Voir Workspaces & Brands.

La publication dépend de votre formule. Si vous ne voyez pas Integrations ou l'action Push, vérifiez votre formule dans Credits & Billing.

Connecter une destination

1. Ouvrez Integrations et choisissez un type de destination.
2. Remplissez ses champs (voir ci-dessous). Les champs secrets (mots de passe, clés d'API, secrets de signature) sont chiffrés au repos et masqués chaque fois que vous rouvrez la connexion.
3. Mediastilo effectue un test de connexion pour confirmer que les identifiants fonctionnent avant d'enregistrer.
4. La connexion s'affiche comme Active quand tout va bien, ou Error si une vérification ultérieure échoue (par exemple si vous renouvelez une clé côté destination).

Vous pouvez relancer le test à tout moment, vous reconnecter avec de nouveaux identifiants ou déconnecter complètement une destination.

WordPress

WordPress dispose d'une configuration guidée. Cliquez sur Set up with guide, saisissez l'adresse de votre site : Mediastilo vérifie le site et vous propose la voie la plus simple.

• Autorisation en un clic (recommandée). Si votre site la prend en charge, Mediastilo vous envoie sur votre propre WordPress pour approuver l'accès, sans mot de passe à copier. WordPress génère un Application Password et le transmet automatiquement.
• Saisie manuelle (solution de repli). Si l'autorisation en un clic n'est pas disponible, créez un Application Password dans WordPress (Users → Profile → Application Passwords) et collez-le avec l'URL de votre site et votre nom d'utilisateur.

Une fois connecté, l'assistant vous permet de choisir les valeurs de publication par défaut (le type de contenu, les catégories par défaut, et si les articles partent publiés ou en brouillon) et, en option, de rafraîchir la voix de votre marque en analysant à nouveau le site (cela consomme un crédit d'analyse). Vous pourrez modifier ces réglages plus tard depuis la connexion WordPress (Edit publishing defaults).

Ghost

Mediastilo utilise la Ghost Admin API. Dans Ghost, créez une Custom Integration (Settings → Integrations → Add custom integration) pour obtenir une Admin API key au format id:secret, ainsi que l'Admin API URL. Collez les deux ici.

Webhook / Custom REST

Pour tout le reste, indiquez à Mediastilo une URL de point de terminaison que vous contrôlez. À la publication, Mediastilo envoie un POST JSON décrivant le contenu, signé avec un en-tête X-Mediastilo-Signature: sha256=… dérivé de votre secret de signature, afin que votre récepteur puisse vérifier que la requête est authentique. Un événement ping est envoyé lorsque vous testez la connexion.

Publier un brouillon

Une fois une destination connectée et un brouillon Ready, utilisez Push dans l'éditeur ou la vue du brouillon pour l'envoyer. Vous pouvez publier vers plusieurs destinations à la fois en les sélectionnant. Pour une destination WordPress sélectionnée, vous pouvez ajuster sur place le type de contenu, les catégories, les étiquettes et le statut, préremplis avec vos valeurs par défaut et modifiables à chaque publication. Mediastilo :

• Envoie le titre et le corps sous forme d'article publié (ou programmé, si vous définissez une heure de publication), avec le type de contenu, les catégories et les étiquettes choisis.
• Enregistre le résultat : l'identifiant de l'article côté destination et un lien pour le consulter.
• Marque la publication comme published ou failed, avec l'erreur en cas de problème, pour que vous puissiez corriger la connexion et réessayer.

Consultez Drafts & Publishing pour le cycle de vie complet d'un brouillon.

Ce qu'une connexion lit

Une connexion fonctionne dans les deux sens. En plus d'envoyer des brouillons, Mediastilo relit ce que le site a déjà publié (titre, date, auteur, catégories et étiquettes) afin que votre propre production puisse être mesurée comme nous mesurons celle des autres. Rien de plus ne vous est demandé : la lecture utilise les identifiants déjà fournis pour la publication, et ne porte que sur les articles publiés. Les brouillons, les articles privés et tout ce qui se trouve dans un circuit éditorial restent où ils sont.

C'est la différence entre un site sur lequel vous publiez et un site que vous surveillez : un CMS connecté fournit de vraies dates et de vraies catégories, plutôt que ce qu'une page publique veut bien afficher. C'est la base fiable de vos comparatifs. Déconnectez la destination, et la lecture s'arrête avec elle.

Ce qui revient : Google Search Console

Les destinations sont l'endroit où va votre contenu. La Search Console en est l'autre moitié : ce qui se passe une fois qu'il y est arrivé. En la connectant, Mediastilo voit les termes de recherche saisis avant d'arriver sur votre site, les pages d'arrivée et leur fréquence, pour que les idées que nous proposons reposent sur ce que les gens cherchent vraiment et pas seulement sur les sujets que vous nous indiquez.

Elle se trouve dans la section What comes back de la page Integrations, sous vos destinations.

Ce que nous lisons, et ce que nous ne pouvons pas faire

• Nous lisons les termes de recherche, pages d'arrivée, clics, impressions et la position moyenne, sur les 16 derniers mois au maximum.
• L'autorisation est en lecture seule. Mediastilo ne peut rien modifier dans la Search Console ni ailleurs dans votre compte Google.
• Nous ne voyons jamais votre mot de passe Google, et vous pouvez vous déconnecter à tout moment.

Vous pouvez aussi simplement demander

Dès qu'une des deux connexions existe, Ask et l'assistant de rédaction peuvent la consulter au fil d'une conversation : « que tapent les gens pour nous trouver ? », « comment s'est comporté l'article de la semaine dernière ? », « qu'avons-nous réellement publié ce mois-ci ? ». Les outils ne sont proposés à une conversation que si la connexion existe : une réponse sur vos termes de recherche n'est donc jamais construite à partir de connaissances générales. Tant que rien n'est connecté, Ask indique ce qui lui manque et peut vous proposer une carte qui mène à cette page ; la connexion elle-même est toujours faite par vous, avec votre propre compte.

Avant de vous connecter

Vous devez déjà être validé comme propriétaire ou utilisateur du site dans la Search Console, avec le compte Google que vous allez connecter. Si vous connectez un compte non validé pour votre site, la connexion réussit mais il n'y a rien à mesurer : Mediastilo vous le signale et vous propose d'essayer un autre compte.

Choisir le site à mesurer

Après l'autorisation, vous choisissez une propriété. La Search Console en a deux types, qui ne contiennent pas les mêmes données :

C'est la cause la plus fréquente d'une connexion Search Console qui ne renvoie discrètement rien : un site servi sur example.com mesuré par une propriété pour https://www.example.com/. Mediastilo compare chaque propriété au site sur lequel vous publiez déjà et marque la plus probable avec Matches your site : dans la plupart des cas, la bonne réponse est déjà en haut de la liste.

Les propriétés que vous voyez sans pouvoir les lire (la Search Console parle d'utilisateur non validé) apparaissent grisées avec la raison. Demandez au propriétaire du site un accès complet ou restreint et elles deviendront sélectionnables.

Rien n'est jamais choisi à votre place, même s'il n'y a qu'une option, car ce choix détermine le sens de tous les chiffres qui suivront.

Pendant le chargement de l'historique

Les jours les plus récents arrivent en premier : le dernier mois est donc exploitable presque immédiatement. Les mois antérieurs sont récupérés en arrière-plan les jours suivants, et la carte indique combien des seize mois sont déjà disponibles.

La Search Console publie ses données avec quelques jours de décalage : les chiffres les plus récents ont donc toujours un peu de retard sur aujourd'hui. Ce décalage vient de Google, pas de nous.

Se reconnecter et se déconnecter

• Needs reconnecting signifie que Google n'accepte plus la connexion, généralement parce que l'accès a été retiré dans le compte Google ou que la personne qui l'avait accordé est partie. Rien de ce qui a été collecté n'est perdu : reconnectez-vous et la mesure reprend là où elle s'était arrêtée.
• Disconnect supprime la connexion et efface les données de recherche collectées par son intermédiaire.

Dépannage

• La connexion affiche Error : relancez le test. Les causes les plus courantes sont une clé d'API renouvelée, un Application Password expiré ou une URL de site modifiée. Reconnectez-vous avec de nouveaux identifiants.
• WordPress échoue : vérifiez qu'il s'agit bien de l'Application Password (et non du mot de passe de connexion) et que l'API REST est joignable à …/wp-json/.
• Ghost échoue : vérifiez que la clé est bien l'Admin API key complète au format id:secret et que l'URL pointe vers votre domaine d'administration Ghost.
• Le webhook échoue : vérifiez que votre point de terminaison renvoie un statut 2xx pour l'événement ping et qu'il vérifie l'en-tête X-Mediastilo-Signature.

La suite pour les intégrations

Le modèle de connexion est conçu pour évoluer : les destinations sont modulaires, et l'autorisation en un clic est déjà disponible pour WordPress. Étendre cette connexion sans copier-coller à d'autres plateformes fait partie de la feuille de route. Les nouvelles destinations apparaissent automatiquement dans la liste Integrations dès leur sortie.

Voir aussi

• Drafts & Publishing : générer et envoyer des brouillons.
• Workspaces & Brands : les connexions sont par marque.
• Account & Settings : où se trouvent les Integrations.
• Credits & Billing : les formules qui incluent la publication.