¿Cómo puedo solicitar a Padlet MCP las analíticas de administrador (beta)?

Foto de perfil de Carla SeseActualizado hace 16 horas por Carla Sese

¿Los números del panel de administración de la escuela o el Equipo no se desglosan como quieres? Conecta Padlet MCP a un asistente de IA y pídele análisis de la escuela, la clase o el Equipo en lenguaje natural, o usa directamente la API de análisis de organizaciones.

Para consultar la referencia REST completa (catálogo de métricas, estructuras de solicitudes y códigos de error), consulta Leer análisis de organizaciones en docs.padlet.dev.

Para quién es

Este artículo es para:

  • Propietarios y administradores de cuentas de Padlet for Schools o de Equipo
  • Propietarios y docentes de cuentas de clase

No necesitas escribir código para usar la opción de MCP. La opción de API es opcional y está pensada para usuarios avanzados que ya trabajan con la API pública.

Lo que ya tienes

La página de Análisis de tu organización en Configuración ya muestra pestañas seleccionadas para el periodo de facturación actual. Las escuelas y las clases tienen las pestañas Resumen, Uso, Impacto, Seguridad, Usuarios principales y Todos los usuarios. Los Equipos tienen las pestañas General, Padlets y Usuarios, o Resumen, Uso, Impacto, Usuarios principales y Todos los usuarios si tu Equipo tiene la nueva página de Análisis (beta).

Usa el panel principal cuando quieras un resumen visual rápido. Usa MCP o la API cuando necesites un desglose personalizado que las pestañas no respondan con tanta claridad.

Qué aportan MCP y la API

El panel principal ofrece pestañas seleccionadas. MCP y la API te permiten solicitar exactamente el desglose que necesitas:

  • Preguntas en lenguaje natural en tu cliente de IA («¿Qué docentes estuvieron inactivos durante el último periodo de facturación?»)
  • Combinaciones personalizadas de métricas de participación, membresía y seguridad del contenido
  • Series mensuales para un intervalo de fechas
  • Desgloses por rol (docentes frente a estudiantes, creadores frente a colaboradores)
  • Padlets, usuarios y archivos multimedia principales, clasificados según lo que pidas
  • Respuestas que puedes copiar en una presentación para una QBR o una renovación
Las métricas de seguridad del contenido (elementos analizados, elementos marcados, tasa de detección) solo están disponibles para escuelas y clases. Si las solicitas para una organización de Equipo, recibirás un error, no un cero.

Inicio rápido con Padlet MCP

  1. Conecta Padlet MCP en tu cliente de IA. Usa la URL del servidor https://mcp.padlet.com. Encontrarás las instrucciones completas de configuración en Servidor de Padlet MCP.
  2. Inicia sesión y autoriza el acceso como administrador de la organización que quieres consultar. En una clase, los docentes también pueden consultar los análisis.
  3. Haz preguntas en lenguaje natural. No necesitas mencionar herramientas internas. Dile al asistente de IA qué quieres saber sobre tu escuela, clase o Equipo, y usará Padlet MCP en tu nombre.

Aquí tienes un ejemplo:

Si un cliente de MCP en particular todavía no muestra respuestas de análisis, prueba con otro cliente compatible con MCP o usa la API de análisis de organizaciones. La compatibilidad de los clientes puede tardar en actualizarse con respecto al servidor.
El asistente actúa en tu nombre. Solo puede consultar los análisis que tu cuenta, con la que has iniciado sesión, tiene permiso para ver.

Opcional: API de análisis de organizaciones

¿Prefieres crear tus propios scripts? Usa la API pública con una clave de API de administrador (o una clave de docente en una clase).

  1. Crea o copia una clave de API desde la página Developer en Configuración. Encontrarás los detalles en el artículo sobre la API pública.
  2. Busca el ID de tu organización con GET /me?include=organizations. Necesitas un ID wksp_: las organizaciones org_ de padlet.org aún no son compatibles con este endpoint.
  3. Envía una solicitud POST a /organizations/{org_id}/analytics con las métricas que quieras.
  4. Si la respuesta es 202 o meta.pending no está vacío, espera el tiempo indicado en Retry-After y vuelve a enviar la solicitud idéntica. Los análisis se calculan de forma asíncrona: una métrica pendiente no aparece en la respuesta, no equivale a cero. Nunca interpretes una métrica pendiente como cero.
Encontrarás las estructuras completas de las solicitudes, el catálogo de métricas y ejemplos prácticos en Leer análisis de organizaciones.

Acceso piloto

El acceso a los análisis de organizaciones mediante MCP y la API requiere inscripción voluntaria durante el piloto. Padlet inscribe al propietario de la organización; ser administrador no basta. Hasta que tu organización esté inscrita, todas las llamadas devolverán 404 (la misma respuesta que para una organización desconocida).

Por ahora, solo se admiten organizaciones wksp_.

Comunícate con el equipo de soporte y pide que inscriban al propietario de tu organización para acceder a los análisis de administrador.

Ejemplos de indicaciones

