Hoe vraag ik Admin Analytics (Beta) aan bij Padlet MCP?

Η φωτογραφία προφίλ του/της Carla SeseΕνημερώθηκε 13 uur geleden από Carla Sese

Heb je nummers nodig die het Admin Dashboard van de school of het Team niet op de gewenste manier uitsplitst? Koppel Padlet MCP aan een AI-assistent en vraag in gewone taal om analyses van je school, klaslokaal of Team — of roep zelf de API voor organisatieanalyses aan.

Zie voor de volledige REST-referentie (catalogus met statistieken, aanvraagstructuren en foutcodes) Organisatieanalyses lezen op docs.padlet.dev.

Voor wie is dit bedoeld?

Dit artikel is bedoeld voor:

  • Eigenaren en beheerders van Padlet for Schools- of Team-accounts
  • Eigenaren en leerkrachten van Classroom-accounts

Je hoeft geen code te schrijven om MCP te gebruiken. De API is optioneel voor ervaren gebruikers die al met de Public API werken.

Wat je al hebt

De pagina Analytics van je organisatie in Instellingen toont al samengestelde tabbladen voor de huidige factureringsperiode. Scholen en klaslokalen hebben de tabbladen Overzicht, Gebruik, Impact, Veiligheid, Topgebruikers en Alle gebruikers. Teams hebben Algemeen, Padlets en Gebruikers.

Gebruik het dashboard voor een snel visueel overzicht. Gebruik MCP of de API als je een aangepaste uitsplitsing nodig hebt die de tabbladen niet goed beantwoorden.

Wat MCP / API toevoegt

Het dashboard bevat samengestelde tabbladen. Met MCP en de API kun je precies de uitsplitsing opvragen die je nodig hebt:

  • Vragen in gewone taal aan je AI-client ("welke leerkrachten waren de afgelopen factureringsperiode inactief?")
  • Aangepaste combinaties van betrokkenheids-, lidmaatschaps- en inhoudsveiligheidsstatistieken
  • Maandelijkse reeksen over een datumbereik
  • Uitsplitsingen naar rol (leerkrachten versus leerlingen, makers versus bijdragers)
  • Top-padletten, topgebruikers en populairste media, gerangschikt zoals jij dat vraagt
  • Antwoorden die je in een QBR- of verlengingspresentatie kunt plakken
Statistieken over inhoudsveiligheid (gescande items, gemarkeerde items, detectiepercentage) zijn alleen beschikbaar voor scholen en klaslokalen. Als je ernaar vraagt voor een Team-organisatie, krijg je een foutmelding en geen nul.

Snel aan de slag met Padlet MCP

  1. Koppel Padlet MCP aan je AI-client. Gebruik de server-URL https://mcp.padlet.com. Volledige configuratiestappen vind je in Padlet MCP Server.
  2. Meld je aan en geef toestemming als beheerder van de organisatie waarover je gegevens wilt opvragen. In een Classroom kan ook een leerkracht analyses ophalen.
  3. Stel je vraag in gewone taal. Je hoeft geen interne tools te benoemen. Vertel de AI-assistent wat je over je school, klaslokaal of Team wilt weten. De assistent gebruikt dan Padlet MCP namens jou.

Hier is een voorbeeld:

Als een bepaalde MCP-client nog geen antwoorden over analyses geeft, probeer dan een andere MCP-compatibele client of gebruik in plaats daarvan de API voor organisatieanalyses. Ondersteuning door clients kan achterlopen op die van de server.
Je assistent handelt namens jou. De assistent kan alleen analyses ophalen die je aangemelde account mag bekijken.

Optioneel: API voor organisatieanalyses

Doe je het liever zelf met scripts? Gebruik dan de Public API met een API-sleutel van een beheerder (of een leerkracht in een Classroom).

  1. Maak een API-sleutel aan of kopieer er een vanaf de pagina Developer in Instellingen. Meer informatie vind je in het artikel Public API.
  2. Zoek je organisatie-ID op met GET /me?include=organizations. Je hebt een wksp_-ID nodig — organisaties met een org_-ID op padlet.org worden voor dit eindpunt nog niet ondersteund.
  3. Stuur een POST-aanvraag naar /organizations/{org_id}/analytics met de gewenste statistieken.
  4. Als het antwoord 202 is of meta.pending niet leeg is, wacht dan de opgegeven tijd in Retry-After af en stuur dezelfde aanvraag opnieuw. Analyses worden asynchroon berekend — een statistiek die nog in behandeling is, ontbreekt; de waarde is niet nul. Behandel een statistiek die nog in behandeling is nooit als nul.
De volledige aanvraagstructuren, de catalogus met statistieken en uitgewerkte voorbeelden vind je in Organisatieanalyses lezen.

Toegang tijdens de pilot

Toegang tot organisatieanalyses via MCP en de API is tijdens de pilot opt-in. Padlet schrijft de eigenaar van de organisatie in — alleen beheerder zijn is niet voldoende. Totdat je organisatie is ingeschreven, geeft elke aanroep een 404-antwoord (hetzelfde antwoord als voor een onbekende organisatie).

Voorlopig worden alleen organisaties met een wksp_-ID ondersteund.

Neem contact op met support en vraag of ze de eigenaar van je organisatie willen inschrijven voor analyses voor beheerders.

