Comment demander à Padlet MCP les statistiques d’administrateur (bêta) ?

Photo de profil de Carla SeseMis à jour il y a 16 heures par Carla Sese

Les chiffres du tableau de bord d’administration de votre école ou de votre équipe ne sont pas présentés comme vous le souhaitez ? Connectez Padlet MCP à un assistant IA et demandez-lui des statistiques sur votre école, votre salle de classe ou votre équipe en langage courant, ou appelez vous-même l’API d’analyse des organisations.

Pour consulter la référence REST complète (catalogue des métriques, formats des requêtes et codes d’erreur), consultez Lire les données analytiques de l’organisation sur docs.padlet.dev.

À qui s’adresse cet article ?

Cet article s’adresse aux personnes suivantes :

  • Propriétaires et administrateurs de comptes Padlet pour les écoles ou Équipe
  • Propriétaires et enseignants de comptes Salle de classe

Vous n’avez pas besoin d’écrire du code pour utiliser MCP. L’API est une option pour les utilisateurs avancés qui utilisent déjà l’API publique.

Ce dont vous disposez déjà

La page Statistiques de votre organisation, dans les Paramètres, affiche déjà des onglets sélectionnés pour la période de facturation en cours. Les écoles et les salles de classe disposent des onglets Vue d’ensemble, Utilisation, Impact, Sécurité, Principaux utilisateurs et Tous les utilisateurs. Les équipes disposent des onglets Général, Padlets et Utilisateurs, ou des onglets Vue d’ensemble, Utilisation, Impact, Principaux utilisateurs et Tous les utilisateurs si votre équipe utilise la nouvelle page Statistiques (bêta).

Utilisez le tableau de bord pour obtenir rapidement un aperçu visuel. Utilisez MCP ou l’API si vous avez besoin d’un découpage personnalisé auquel les onglets ne répondent pas aussi clairement.

Ce que MCP et l’API vous apportent

Le tableau de bord propose des onglets sélectionnés. MCP et l’API vous permettent de demander exactement le découpage dont vous avez besoin :

  • Des questions formulées en langage courant dans votre client IA (« Quels enseignants ont été inactifs lors de la dernière période de facturation ? »)
  • Des combinaisons personnalisées de métriques d’engagement, d’adhésion et de sécurité du contenu
  • Des séries mensuelles sur une période donnée
  • Des découpages par rôle (enseignants ou élèves, créateurs ou contributeurs)
  • Les padlets, les utilisateurs et les médias les plus populaires, classés selon vos critères
  • Des réponses que vous pouvez intégrer à une présentation pour une revue trimestrielle ou un renouvellement
Les métriques de sécurité du contenu (éléments analysés, éléments signalés, taux de détection) sont disponibles uniquement pour les écoles et les salles de classe. Si vous les demandez pour une organisation de type Équipe, une erreur sera renvoyée, et non une valeur nulle.

Démarrage rapide avec Padlet MCP

  1. Connectez Padlet MCP à votre client IA. Utilisez l’URL du serveur https://mcp.padlet.com. Vous trouverez toutes les étapes de configuration dans Serveur Padlet MCP.
  2. Connectez-vous et autorisez l’accès en tant qu’administrateur de l’organisation sur laquelle vous souhaitez effectuer des recherches. Dans une salle de classe, un enseignant peut également consulter les statistiques.
  3. Posez vos questions en langage courant. Vous n’avez pas besoin de nommer les outils internes. Indiquez à l’assistant IA ce que vous souhaitez savoir sur votre école, votre salle de classe ou votre équipe ; il utilisera Padlet MCP pour vous.

Voici un exemple :

Si votre client MCP ne fournit pas encore de réponses sur les statistiques, essayez un autre client compatible avec MCP ou utilisez plutôt l’API d’analyse des organisations. La prise en charge par les clients peut être en retard sur celle du serveur.
L’assistant agit en votre nom. Il ne peut consulter que les statistiques auxquelles votre compte connecté a accès.

Facultatif : API d’analyse des organisations

Vous préférez créer vos propres scripts ? Utilisez l’API publique avec une clé API d’administrateur (ou une clé d’enseignant pour une salle de classe).

  1. Créez ou copiez une clé API depuis la page Développeur, dans vos Paramètres. Pour en savoir plus, consultez l’article sur l’API publique.
  2. Trouvez l’identifiant de votre organisation avec GET /me?include=organizations. Vous avez besoin d’un identifiant wksp_ : les organisations org_ sur padlet.org ne sont pas encore prises en charge par ce point de terminaison.
  3. Envoyez une requête POST à /organizations/{org_id}/analytics avec les métriques souhaitées.
  4. Si la réponse est 202 ou si meta.pending n’est pas vide, attendez le délai indiqué par Retry-After, puis renvoyez la requête à l’identique. Les statistiques sont calculées de manière asynchrone : une métrique en attente est absente, et non égale à zéro. Ne considérez jamais une métrique en attente comme égale à zéro.
Vous trouverez les formats de requête complets, le catalogue des métriques et des exemples détaillés dans Lire les données analytiques de l’organisation.

Accès au programme pilote

