Menu de la documentationInterroger un seul assistant IA sur tous vos sites clients

Interroger un seul assistant IA sur tous vos sites clients

Vireo Pro Nécessite une licence Vireo Pro active.

Connectez un assistant IA à une installation Vireo Pro et interrogez-le sur chaque site client qui y remonte, de la vue multisite aux pages principales d'un site.

Sur cette page

Si vous gérez les statistiques de plusieurs clients, vous pouvez faire remonter leurs sites dans une seule installation WordPress sous forme de sites connectés. Avec Vireo Pro, un seul assistant IA connecté à cette installation peut alors répondre pour tous : quels clients progressent ou reculent ce mois-ci, et ce qui l’explique sur chaque site.

À qui il s’adresse

Aux agences et aux freelances dont les sites clients remontent dans une même installation Vireo, en général avec la formule 25 sites ou illimitée. Chaque site connecté utilise un site de votre formule : sa taille décide donc du nombre de clients qu’une installation peut accueillir. Voir Combien de sites.

Les sites clients n’ont pas besoin d’être sous WordPress. Tout site auquel vous pouvez ajouter une balise script peut devenir un site connecté : un site statique, une landing page, un site de documentation.

Si vous gérez déjà les sites WordPress de vos clients avec MainWP, vous n’avez pas besoin de sites connectés pour eux. Faites tourner Vireo Pro sur le tableau de bord MainWP et l’assistant lit chaque site enfant via MainWP. Voir Avec un tableau de bord MainWP.

Avant de commencer

  1. Sur le site WordPress de votre agence, installez Vireo Pro et activez la licence.
  2. Ajoutez chaque site client sous Vireo Analytics, Réglages, Autres sites, Sites connectés, et collez sa balise dans ce site. Voir Sites connectés.
  3. Connectez votre assistant IA à cette installation, une seule fois. Tous les sites clients sont accessibles via cette unique connexion.

Interroger tous les sites

Commencez large :

Parmi mes sites clients, lesquels sont en hausse ou en baisse ce mois-ci ?

L’assistant appelle get-sites-overview. Il renvoie chaque site, du plus fréquenté au moins fréquenté, avec les pages vues et les visiteurs de la période à côté de la période précédente de même durée, la variation en pourcentage et le dernier jour où chaque site a enregistré une visite :

{
  "start": "2026-09-12", "end": "2026-10-11",
  "prior_start": "2026-08-13", "prior_end": "2026-09-11",
  "sites": [
    {"id": 0, "name": "Agency site", "this_site": true, "last_data": "2026-10-11", "pageviews": 3000, "prior_pageviews": 2384, "pageviews_change_pct": 25.8},
    {"id": 2, "name": "Client B", "this_site": false, "last_data": "2026-10-11", "pageviews": 1500, "prior_pageviews": 745, "pageviews_change_pct": 101.3},
    {"id": 1, "name": "Client A", "this_site": false, "last_data": "2026-10-11", "pageviews": 300, "prior_pageviews": 596, "pageviews_change_pct": -49.7},
    {"id": 3, "name": "Client C", "this_site": false, "last_data": "2026-09-11", "pageviews": 0, "prior_pageviews": 894, "pageviews_change_pct": -100}
  ]
}

L’exemple est abrégé : chaque site comporte aussi son url, ses visitors, prior_visitors et visitors_change_pct.

Une date last_data très ancienne, comme celle du Client C, signifie en général que la balise du site a été retirée ou ne fonctionne plus. Autant poser la question directement :

Un site client a-t-il cessé d’enregistrer des visites ?

Approfondir un site

Chaque site a un identifiant : 0 est l’installation à laquelle vous êtes connecté, et les sites connectés sont numérotés à partir de 1. Demandez un client par son nom : l’assistant retrouve l’identifiant avec get-sites, puis le transmet comme site au rapport voulu :

Quelles ont été les pages les plus vues du Client B la semaine dernière ?

C’est un appel à get-top-pages avec "site": 2. Il en va de même pour les totaux, les sources de trafic, les référents, les pays et les autres rapports listés plus bas. Omettez site, ou passez 0, pour l’installation à laquelle vous êtes connecté.