Voorbeeldprompts

Dit zijn voorbeelden die je in je MCP-client kunt plakken. Pas de formulering aan je school, klaslokaal of Team aan — en controleer de cijfers op de pagina Analytics wanneer je een presentatie voor klanten voorbereidt.

  • "Hoeveel leerkrachten waren deze factureringsperiode actief op onze school, vergeleken met het aantal licenties, en in welke maanden daalde het aantal?"
  • "Welke padlets binnen onze organisatie hebben de meeste weergaven? Geef me de top 3-borden/sandbox."
  • "Welke leden met de rol leerkracht hebben Padlet de afgelopen 12 maanden niet gebruikt?"
  • "Hoeveel leden hebben geen e-maildomein <ouremaildomain.edu>?"
Vraag om de uitsplitsing die je nodig hebt: een maandelijkse reeks, een rolfilter, de populairste padlets op basis van berichten of bezoekers, of totalen voor inhoudsveiligheid van een school of klaslokaal. De assistent koppelt je vraag aan de beschikbare statistieken.

Waar het dashboard nog steeds beter in is

Gebruik de pagina Analytics in Instellingen als je het volgende nodig hebt:

  • De visuele banner Overzicht, uitgelichte kansen en een verzoek voor professionele ontwikkeling met één klik
  • De tabel Alle gebruikers / Gebruikers met zoekfunctie, rolfilters en een CSV-download met één klik
  • Downloadbare lijsten met actieve en inactieve leerkrachten voor de geselecteerde periode, via het tabblad Overzicht (scholen en klaslokalen)
  • Een overzicht waarvoor geen deelname aan de pilot nodig is — de pagina Instellingen zelf is beschikbaar voor bevoegde rollen, zonder dat je je voor de API hoeft aan te melden

MCP en de API komen goed van pas wanneer de samengestelde tabbladen geen antwoord geven op de specifieke vraag die je voor een demo of verlengingsgesprek hebt.

Beperkingen:

  • Verzoeklimiet: 60 verzoeken per uur per API-sleutel en organisatie, inclusief peilingen na een 202
  • Datumbereik: maximaal 24 maanden per verzoek
  • Inhoudsveiligheid: alleen voor scholen en klaslokalen — Teams krijgen voor deze statistieken een 400
  • Leden tellen: de aantallen zijn gebaseerd op de huidige ledenlijst, niet op een historische momentopname van wie er op dat moment lid was
  • In behandeling ≠ nul: een statistiek die nog wordt berekend, ontbreekt in het antwoord; behandel die niet als nul
  • Organisatietype: voorlopig alleen wksp_

Veelgestelde vragen

Waarom krijg ik een 404 wanneer ik om analyses vraag?

Terwijl het eindpunt in de pilotfase zit, zien alle weigeringen er hetzelfde uit: niet ingeschreven, onbekende organisatie of geen toegang geeft allemaal een 404. Controleer of je bent aangemeld als beheerder (of leerkracht in een Classroom), of je organisatie een wksp_-organisatie is en of Padlet de eigenaar van de organisatie heeft ingeschreven. Neem contact op met support om inschrijving aan te vragen.

Moet ik code schrijven?

Nee. Koppel Padlet MCP, meld je aan als beheerder en stel je vraag in gewone taal. De API is optioneel voor ontwikkelaars en ervaren gebruikers die de Public API al gebruiken.

Is dit hetzelfde als de Public API?

Ze zijn verwant, maar het zijn geen identieke producten. De Public API is bedoeld voor ontwikkelaars die een API-sleutel gebruiken. Padlet MCP is bedoeld voor AI-assistenten waarvoor je toestemming geeft door je aan te melden. Zodra je organisatie is ingeschreven, kunnen beide organisatieanalyses ophalen; je kunt een van beide of allebei gebruiken.

Kunnen leerlingen of niet-beheerders op deze manier organisatieanalyses bekijken?

Nee. Voor analyses moet je beheerder van de organisatie zijn of leerkracht in een Classroom. De assistent heeft precies dezelfde toegang als het account waarmee je bent aangemeld — niet meer.

Mijn MCP-client lijkt niets van analyses te weten. Wat kan ik proberen?

Sommige clients werken hun lijst met tools met vertraging bij. Probeer Padlet MCP opnieuw te koppelen, over te schakelen naar een andere MCP-compatibele client of de API voor organisatieanalyses rechtstreeks te gebruiken. Als je na inschrijving nog steeds geen toegang hebt, neem dan contact met ons op.

Gerelateerde artikelen

Ήταν αυτό το άρθρο χρήσιμο;

Σχετικά άρθρα

Ga naar de diagnosepagina

Los problemen met Padlet op met behulp van diagnostische tools op het web of mobiel, en neem indien nodig contact op met de ondersteuning met de resultaten.

Hoe reset ik mijn Apple ID?

Reset je Apple ID voor Padlet door deze te verwijderen uit je Apple ID-instellingen en opnieuw in te loggen.

Docentenhandleiding: Tips om het schooljaar af te sluiten

Bereid je Padlet-account voor op het volgende schooljaar door padlets en leden te exporteren, ordenen en opschonen.

Ik wil bij Padlet werken. Waar kan ik solliciteren?

Ontdek carrièremogelijkheden bij Padlet en solliciteer op beschikbare functies op padlet.jobs.