Como posso pedir ao Padlet MCP o acesso ao Admin Analytics (Beta)?

Precisa de dados que o Painel de Administração da escola ou da equipa não apresenta da forma que deseja? Ligue o Padlet MCP a um assistente de IA e solicite análises da escola, da sala de aula ou da equipa em linguagem simples — ou aceda você mesmo à API de análises da organização.

A quem se destina

Este artigo destina-se a:

• Proprietários e administradores de contas do Padlet for Schools ou Team
• Proprietários e professores de contas do Classroom

Não é necessário escrever código para utilizar o caminho MCP. Este caminho da API é opcional para utilizadores avançados que já trabalham com a API Pública.

O que já tem

A página «Análises» da sua organização, em «Definições», já apresenta separadores selecionados para o período de faturação atual. As escolas e as salas de aula têm acesso a «Visão geral», «Utilização», «Impacto», «Segurança», «Principais utilizadores» e «Todos os utilizadores». As equipas têm acesso a «Geral», «Padlets» e «Utilizadores».

• Análise de contas escolares (Padlet for Schools e Classroom)
• Análises da conta de equipa

Utilize o painel de controlo quando pretender uma visão geral rápida. Utilize o MCP ou a API quando precisar de uma análise personalizada que as separadores não consigam apresentar de forma tão clara.

O que o MCP / API acrescenta

O painel de controlo consiste em separadores selecionados. O MCP e a API permitem-lhe solicitar exatamente a informação de que necessita:

• Perguntas em linguagem simples no seu cliente de IA («quais foram os professores inativos no último período de faturação?»)
• Combinações personalizadas de métricas de envolvimento, adesão e segurança de conteúdos
• Séries mensais ao longo de um intervalo de datas
• Segmentos por função (professores vs. alunos, criadores vs. colaboradores)
• Padlets, utilizadores e conteúdos multimédia mais populares, classificados de acordo com a sua solicitação
• Respostas que pode colar num relatório de desempenho trimestral (QBR) ou numa apresentação de renovação

Introdução rápida ao Padlet MCP

1. Ligue o Padlet MCP no seu cliente de IA. Utilize o URL do servidor https://mcp.padlet.com. Os passos completos de configuração encontram-se no Padlet MCP Server.
2. Inicie sessão e autorize-se como administrador da organização que pretende consultar. Numa sala de aula, um professor também pode aceder às análises.
3. Faça a sua pergunta em linguagem simples. Não precisa de mencionar o nome de ferramentas internas. Diga ao assistente de IA o que pretende saber sobre a sua escola, sala de aula ou equipa, e este utilizará o Padlet MCP em seu nome.

Eis um exemplo:

Opcional: API de análise da organização

Prefere criar o seu próprio script? Utilize a API pública com uma chave de API de administrador (ou uma chave de professor no Classroom).

1. Cria ou copia uma chave de API a partir da página «Desenvolvedor» nas tuas «Definições». Encontras mais detalhes no artigo sobre a API pública.
2. Encontre o ID da sua organização com GET /me?include=organizations. Precisas de um wksp_ ID — org_ as organizações no padlet.org ainda não são suportadas para este ponto de extremidade.
3. Envie um POST para /organizations/{org_id}/analytics com as métricas que deseja.
4. Se a resposta for 202 ou meta.pending não estiver vazia, aguarde Retry-After e enviar novamente o pedido idêntico. As análises são calculadas de forma assíncrona — uma métrica pendente está ausente, não é zero. Nunca considere «pendente» como zero.

Acesso à fase piloto

Exemplos de comandos

Estas são sugestões iniciais que pode colar no seu cliente MCP. Adapte o texto à sua escola, sala de aula ou equipa — e verifique os números na página de Análises quando estiver a preparar uma apresentação para os clientes.

• «Para a nossa escola, neste período de faturação, quantos professores ativos existem em comparação com as licenças, e em que meses se registou uma queda?»
• «Quais são os Padlets da organização com mais visualizações? Indique-me os 3 painéis/sandbox mais populares.»
• «Quais são os membros com a função de professor que não utilizaram o Padlet nos últimos 12 meses?»
• «Quantos membros não têm o domínio de e-mail <ouremaildomain.edu>?»

O que o painel de controlo ainda faz melhor

Recorra à página «Análises» em «Definições» sempre que quiser:

• O banner visual de Visão Geral, as menções às principais oportunidades e o pedido de formação profissional com um clique
• A tabela «Todos os utilizadores / Utilizadores» com pesquisa, filtros por função e download de CSV com um clique
• Listas descarregáveis de professores ativos e inativos para o período selecionado, a partir do separador «Visão geral» (escolas e salas de aula)
• Uma visualização que não requer inscrição no programa piloto — a própria página «Definições» está disponível para funções elegíveis sem necessidade de ativação da API

O MCP e a API destacam-se quando as separadores selecionadas não respondem exatamente à pergunta de que necessita para uma demonstração ou conversa sobre renovação.

Limitações:

• Limite de requisições: 60 por hora por chave de API e organização, incluindo consultas após um 202
• Intervalo de datas: no máximo 24 meses numa única solicitação
• Segurança de conteúdo: apenas para escolas e salas de aula — o Teams obtém um 400 para essas métricas
• Números de membros: refletem a lista atual, não um instantâneo histórico de quem pertencia à organização na altura
• Pendente ≠ zero: uma métrica ainda a ser calculada está em falta na resposta; não a trate como zero
• Tipo de organização: wksp_ apenas por enquanto

Perguntas frequentes

Relacionado

• Servidor do Padlet MCP
• Análises da conta escolar
• Análises da conta de equipa
• API pública
• Ler análises da organização (documentação para programadores)