Puedes copiar estos ejemplos en tu cliente de MCP. Adapta la redacción a tu escuela, clase o Equipo, y comprueba las cifras en la página de Análisis cuando prepares una presentación para clientes.

  • «Para nuestra escuela, durante este periodo de facturación, ¿cuántos docentes estuvieron activos en comparación con las licencias y en qué meses bajaron las cifras?»
  • «¿Qué padlets de la organización tienen más visualizaciones? Dame los 3 primeros entre tableros y sandbox».
  • «¿Qué miembros con el rol de docente no han usado Padlet en los últimos 12 meses?»
  • «¿Cuántos miembros no tienen el dominio de correo electrónico <ouremaildomain.edu>?»
Pide el desglose que necesites: una serie mensual, un filtro por rol, los padlets principales según las publicaciones o las visitas, o el total de métricas de seguridad del contenido para una escuela o clase. El asistente relacionará tu pregunta con las métricas disponibles.

En qué sigue siendo mejor el panel principal

Usa la página de Análisis en Configuración cuando quieras:

  • El banner visual de Resumen, los avisos de Mejores oportunidades y la opción de solicitar desarrollo profesional con un solo clic
  • La tabla Todos los usuarios / Usuarios, con búsqueda, filtros por rol y descarga de CSV con un solo clic
  • Listas descargables de docentes activos e inactivos para el periodo seleccionado, desde la pestaña Resumen (escuelas y clases)
  • Una vista que no requiera inscripción en el piloto: los roles que cumplen los requisitos pueden acceder a la propia página de Configuración sin optar por la API

MCP y la API son ideales cuando las pestañas seleccionadas no responden a la pregunta exacta que necesitas para una demostración o una conversación sobre renovación.

Limitaciones:

  • Límite de solicitudes: 60 solicitudes por hora por clave de API y organización, incluidas las consultas posteriores a una respuesta 202
  • Intervalo de fechas: como máximo 24 meses por solicitud
  • Seguridad del contenido: solo para escuelas y clases; los Equipos reciben un error 400 al solicitar esas métricas
  • Recuentos de miembros: reflejan la lista de miembros actual, no una instantánea histórica de quiénes pertenecían a la organización en ese momento
  • Pendiente ≠ cero: las métricas que aún se están calculando no aparecen en la respuesta; no las interpretes como cero
  • Tipo de organización: por ahora, solo wksp_

Preguntas frecuentes

¿Por qué recibo un error 404 al solicitar análisis?

Mientras el endpoint esté en fase piloto, todas las denegaciones devuelven la misma respuesta: tanto si la organización no está inscrita o se desconoce como si no tienes acceso, recibirás 404. Confirma que iniciaste sesión como administrador (o docente en una clase), que tu organización es del tipo wksp_ y que Padlet inscribió al propietario de la organización. Comunícate con el equipo de soporte para solicitar la inscripción.

¿Necesito escribir código?

No. Conecta Padlet MCP, inicia sesión como administrador y haz preguntas en lenguaje natural. La opción de API es opcional y está pensada para desarrolladores y usuarios avanzados que ya usan la API pública.

¿Es lo mismo que la API pública?

Están relacionadas, pero no son el mismo producto. La API pública está dirigida a desarrolladores que usan una clave de API. Padlet MCP está pensado para asistentes de IA a los que autorizas al iniciar sesión. Ambos pueden acceder a los análisis de organizaciones una vez que tu organización esté inscrita; puedes usar uno o ambos.

¿Pueden consultar los análisis de organizaciones los estudiantes o quienes no sean administradores?

No. Para consultar los análisis, se requiere ser administrador de la organización o docente en una clase. El asistente tiene exactamente el mismo acceso que la cuenta con la que iniciaste sesión, ni más ni menos.

Mi cliente de MCP no parece conocer la función de análisis. ¿Qué puedo probar?

Algunos clientes tardan en actualizar su lista de herramientas. Prueba a volver a conectar Padlet MCP, cambiar a otro cliente compatible con MCP o usar directamente la API de análisis de organizaciones. Si sigues sin poder acceder después de la inscripción, comunícate con nosotros.

Artículos relacionados

¿Te resultó útil este artículo?

Artículos relacionados

Acceder a la página de diagnóstico

Solucione los problemas de Padlet utilizando las herramientas de diagnóstico disponibles en la web o en el móvil y, si es necesario, póngase en contacto con el servicio de asistencia con los resultados.

¿Cómo restablezco mi ID de Apple?

Restablece tu ID de Apple para Padlet eliminándolo de la configuración de tu ID de Apple e iniciando sesión de nuevo.

Quiero trabajar en Padlet. ¿Dónde debo presentar mi solicitud?

Explora las oportunidades profesionales en Padlet y envía tu solicitud para los puestos disponibles en padlet.jobs.

¿Qué ocurre con tus datos cuando se elimina una cuenta?

Entiende qué ocurre cuando eliminas tu cuenta de Padlet y cómo restaurarla en un plazo de 14 días.