Avec un tableau de bord MainWP

Vireo Pro intègre la prise en charge de MainWP. Installez Pro sur votre site tableau de bord MainWP et activez la licence : Pro s’ajoute de lui-même à la page Extensions de MainWP. Chaque site enfant a besoin de MainWP Child, de Vireo Analytics et de Vireo Pro avec une licence active.

Si vous utilisiez le plugin séparé Vireo Analytics for MainWP, désactivez-le. Pro remplit le même rôle, et tant que l’ancien plugin est actif, Pro ne touche pas à MainWP et affiche un avis pour le signaler.

Sur le tableau de bord, vous obtenez :

  • Un widget Vireo Analytics sur la page Overview de MainWP, qui liste pour chaque enfant ses visiteurs, ses pages vues et leur variation sur 7 ou 30 jours, d’après la dernière synchronisation.
  • Une page Vireo Analytics pour chaque enfant, avec ses visiteurs, ses pages vues, ses pages principales et ses principaux référents des 7 ou 30 derniers jours, récupérés en direct.
  • Des tokens pour les Pro Reports de MainWP : [vireo.visitors], [vireo.pageviews], [vireo.visitors.change], [vireo.pageviews.change], [vireo.top.pages] et [vireo.top.referrers]. Chacun est rempli pour le site et les dates du rapport. Un enfant sans Vireo reçoit une courte explication au lieu d’un token brut.
  • Les outils d’assistant décrits sur cette page, pour tous les enfants.

La page de Vireo sous les Extensions de MainWP liste chaque enfant avec la version de Vireo Analytics qu’il exécute, et un bouton Ouvrir vers sa page Vireo. Un enfant qui ne peut pas remonter ses données en donne la raison au lieu d’afficher une version :

  • pas encore synchronisé
  • Vireo Analytics n’est pas installé, ou installé mais pas actif
  • Vireo Pro n’y est pas actif
  • sa version de Vireo Analytics est trop ancienne : le widget, la page et les tokens demandent la 0.9.0 ou plus récente
  • il ne partage pas ses statistiques avec le tableau de bord
  • vous n’y avez pas accès dans MainWP
  • il n’a pas répondu

Interroger les enfants MainWP

Connectez votre assistant IA au tableau de bord MainWP. get-sites liste chaque enfant que vous voyez dans MainWP, avec des identifiants comme mainwp:12 (l’identifiant du site dans MainWP) et "source": "mainwp", et l’assistant transmet cet identifiant comme site :

Parmi mes sites MainWP, lesquels sont en baisse ce mois-ci ?

get-sites-overview récupère d’un coup les totaux de chaque enfant. Un enfant qui ne répond pas en 10 secondes, n’a pas Vireo, exécute une version de Vireo trop ancienne pour répondre ou a désactivé la remontée est listé sous unreachable avec une raison, au lieu de disparaître des chiffres sans un mot.

Un enfant ne répond que si Vireo Pro est actif et sous licence, et il répond alors à tous les outils de son propre Vireo : les rapports gratuits, et les rapports de Pro comme les campagnes, l’engagement et les revenus, puisque Pro les enregistre sur ce site.

Quels outils acceptent un site

Via MCP et l’API Abilities, ceux-ci acceptent site :

get-totals, get-daily-stats, get-hourly-stats, get-changes, get-highlights, get-top-pages, get-top-referrers, get-traffic-sources, get-referrer-detail, get-ai-referrals, get-countries, get-devices, get-events, get-event-detail, get-404s, get-bot-stats, get-vitals, get-annotations.

get-sites renvoie la même liste sous accepts_site, l’assistant n’a donc pas à deviner.

Ceux-ci répondent pour l’installation que vous appelez :

  • Les rapports propres à Pro, comme les campagnes, l’engagement, la recherche sur le site, les entonnoirs, les visiteurs en direct et les revenus, que Pro enregistre pour le site WordPress sur lequel il est installé.
  • get-post-stats et get-year-review, construits à partir des articles WordPress de ce site.
  • get-search-console et get-goals, conservés pour ce site.

