Fonctionnement des intégrations dans Athena
L’onglet API contient les intégrations de mesure, publication et rapports des sites. La plupart concernent un seul site : si votre organisation en possède plusieurs, chacun a ses connexions (par exemple sa propriété GA4). Le bot Slack Athena est configuré une fois par organisation. Les connexions de l’onglet Outils MCP connectés appartiennent à un compte individuel et peuvent être partagées avec l’organisation pour les conversations Athena. Toutes se gèrent dans Paramètres > Intégrations, en cinq sections :- Mesurer et attribuer — Google Analytics 4 et Google Search Console. Relient trafic et visibilité de recherche aux analyses Athena.
- Créer et publier — Shopify, Webflow, Wix, Framer, WordPress, Payload CMS, Sanity et Contentful. Publient le contenu Athena directement sur votre site.
- Suivre et visualiser — Looker Studio. Créez des tableaux de bord personnalisés dans votre outil BI.
- Rapports — rapports Slack. Envois planifiés vers un canal ou message direct.
- Organisation — bot Slack Athena pour Enterprise.
Google Analytics 4 (GA4)
Fonctionnement
Une propriété GA4 connectée alimente les vues analytiques d’Athena. L’accès est en lecture seule : Athena n’écrit jamais dans votre propriété et ne modifie rien côté Google.Prérequis
- Un compte Google ayant accès à la propriété souhaitée.
- Un accès en lecture à cette propriété.
Connexion
- Ouvrez Paramètres > Intégrations.
- Cliquez sur Google Analytics 4.
- Connecter Google Analytics, puis autorisez dans la fenêtre Google OAuth.
- Si une seule propriété est accessible, Athena la sélectionne automatiquement. Sinon, choisissez-la dans la liste avec recherche.
Où voir les résultats
Il n’y a pas de tableau de bord GA4 autonome. Les données apportent du contexte à votre travail de recherche IA et Ask Athena permet d’interroger directement la propriété :- Ask Athena. L’assistant interroge la propriété connectée : sessions par
sessionSourceousessionMedium, vues parpagePath, rebond par pays ou appareil, événements clés (conversions), comparaisons de périodes ou données en direct des 30 dernières minutes. Pour isoler les apports IA, demandez les sessions parsessionSourceet cherchezchat.openai.com,perplexity.aiougemini.google.com. - Content Hub (barre latérale > Contenu). Dans Métriques, choisissez Analyses du site : Trafic, Taux de rebond, Taux d’engagement, Durée moyenne et Trafic IA par ligne. Un clic sur la cellule ouvre leur évolution chronologique. La vue agrégée en bas donne les mêmes répartitions en moyenne sur les lignes publiées.
- Import depuis GA4. Lors de l’ajout de lignes à Content Hub, l’import lit les pages principales par trafic pour choisir les URL à suivre.
- Win Finder. Les réussites peuvent juxtaposer sessions GA4 d’une URL et métriques de visibilité IA. « Ce qui fonctionne » dans Olympus ouvre la même vue.
En cas de problème
- « Connexion GA4 expirée » : le jeton OAuth a expiré. L’erreur apparaît lors d’une lecture (import GA4, par exemple) et les métriques Analyses du site cessent de s’actualiser dans Content Hub. Rouvrez Paramètres > Intégrations > Google Analytics 4, puis Connecter Google Analytics.
- Liste de propriétés vide : le compte n’a accès à aucune propriété ou le périmètre OAuth a été refusé. Confirmez l’accès dans Google Analytics puis reconnectez.
Google Search Console (GSC)
Fonctionnement
Athena lit les requêtes, impressions et clics de la propriété. Ils alimentent la découverte de prompts et les métriques organiques du produit. Comme GA4, GSC est en lecture seule.Prérequis
- Un compte Google ayant accès à une propriété GSC vérifiée, de domaine ou de préfixe d’URL.
Connexion
- Ouvrez Paramètres > Intégrations.
- Cliquez sur Google Search Console.
- Connecter Search Console, puis autorisez dans Google OAuth.
- Choisissez le site dans la liste avec recherche. Les libellés Domaine ou Préfixe d’URL reprennent sa configuration GSC.
Où voir les résultats
- Discover (barre latérale > Prompts > Découvrir). GSC alimente la source Search Console : Athena regroupe vos requêtes performantes et propose des prompts à suivre. Les résultats correspondants portent le badge GSC. Sans connexion, cette source est désactivée dans le panneau de lancement avec un lien de connexion.
- Content Hub (barre latérale > Contenu). Dans Métriques, Recherche organique affiche Clics, Impressions et CTR par ligne. Le panneau de métriques montre aussi leurs tendances.
En cas de problème
- Aucune propriété après connexion : vérifiez votre statut d’utilisateur vérifié sur au moins une propriété GSC, puis rouvrez le panneau et actualisez.
- Métriques absentes d’une ligne Content Hub : un court délai est nécessaire au remplissage initial. Si elles restent absentes, vérifiez que l’URL correspond à une URL suivie dans la propriété connectée.
Google Ads
Fonctionnement
Google Ads relie votre compte publicitaire au site Athena et mémorise le compte client choisi. Il s’agit actuellement d’une intégration de connexion uniquement : aucune fonctionnalité Athena (Discover, Olympus, Content Hub, Win Finder) ne lit encore les mots-clés, termes de recherche ou campagnes de ce compte. La connexion prépare les futures fonctionnalités Ads. Cet article sera actualisé à leur sortie.Prérequis
- Un compte Google ayant accès à un ou plusieurs comptes clients Google Ads.
Connexion
- Ouvrez Paramètres > Intégrations.
- Cliquez sur Google Ads.
- Connecter Google Ads, puis autorisez dans Google OAuth.
- Choisissez le compte client dans la liste avec recherche. Les comptes administrateur (MCC) sont identifiés.
Où voir les résultats
- Paramètres > Intégrations > Google Ads. Statut de connexion, compte client actif et liste de changement de compte.
Shopify
Fonctionnement
Deux usages :- Publication depuis Athena. Les articles créés dans Content Hub peuvent être publiés directement sur votre blog Shopify.
- Optimisation du catalogue. Athena importe les produits pour générer et publier titres, descriptions, métadonnées et FAQ optimisés.
Prérequis
- Autorisation d’installer des applications sur la boutique.
- Autorisation de gérer les intégrations du site Athena concerné.
- Offre Enterprise ou Agency pour l’optimisation du catalogue.
Connexion
- Dans Paramètres > Intégrations, ouvrez Shopify.
- Cliquez sur Ouvrir Shopify App Store.
- Installez AthenaHQ Commerce sur la boutique cible et approuvez les autorisations demandées.
- Au retour dans Athena, confirmez le bon site et Connecter Shopify.
- Choisissez un Blog par défaut ; les nouveaux articles y seront publiés par défaut.
Où voir les résultats
- Panneau Shopify des intégrations. Nom de boutique, domaine principal, date de dernière vérification, Blog par défaut et avertissements d’autorisations manquantes.
- Centre d’action > Optimisation du catalogue. Importez les produits, générez des brouillons et publiez les changements approuvés.
- Content Hub > ligne > Publication > Shopify. Configurez blog, titre, slug, auteur et brouillon/production, puis Publier ou Mettre à jour. La confirmation affiche l’URL et Voir l’article.
En cas de problème
- « Autorisations manquantes » : ouvrez AthenaHQ Commerce dans l’administration Shopify pour reconnecter et approuver les accès.
- « Article not found » (404) à la mise à jour : l’article a été supprimé directement dans Shopify. Utilisez Publier comme nouvel article dans l’éditeur Athena.
Webflow
Fonctionnement
Publiez les articles Content Hub dans votre CMS Webflow. Athena lit les schémas de collections pour connaître les champs attendus (titre, corps, slug, résumé, auteur, etc.) et les préremplir. Vérifiez et remplacez tout champ avant publication.Prérequis
- Un site Webflow que vous possédez ou pouvez modifier.
- Un Site Token Webflow (jeton API, pas OAuth) avec Sites: Read et CMS: Read & Write.
Connexion
- Dans webflow.com/dashboard, générez un Site Token avec ces autorisations. Documentation : Site Token.
- Dans Athena, Paramètres > Intégrations > Webflow.
- Collez-le à Étape 1 — Ajouter votre jeton Webflow, puis Vérifier le jeton.
- À Étape 2 — Sélectionner votre site, choisissez le site puis Enregistrer la connexion.
Où voir les résultats
- Panneau Webflow des intégrations. Nom, domaine, dernière vérification et collections synchronisées avec leurs schémas.
- Content Hub > ligne > Publication > Webflow. Choisissez la collection, vérifiez les champs associés (titre, contenu, slug, résumé, auteur), choisissez brouillon/en ligne et Publier. La confirmation montre l’URL et Voir la publication. L’icône crayon permet de modifier manuellement l’URL publiée enregistrée.
En cas de problème
- « Jeton expiré » ou authentifications en échec répétées : délai de 365 jours atteint. Générez un nouveau Site Token avec les mêmes droits et collez-le dans le panneau.
- Champ mal associé : Athena recherche des slugs tels que
title,body,content,slug,summary,author. Pour des slugs inhabituels, corrigez manuellement l’association dans Publication. - « Erreur de validation » ou « Conflit de données » Webflow : contenu ou métadonnées incompatibles avec le schéma (champ obligatoire absent, slug pris, etc.). La notification précise le champ ; corrigez et réessayez.
Wix
Fonctionnement
Publiez articles et brouillons Athena sur votre site Wix. Athena lit les catégories du blog et les membres pour attribuer la publication à un membre précis.Prérequis
- Site ID Wix : segment suivant
/dashboard/dans l’URL d’administration. - Clé API Wix avec les autorisations Wix Blog et Read Members. Gestion dans manage.wix.com/account/api-keys.
- Un membre Wix sous l’identité duquel publier.
Connexion
- Dans Athena, Paramètres > Intégrations > Wix.
- Saisissez Site ID et clé API.
- Charger les membres du site remplit Publier en tant que.
- Choisissez un membre puis Connecter Wix.
Où voir les résultats
- Panneau Wix. URL, Site ID, Member ID, indicateur de stockage sécurisé de la clé, nombre de catégories, brouillons récents et jusqu’à 10 catégories.
- Content Hub > ligne > Publication > Wix. Choisissez catégorie, titre, slug, etc., puis publiez.
Framer
Fonctionnement
Publiez du contenu Athena dans vos collections CMS Framer.Prérequis
- URL ou ID du projet : URL d’éditeur (
framer.com/projects/Site--abc123, par exemple) ou identifiant seul. N’utilisez pas l’URL publiée.framer.website. - Clé API Framer générée dans Site Settings > General > API Keys de Framer.
Connexion
- Dans Athena, Paramètres > Intégrations > Framer.
- Saisissez URL/ID et clé API.
- Vérifier la connexion, puis Enregistrer la connexion après réussite.
Où voir les résultats
- Panneau Framer. Projet connecté, URL et liste repliable des collections avec nom, ID et type de champ.
- Content Hub > ligne > Publication > Framer. Choisissez la collection puis publiez.
WordPress
Fonctionnement
Publiez et actualisez les articles WordPress depuis Athena. WordPress auto-hébergé avec mots de passe d’application et WordPress.com / sites Jetpack avec OAuth sont pris en charge. Athena détecte automatiquement la méthode.Prérequis
- URL du site, par exemple
example.com. - Auto-hébergé : compte utilisateur et mot de passe d’application, généré dans Utilisateurs > Profil > Mots de passe d’application de l’administration.
- WordPress.com / Jetpack : capacité d’autoriser Athena via OAuth WordPress.com.
Connexion
- Dans Athena, Paramètres > Intégrations > WordPress.
- Saisissez l’URL et Détecter la méthode de connexion.
- Si auto-hébergé : nom d’utilisateur, mot de passe d’application, puis Connecter.
- Si OAuth : Connecter avec OAuth, puis autorisez dans la fenêtre.
Où voir les résultats
- Panneau WordPress. Nom du site, badge OAuth ou Mot de passe d’application, URL, utilisateur pour cette dernière méthode, nombre d’articles et jusqu’à 10 catégories avec leurs nombres d’articles.
- Content Hub > ligne > Publication > WordPress. Choisissez le statut (draft, pending, publish), la catégorie et publiez.
En cas de problème
- « OAuth non configuré » dans WordPress.com : les identifiants OAuth de votre instance ne sont pas configurés. Contactez l’assistance ; les mots de passe d’application constituent une solution de repli.
- « Échec d’authentification » en auto-hébergé : utilisez la longue chaîne générée du mot de passe d’application, pas votre mot de passe normal, et vérifiez le droit de publication de l’utilisateur.
Payload CMS
Fonctionnement
Publiez dans un déploiement Payload CMS auto-hébergé. Athena lit les collections pour connaître les destinations et autorisations disponibles.Prérequis
- URL racine du serveur (
cms.example.com, par exemple), sans chemin/adminou/api. - Clé API générée depuis une collection d’utilisateurs Payload avec
auth: { useAPIKey: true }. Activez les clés sur cette collection, créez un utilisateur au bon rôle et copiez la clé.
Connexion
- Dans Athena, Paramètres > Intégrations > Payload CMS.
- Saisissez URL serveur et clé API.
- Vérifier la connexion, puis Enregistrer la connexion.
Où voir les résultats
- Panneau Payload CMS. URL serveur, Collections publiables avec droits de lecture/création/modification et Collections système séparées (collections natives et extensions officielles, masquées dans Publication).
- Content Hub > ligne > Publication > Payload. Choisissez une collection publiable puis publiez.
Sanity CMS
Il vous faut le Project ID, le Dataset et un jeton API ayant accès au projet. Une Studio URL peut aussi être fournie.- Ouvrez Paramètres > Intégrations > API > Sanity CMS.
- Saisissez projet, jeu de données et jeton, puis Connecter Sanity.
- Vérifiez les Types de documents. Synchronisez-les après modification du schéma Sanity.
- Dans Content Hub, choisissez Sanity comme destination et configurez le type et l’association des champs avant publication.
Contentful
Il vous faut Space ID, Environment et Management API token. Le compte du jeton doit accéder à cet espace et environnement.- Ouvrez Paramètres > Intégrations > API > Contentful.
- Saisissez les informations puis Connecter Contentful.
- Vérifiez Types de contenu ; Synchroniser les types de contenu les actualise après modification du modèle.
- Dans Content Hub, choisissez Contentful et configurez type et association des champs.
Applications connectées aux conversations Athena
Ouvrez Paramètres > Intégrations > Outils MCP connectés. Ces connecteurs permettent à Athena d’utiliser les outils externes choisis pour une conversation. Ils sont distincts des intégrations de mesure/publication de l’onglet API.- Ajouter un connecteur, puis choisissez-en un ou configurez un serveur MCP personnalisé.
- Terminez son authentification.
- Choisissez Privé ou Partagé avec l’organisation. Le partage permet aux autres membres d’utiliser votre compte connecté dans leurs conversations ; chacun doit le sélectionner dans sa propre conversation.
- Dans Athena, utilisez Ajouter des fichiers et connecteurs pour choisir jusqu’à cinq connexions. Une mention @ peut aussi sélectionner un connecteur pendant la rédaction.
Looker Studio
Fonctionnement
Créez des tableaux de bord Looker Studio utilisant les données Athena via un connecteur communautaire. Ils s’actualisent automatiquement avec la visibilité de marque, à côté de vos autres sources. Contrairement à la plupart des intégrations, Looker Studio se configure hors d’Athena. Sa tuile ouvre un guide détaillé plutôt qu’un parcours OAuth.Prérequis
- Clé API Athena, à générer lors de la configuration.
- Compte Looker Studio.
Connexion
- Dans Athena, Paramètres > Intégrations > Looker Studio ouvre les instructions.
- Suivez-les pour générer une clé et ajouter le connecteur communautaire Athena.
- Construisez vos tableaux dans Looker Studio.
Où voir les résultats
- Les tableaux sont dans Looker Studio. La tuile Athena affiche toujours Guide de configuration plutôt qu’un statut de connexion : c’est normal.
Rapports Slack
Fonctionnement
Athena envoie les rapports planifiés (PDF) dans des canaux ou messages directs Slack. Créés dans Rapports, ils peuvent inclure tous les graphiques Athena avec des filtres. Chaque rapport possède fréquence (hebdomadaire, mensuelle ou trimestrielle) et destinataires. L’intégration est propre au site ; chaque site d’une organisation possède sa connexion d’espace Slack.Prérequis
- Espace Slack et autorisation d’y approuver une application.
Connexion
- Paramètres > Intégrations > Rapports Slack.
- Connecter Slack, puis autorisez via Slack OAuth.
- Ouvrez ou créez un rapport depuis Rapports dans la barre latérale.
- Cliquez sur Paramètres.
- Dans Destinataires, remplacez E-mail par Canal Slack ou Message direct Slack, choisissez le canal/utilisateur puis Ajouter.
- Enregistrez le rapport.
Où voir les résultats
- Panneau Rapports Slack. Nom d’espace connecté et date de connexion.
- Rapports > rapport > Paramètres > Destinataires. E-mails, canaux et messages directs configurés.
- Slack. PDF joints envoyés selon la fréquence dans les destinations choisies.
Bot Slack (Enterprise)
Fonctionnement
Le bot Athena répond aux questions de visibilité dans les canaux suivis, par exemple une mention@Athena sur la part de voix ou les citations récentes. Il est commun à l’organisation, installé une seule fois, et réservé aux offres Enterprise.
Prérequis
- Offre Enterprise.
- Espace Slack et autorisation d’installer une application.
Connexion
- Paramètres > Intégrations > Bot Slack.
- Connecter Slack, puis autorisez via OAuth.
- Dans Slack, invitez @Athena aux canaux où il doit répondre.
- Dans le panneau Athena, sélectionnez-les via Ajouter un canal pour les suivre.
C01ABCD2EFG. Vous pouvez ajouter des notes facultatives, comme un nom de client.
Gérer les canaux suivis
Le panneau liste pour chacun :- Identifiant et notes facultatives
- Interrupteur Activé / Désactivé : le bot ne répond que dans les canaux activés
- Retirer pour arrêter complètement le suivi
Où voir les résultats
- Panneau Bot Slack. Statut, canaux suivis et commandes individuelles.
- Votre espace Slack. Mentions de
@Athenadans les canaux suivis.
Questions fréquentes
Je suis lecteur : pourquoi ne puis-je rien connecter ?
Les intégrations de site de API exigent leurs autorisations spécifiques. Demandez à un administrateur si les commandes sont désactivées. Outils MCP connectés possède un autre modèle : les membres peuvent connecter des comptes pour eux-mêmes et éventuellement les partager.La fenêtre OAuth s’est fermée avant la fin. Pourquoi ?
Athena indique « La fenêtre d’autorisation s’est fermée avant la fin. Réessayez et gardez-la ouverte jusqu’à la confirmation du consentement. » Cliquez sur Connecter et terminez le parcours dans la fenêtre.Comment changer de propriété GA4, site GSC ou compte Google Ads ?
Ouvrez le panneau dans Paramètres > Intégrations. La liste avec recherche change la sélection active et l’icône d’actualisation recharge les choix Google. Le changement est immédiat.Comment déconnecter une intégration ?
Ouvrez sa tuile puis Déconnecter en bas. Une seconde étape affiche Annuler / Confirmer la déconnexion ; confirmez pour retirer réellement la connexion. Cette précaution s’applique à toutes les intégrations.Les intégrations Google écrivent-elles dans Google ?
Non. GA4/GSC sont en lecture seule. Google Ads ne fait que conserver le compte sélectionné sans encore lire campagnes, mots-clés ou termes. Athena n’écrit jamais dans Analytics, Search Console ou Ads.Les intégrations concernent-elles un site ou toute l’organisation ?
Presque toutes sont par site : changer de site change les connexions analytiques, CMS et rapports Slack visibles. Le bot Slack est installé une fois par organisation. Les Outils MCP connectés sont privés ou partagés et choisis pour chaque conversation.Que deviennent les destinataires si je déconnecte les rapports Slack ?
La connexion est retirée, mais les destinataires de chaque rapport sont conservés. Les envois reprendront après reconnexion d’un espace Slack.Que deviennent les canaux suivis si je déconnecte le bot ?
Les règles sont conservées et la liste rétablie si vous reconnectez le même espace.Pourquoi mon jeton Webflow ne fonctionne-t-il plus ?
Les Site Tokens expirent après 365 jours d’inactivité. Après plus d’un an sans publication, générez-en un autre avec Sites: Read et CMS: Read & Write puis reconnectez.Comment reconnecter AthenaHQ Commerce ?
Ouvrez AthenaHQ Commerce depuis l’administration Shopify. De retour dans Athena, confirmez le bon site et reconnectez la boutique.Comment ajouter le bot à un canal privé ou Slack Connect ?
Le sélecteur ne montre que les canaux où@Athena est membre. Invitez-le d’abord au canal privé. Les canaux Slack Connect n’apparaissent jamais dans la liste : utilisez Ajouter par identifiant de canal, clic droit Slack > Copier le lien, avec un identifiant comme C01ABCD2EFG.
Puis-je ouvrir directement le panneau d’une intégration ?
Oui, avecSettings > Integrations et ?provider=<id> (par exemple ?provider=ga4, ?provider=gsc, ?provider=webflow). Le panneau s’ouvre au chargement. Les lecteurs ne peuvent pas l’ouvrir même par lien direct, faute d’autorisation de gestion.
Pour toute autre question, contactez votre équipe Athena ou l’assistance : nous pouvons parcourir ensemble toute intégration en direct.