Comment demander à Padlet MCP les analyses de l’administrateur ?

Carla Sese 的個人檔案照片由 Carla Sese 於 il y a 4 jours 更新

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

Pour consulter la référence REST complète (catalogue des métriques, formats des requêtes et codes d’erreur), reportez-vous à Consulter les analyses 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 les équipes
  • Propriétaires et enseignants de comptes Classroom

Vous n’avez pas besoin d’écrire du code pour utiliser la méthode 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 Analyses 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é, Meilleurs utilisateurs et Tous les utilisateurs. Les équipes disposent des onglets Général, Padlets et Utilisateurs, ou des onglets Vue d’ensemble, Utilisation, Impact, Meilleurs utilisateurs et Tous les utilisateurs si votre équipe bénéficie de la nouvelle page Analyses (bêta).

Utilisez le tableau de bord pour obtenir rapidement un aperçu visuel. Utilisez MCP ou l’API lorsque vous avez besoin d’une ventilation personnalisée à laquelle les onglets ne répondent pas précisément.

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 précisément la ventilation dont vous avez besoin :

  • Des questions en langage naturel dans votre client IA (« Quels enseignants ont été inactifs pendant la dernière période de facturation ? »)
  • Des combinaisons personnalisées de métriques d’engagement, d’effectifs et de sécurité du contenu
  • Des séries mensuelles sur une période donnée
  • Des ventilations par rôle (enseignants ou élèves, créateurs ou contributeurs)
  • Les padlets, utilisateurs et médias les plus populaires, classés selon vos critères
  • Des réponses que vous pouvez intégrer à une présentation de revue trimestrielle ou de 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 d’équipe, une erreur sera renvoyée, et non une valeur égale à zéro.

Démarrage rapide avec Padlet MCP

  1. Connectez Padlet MCP dans 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 lancer des requêtes. Dans Classroom, un enseignant peut également consulter les analyses.
  3. Posez votre question en langage naturel. Il n’est pas nécessaire 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 un client MCP donné n’affiche pas encore les réponses aux questions d’analyse, essayez un autre client compatible avec MCP ou utilisez plutôt l’API d’analyse de l’organisation. La prise en charge par les clients peut être en retard sur celle du serveur.
Votre assistant agit en votre nom. Il ne peut consulter que les analyses auxquelles votre compte connecté a accès.

Facultatif : API d’analyse de l’organisation

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

  1. Créez ou copiez une clé API depuis la page Développeur dans vos paramètres. Consultez l’article sur l’API publique pour en savoir plus.
  2. Trouvez l’identifiant de votre organisation avec GET /me?include=organizations. Il vous faut 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 exactement la même requête. Les analyses sont calculées en arrière-plan : toute métrique en attente est absente de la réponse. Ne la considérez jamais comme égale à zéro.
Vous trouverez les formats de requête complets, le catalogue des métriques et des exemples détaillés dans Consulter les analyses de l’organisation.

Qui peut l’utiliser ?

Les analyses de l’organisation via Padlet MCP et l’API sont accessibles aux propriétaires et aux administrateurs des comptes Padlet pour les écoles et les équipes, ainsi qu’aux propriétaires et aux enseignants des comptes Classroom. Vous n’avez pas besoin de demander à Padlet d’activer cette fonctionnalité.

Seules les organisations wksp_ sont prises en charge pour le moment.

Exemples de requêtes

Voici des exemples que vous pouvez copier dans votre client MCP. Adaptez leur formulation à votre école, votre salle de classe ou votre équipe, et vérifiez les chiffres sur la page Analyses lorsque vous préparez une présentation destinée à un client.

  • « Pour notre école, sur cette période de facturation, combien y a-t-il d’enseignants actifs par rapport au nombre de licences, et quels mois ont connu une baisse ? »
  • « Quels padlets de notre 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 la ventilation 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 les totaux 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

Privilégiez la page Analyses dans les paramètres si vous souhaitez :

  • La bannière visuelle Vue d’ensemble, les suggestions « Meilleures opportunités » et une 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
  • Des listes téléchargeables d’enseignants actifs et inactifs pour la période sélectionnée, depuis l’onglet Vue d’ensemble (écoles et salles de classe)

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 devez poser lors d’une démonstration ou d’un échange sur un renouvellement.

Limites :

  • Limite de débit : 60 requêtes par heure et par clé API et organisation, y compris les interrogations après une réponse 202
  • Période : 24 mois maximum par requête
  • Sécurité du contenu : écoles et salles de classe uniquement. Pour ces métriques, les équipes reçoivent une réponse 400
  • Nombre de membres : reflète la liste des membres actuelle, et non un instantané historique des membres à une date donnée
  • 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 analyses ?

Tous les refus se présentent de la même façon : une organisation inconnue ou l’absence d’accès renvoie une réponse 404. Vérifiez que vous êtes connecté en tant qu’administrateur (ou enseignant dans Classroom) de cette organisation et qu’il s’agit d’une organisation wksp_. Vous avez toujours un problème ? Contactez l’assistance.

Dois-je écrire du code ?

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

Est-ce la même chose que l’API publique ?

Les deux sont liées, mais il s’agit de fonctionnalités distinctes. L’API publique est destinée aux développeurs qui utilisent une clé API. Padlet MCP est conçu pour les assistants IA auxquels vous accordez l’accès en vous connectant. Les deux permettent d’accéder aux analyses de l’organisation, et 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 analyses de l’organisation de cette façon ?

Non. Pour consulter les analyses, il faut être administrateur de l’organisation ou enseignant dans Classroom. L’assistant dispose exactement des mêmes accès que le compte utilisé pour vous connecter, et rien de plus.

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

Certains clients mettent leur liste d’outils à jour avec un certain délai. Essayez de reconnecter Padlet MCP, de passer à un autre client compatible avec MCP ou d’utiliser directement l’API d’analyse de l’organisation. Si le problème persiste, contactez-nous.

Articles associés

這篇文章有幫助嗎?

相關文章