Cette liste vaut pour les sites connectés. Un enfant MainWP exécute l’outil sur son propre Vireo : il répond donc pour tout ce que ce site a d’installé.

Interrogez l’un de ces outils sur un site client et vous obtenez une erreur plutôt que les chiffres de ce site présentés sous le nom du client. Un rapport Pro indique qu’il est « enregistré pour ce site WordPress uniquement » et renvoie vers les outils qui acceptent site. Les autres refusent site comme une entrée inconnue.

Quand un site ne peut pas être lu

Une requête sur un autre site est refusée, sans aucun chiffre, plutôt que satisfaite avec les données d’un autre site :

Situation Erreur Via REST
Aucun site connecté n’a cet identifiant vireo_site_unknown : « Aucun site connecté n’a l’identifiant 9. Appelez get-sites pour obtenir la liste. » 404
Un outil qui n’accepte pas site, comme l’un des rapports propres à Pro vireo_site_unsupported 400
Pro n’est pas actif avec une licence vireo_site_pro 403
L’utilisateur ne peut pas lire les chiffres de ce site vireo_site_forbidden 403

Un enfant MainWP ajoute ses propres refus. Chaque message nomme le site, par exemple mainwp:12, et dit ce qui s’est passé :

Situation Erreur Via REST
L’enfant dépasse le nombre de sites de votre formule vireo_site_over_plan 403
L’enfant n’a pas répondu, ou a répondu de façon inattendue vireo_remote_unreachable 502
Le Vireo de l’enfant est trop ancien pour répondre aux appels d’outils vireo_remote_old 501
L’enfant a refusé : son administrateur MainWP ne peut pas lire ses statistiques, ou il a désactivé la remontée vers MainWP vireo_remote_denied 403

Les outils gratuits absents de la liste par site refusent plutôt site comme une entrée inconnue (ability_invalid_input, 400). Chaque réponse, qu’elle vienne de ce site ou de celui d’un client, est aplatie avant d’atteindre l’assistant : les retours à la ligne, les caractères de contrôle et invisibles, et les crochets qui pourraient faire passer un texte pour une consigne sont retirés de tout ce qu’un visiteur a pu écrire.

Combien de sites

Les formules sont tarifées par site, et un site connecté compte pour un. Chaque installation WordPress peut connecter un site, plus un pour chaque site que votre licence n’utilise pas. Une formule 25 sites active sur le seul site de votre agence peut y accueillir 25 sites clients ; une formule illimitée, 100. get-sites indique la limit de l’installation et le nombre de sites connectés (count).

Les enfants MainWP comptent aussi. Les sites connectés utilisent la marge en premier, et les enfants prennent ce qui reste, dans l’ordre où ils ont été ajoutés à MainWP. Un enfant au-delà de la marge apparaît quand même dans get-sites, avec "over_plan": true, pour que l’assistant puisse vous le dire, mais ses chiffres restent illisibles tant que vous n’avez pas ajouté de sites à votre formule. get-sites indique aussi le nombre d’enfants trouvés dans remote_count.

Si la marge diminue plus tard, par exemple parce que vous avez activé la licence sur un autre site WordPress, les sites clients déjà connectés continuent de compter et restent lisibles, et en ajouter demande une formule supérieure.

Via REST

Les mêmes données sont accessibles aux scripts avec un mot de passe d’application :

curl -u "$VIREO_AUTH" "https://example.com/wp-json/vireo-analytics/v1/stats/sites"
curl -u "$VIREO_AUTH" "https://example.com/wp-json/vireo-analytics/v1/stats/sites-overview?start=2026-09-12&end=2026-10-11"

Pour un site client, exécutez une ability via l’API Abilities avec site dans son entrée :

curl -g -u "$VIREO_AUTH" \
  "https://example.com/wp-json/wp-abilities/v1/abilities/vireo-analytics/get-totals/run?input[site]=2"
{"pageviews":1500,"visitors":1200,"days":30,"avg_daily":50}

Les routes /stats/... du plugin gratuit, comme /stats/totals, n’acceptent pas site. Elles répondent toujours pour l’installation que vous appelez et ignorent un paramètre site.