L’accès aux statistiques de l’organisation via MCP et l’API est facultatif pendant la phase pilote. Padlet inscrit le propriétaire de l’organisation ; être simplement administrateur ne suffit pas. Tant que votre organisation n’est pas inscrite, chaque appel renvoie une erreur 404 (la même réponse que pour une organisation inconnue).

Pour le moment, seules les organisations wksp_ sont prises en charge.

Contactez l’assistance et demandez l’inscription du propriétaire de votre organisation pour accéder aux statistiques administratives.

Exemples de requêtes

Voici des exemples à copier-coller dans votre client MCP. Adaptez la formulation à votre école, votre salle de classe ou votre équipe, et vérifiez les chiffres sur la page Statistiques avant de préparer une présentation destinée à un client.

  • « Pour notre école, pendant cette période de facturation, combien d’enseignants sont actifs par rapport au nombre de licences, et quels mois ont connu une baisse ? »
  • « Quels padlets de l’organisation ont le plus de vues ? Donne-moi les 3 premiers tableaux/sandbox. »
  • « Quels membres ayant le rôle d’enseignant n’ont pas utilisé Padlet au cours des 12 derniers mois ? »
  • « Combien de membres n’ont pas le domaine de messagerie <ouremaildomain.edu> ? »
Demandez le découpage dont vous avez besoin : une série mensuelle, un filtre par rôle, les padlets les plus populaires selon le nombre de publications ou de visiteurs, ou le total des métriques de sécurité du contenu pour une école ou une salle de classe. L’assistant associera votre question aux métriques disponibles.

Ce que le tableau de bord fait toujours mieux

Utilisez la page Statistiques dans les Paramètres pour :

  • La bannière visuelle de la Vue d’ensemble, les suggestions « Principales pistes d’amélioration » et la demande de formation professionnelle en un clic
  • Le tableau Tous les utilisateurs / Utilisateurs avec recherche, filtres par rôle et téléchargement CSV en un clic
  • Les listes téléchargeables des enseignants actifs et inactifs pour la période sélectionnée, depuis l’onglet Vue d’ensemble (écoles et salles de classe)
  • Une vue qui ne nécessite pas d’inscription au programme pilote : la page Paramètres est accessible aux rôles autorisés sans activation de l’accès à l’API

MCP et l’API sont particulièrement utiles lorsque les onglets sélectionnés ne répondent pas précisément à la question que vous vous posez pour une démonstration ou une discussion de renouvellement.

Limites :

  • Limite de débit : 60 requêtes par heure et par clé API et organisation, y compris les vérifications après une réponse 202
  • Période : 24 mois maximum par requête
  • Sécurité du contenu : écoles et salles de classe uniquement — les équipes reçoivent une erreur 400 pour ces métriques
  • Nombre de membres : reflète la liste des membres actuelle, et non un instantané historique des personnes qui en faisaient partie à l’époque
  • En attente ≠ zéro : une métrique encore en cours de calcul est absente de la réponse ; ne la considérez pas comme égale à zéro
  • Type d’organisation : uniquement wksp_ pour le moment

FAQ

Pourquoi est-ce que j’obtiens une erreur 404 lorsque je demande des statistiques ?

Pendant la phase pilote du point de terminaison, toutes les erreurs d’accès renvoient la même réponse : absence d’inscription, organisation inconnue ou absence d’accès donnent toutes une erreur 404. Vérifiez que vous êtes connecté en tant qu’administrateur (ou enseignant dans une salle de classe), que votre organisation est de type wksp_ et que Padlet a inscrit le propriétaire de l’organisation. Contactez l’assistance pour demander l’inscription.

Dois-je écrire du code ?

Non. Connectez Padlet MCP, connectez-vous en tant qu’administrateur et posez vos questions en langage courant. L’API est une option destinée aux développeurs et aux utilisateurs avancés qui utilisent déjà l’API publique.

S’agit-il de la même chose que l’API publique ?

Les deux sont liés, mais il s’agit de produits différents. L’API publique s’adresse aux développeurs qui utilisent une clé API. Padlet MCP est destiné aux assistants IA auxquels vous donnez accès en vous connectant. Les deux permettent d’accéder aux statistiques de l’organisation une fois celle-ci inscrite ; vous pouvez utiliser l’un ou l’autre, ou les deux.

Les élèves ou les personnes qui ne sont pas administratrices peuvent-ils consulter les statistiques de l’organisation de cette manière ?

Non. Pour consulter les statistiques, il faut être administrateur de l’organisation ou enseignant dans une salle de classe. L’assistant dispose exactement des mêmes accès que le compte avec lequel vous vous êtes connecté, et d’aucun autre.

Mon client MCP ne semble pas connaître les statistiques. Que puis-je essayer ?

Certains clients mettent du temps à actualiser leur liste d’outils. Essayez de reconnecter Padlet MCP, de passer à un autre client compatible avec MCP ou d’utiliser directement l’API d’analyse des organisations. Si vous ne parvenez toujours pas à y accéder après l’inscription, contactez-nous.

Articles associés

Cet article vous a-t-il été utile ?

Articles connexes