Upvote
O módulo de espaço Upvote, do separador Comunidade. Um quadro em que os membros propõem tópicos, votam (um voto por pessoa, que pode ser retirado) e comentam, e a equipa aprova, muda o estado, junta duplicados, arquiva com motivo e reabre. Ordenações, filtros, colunas, leitura pública, limites, avisos por e-mail, e as mesmas ações pelo assistente e pela API.
O Upvote é um quadro em que os membros dizem o que querem: cada pessoa propõe tópicos (uma ideia, um pedido, uma melhoria), todos votam nos que apoiam, e os mais votados sobem. A equipa responde mudando o estado de cada tópico (Planeado, Em curso, Concluído ou Arquivado, com o motivo), e quem votou é avisado.
É um módulo de espaço do separador Comunidade de Adicionar Espaço. Um espaço é um quadro: para ter quadros separados (produto, eventos, conteúdo), crie vários espaços. Quem cria o espaço: proprietário ou administrador.
Upvote, Sondagem ou Inquérito?
| Sondagem | Inquérito | Upvote | |
|---|---|---|---|
| Quem pergunta | A equipa | A equipa | Os membros propõem |
| Opções | Fixas, escritas pela equipa | Questionário em secções | Lista aberta, que cresce todos os dias |
| Onde vive | Numa publicação do Feed ou do Conteúdo | Espaço próprio e ligação pública | Espaço próprio |
| Voto | Escolhe opção; só a equipa vê quem votou em quê | Resposta identificada ou anónima | Um voto por tópico, em quantos tópicos quiser; pode ser retirado |
| Fim | Encerra num prazo | Período, com resultado e NPS | Nunca encerra; cada tópico tem o seu desfecho |
| Para quê | Decidir entre poucas opções agora | Medir satisfação e clima | Descobrir o que a comunidade quer e mostrar o que foi feito |
A regra prática: a equipa quer saber entre A, B ou C → Sondagem; quer medir → Inquérito; quer que os membros digam o que querem e mostrar o que fez com isso → Upvote.
Quem pode o quê
| Ação | Quem |
|---|---|
| Ler o quadro, os tópicos e os comentários | Quem abre o espaço; num espaço público, também o visitante sem sessão iniciada |
| Votar, retirar o voto e comentar | Quem abre o espaço, com sessão iniciada |
| Propor um tópico | Quem o Quem pode publicar do espaço permite |
| Editar e apagar o próprio tópico | O autor, até outra pessoa votar nele |
| Aprovar, editar, mudar o estado, juntar, arquivar, reabrir, ver quem votou e apagar | A equipa: proprietário, administrador e moderador. O financeiro não entra |
| Ligar a aprovação prévia | Proprietário e administrador |
Como funciona
O quadro
Cada tópico aparece num cartão com o botão de voto à esquerda (a seta e o número, preenchido quando votou), o título, um excerto da descrição, o autor, os comentários e o selo do estado.
- Ordenar por: Mais votados (o padrão; em caso de empate, o mais recente), Novos e Em alta (os mais votados nos últimos 7 dias, atualizado de hora em hora).
- Filtros: Todos (todos menos os arquivados), Abertos, Planeados, Em curso, Concluídos, Arquivados, Meus tópicos e Votei.
- Visualização: Lista ou Colunas (Aberto, Planeado, Em curso e Concluído, cada uma pelos mais votados). No telemóvel, as colunas passam a separadores por estado, um de cada vez.
A lista tem uma única linha com os estados e menus compactos, Ordenar e Filtro (incluindo Todos os tópicos), e as colunas não repetem o estado em cada cartão. No tópico, a barra mantém Editar e Mudar estado, e o resto fica em Mais ações.
O voto
Cada pessoa tem um voto por tópico e vota em quantos tópicos quiser. Clicar outra vez retira o voto. Quem propõe já começa a votar no próprio tópico (e pode retirar).
Todos veem a contagem; quem votou, só a equipa vê, em Quem votou, com a data em que cada pessoa entrou na comunidade (ajuda a perceber contas duplicadas).
Votar e retirar o voto só valem em tópicos Abertos, Planeados ou Em curso. Em Concluído e Arquivado, a votação congela: não é possível votar nem retirar o voto.
Os estados
| Estado | O que quer dizer | Voto | Comentário |
|---|---|---|---|
| Aberto | A receber votos | Sim | Sim |
| Planeado | A equipa vai fazer | Sim | Sim |
| Em curso | A equipa está a fazer | Sim | Sim |
| Concluído | Pronto | Congelado | Sim |
| Arquivado | Não vai avançar, com o motivo à vista de todos | Congelado | Não |
Só a equipa muda o estado. Cada mudança aceita uma Nota para quem votou ("saiu na versão de março"); arquivar exige o Motivo. Reabrir leva um tópico Concluído ou Arquivado de volta a Aberto. Os votos ficam sempre.
Já existe algo parecido?
Ao propor, a partir da terceira palavra do título aparecem até 5 tópicos do mesmo quadro que partilham palavras com ele, em Já existe algo parecido?. Se um deles for o que quer, Votar neste dá-lhe o seu voto em vez de criar outro.
Juntar duplicados
Quando dois tópicos pedem o mesmo, a equipa usa Juntar em… no repetido e escolhe o original, que tem de estar Aberto, Planeado ou Em curso, no mesmo quadro. O repetido é arquivado como "Duplicado de <título>", com a ligação; os votos passam para o original sem contar duas vezes quem votou nos dois; os comentários ficam no repetido. Um tópico juntado não reabre.
Comentários
Quem abre o espaço comenta e responde (um nível de resposta), até 2000 caracteres. O autor do comentário e a equipa apagam; apagar um comentário leva as respostas dele. Um tópico arquivado deixa de receber comentários.
Aprovação prévia
Com Aprovação prévia ligada, os tópicos dos membros só aparecem no quadro depois de a equipa aprovar. Até lá, o tópico fica A aguardar aprovação, visível só para o autor (em Meus tópicos) e para a equipa, e não recebe votos nem comentários. Se o autor editar o texto de um tópico já aprovado, volta para aprovação. Os tópicos da equipa entram diretamente.
A equipa vê a barra Gerir quadro, com quantos tópicos estão a aguardar e o botão Fila de aprovação, que lista os pendentes com Aprovar e Recusar (o recusado fica visível só para o autor e a equipa). Os pendentes também aparecem na moderação.
Leitura pública
Num espaço com visibilidade Público, o visitante sem sessão iniciada lê tudo (o quadro, os tópicos, a contagem, os estados e os comentários), menos quem votou. Votar, comentar ou propor abre "Entre para votar no que apoia" (ou "Entre para comentar", "Entre para propor um tópico"), com Entrar e Criar conta; depois, a pessoa volta ao quadro. Num espaço que não é público, só quem abre o espaço lê.
Limites
| Limite | Valor |
|---|---|
| Tópicos novos | 5 por pessoa por dia (a equipa não tem limite; os pendentes e os apagados contam) |
| Votos | 120 por pessoa por hora |
| Título | 140 caracteres |
| Descrição | 5000 caracteres |
| Fotografias | Até 4 por tópico (JPG, PNG ou WebP) |
| Nota ou motivo | 500 caracteres |
Avisos por e-mail
| Quem recebe | Quando |
|---|---|
| O autor e quem votou | O tópico passa a Planeado, Em curso, Concluído ou Arquivado (com a nota ou o motivo), é reaberto ou é juntado a outro |
| A equipa | É proposto um tópico novo |
O membro não recebe e-mail a cada tópico novo. Os avisos chegam também ao sino. Só recebe quem ainda tem acesso ao espaço no momento do aviso. Pode desligar na categoria Upvote: tópicos que apoia, em E-mails desta comunidade, ou pela ligação do rodapé.
Passo a passo
Criar um quadro
Papel: proprietário ou administrador.
- No menu, em Adicionar Espaço, abra o separador Comunidade e escolha Upvote.
- Indique o nome, a descrição, a visibilidade (Público deixa qualquer pessoa ler) e o Quem pode publicar. Ligue Aprovação prévia se quiser aprovar cada tópico.
- Crie. Depois, Configurar, na barra Gerir quadro, liga e desliga a aprovação prévia.
Propor um tópico
- No quadro, clique em Novo tópico (no telemóvel, no rodapé: "Tem uma ideia? Proponha-a.").
- Escreva o Título e veja Já existe algo parecido?: se um tópico for o que quer, Votar neste.
- Escreva a Descrição e, se quiser, Adicionar fotos (até 4).
- Clique em Publicar tópico.
Gerir um tópico
Papel: proprietário, administrador ou moderador.
Abra o tópico. A barra Gerir tópico mostra os votos, o estado e as ações:
- Aprovar: quando o tópico está a aguardar aprovação.
- Editar: título, descrição e fotografias.
- Mudar estado: escolha o estado e, se quiser, a nota para quem votou. Guardar estado avisa o autor e quem votou.
- Juntar em…: escolha o tópico original e confirme.
- Arquivar: com o motivo, obrigatório.
- Reabrir: de Concluído ou Arquivado para Aberto.
- Quem votou: a lista, com a data de entrada de cada pessoa.
- Apagar: o tópico sai do quadro com os votos, os comentários e as fotografias. Se a ideia ainda vale, arquivar com um motivo guarda o histórico.
Exemplos
Quadro de sugestões de uma escola online. Espaço Público "O que quer aprender", Quem pode publicar = Qualquer pessoa. Os alunos propõem cursos; "Excel avançado" chega aos 80 votos, a equipa muda-o para Planeado com a nota "Gravamos em novembro", e os 80 recebem o aviso.
Melhorias de um coworking. Espaço para membros com Aprovação prévia. Um residente propõe "Mais tomadas na sala 2"; a equipa aprova, recebe votos, passa a Em curso e depois a Concluído. Um segundo pedido igual é juntado ao primeiro, levando os votos.
Erros comuns e como resolver
| Situação | O que fazer |
|---|---|
| Não aparece Novo tópico | O Quem pode publicar do espaço não inclui o seu papel |
| Não é possível votar | O tópico está Concluído, Arquivado ou a aguardar aprovação; ou não iniciou sessão (visitante) |
| Não é possível editar o próprio tópico | Outra pessoa já votou nele; agora só a equipa edita |
| Não é possível comentar | O tópico está arquivado ou a aguardar aprovação |
| Limite de 5 tópicos por dia | Aguarde que passem 24 horas desde o primeiro tópico |
| Não é possível reabrir | O tópico foi juntado a outro: os votos já estão lá |
| Arquivar não guarda | Indique o motivo, obrigatório |
Perguntas frequentes
Os membros sabem em que votei? Não. Só a equipa vê quem votou.
Quem sai da comunidade perde o voto? Não. Os votos continuam na contagem; os avisos param, porque a pessoa já não tem acesso.
É possível votar sem conta? Não. Num quadro público, o visitante lê; para votar, entra ou cria a conta.
Pelo assistente
O assistente propõe, vota e gere tópicos com as mesmas regras de quem o ligou. Ver Ferramentas · Conteúdo.
- Leitura:
get_upvote_board,list_upvote_topics(com ordenação e estado),get_upvote_topicefind_similar_upvote_topics. - Para quem abre o espaço:
vote_upvote_topic,unvote_upvote_topicecreate_upvote_comment, sem confirmação;create_upvote_topicpede confirmação;update_upvote_topicedelete_upvote_topic(com confirmação), o autor até outra pessoa votar. - Da equipa:
set_upvote_topic_status(inclui arquivar),reopen_upvote_topicemerge_upvote_topics, todas com confirmação, mostrando o motivo e quantas pessoas serão avisadas;merge_upvote_topicsnão tem volta.list_upvote_voters, só leitura. - Do proprietário e do administrador:
update_upvote_board, que liga ou desliga a aprovação prévia.
Peça assim: "Veja se já existe um tópico parecido com 'modo escuro na app' antes de criar; se existir, vote nele." Ver a receita.
Na API
As rotas ficam em /api/upvotes, com X-CommunityId; o caminho não leva a comunidade. As leituras dispensam sessão num espaço público.
| Rota | O que faz | Quem |
|---|---|---|
GET /api/upvotes/spaces/{spaceId} | O quadro: se a pessoa pode propor e gerir, e os limites | Quem lê |
PUT /api/upvotes/spaces/{spaceId} | Liga ou desliga requireApproval | Proprietário e administrador |
GET · POST /api/upvotes/spaces/{spaceId}/topics | Lista (sort = top, new ou trending; status; mine; voted; cursor) · propõe | Quem lê · quem pode publicar |
GET /api/upvotes/spaces/{spaceId}/similar?title= | Até 5 tópicos parecidos | Quem lê |
GET · PATCH · DELETE /api/upvotes/topics/{id} | Detalhe · edita · apaga | Quem lê · autor (até outro voto) ou equipa |
PUT · DELETE /api/upvotes/topics/{id}/vote | Vota · retira o voto | Quem abre o espaço |
GET /api/upvotes/topics/{id}/voters | Quem votou | Equipa |
GET · POST /api/upvotes/topics/{id}/comments · DELETE /api/upvotes/comments/{id} | Comentários | Quem lê · quem abre o espaço · autor ou equipa |
POST /api/upvotes/topics/{id}/status · …/reopen · …/merge | Muda o estado (status, note) · reabre · junta (targetId) | Equipa |
Erros: 400 (arquivar sem motivo, texto vazio ou demasiado longo), 403 (sem permissão), 404 (tópico de outro quadro ou comunidade), 409 (votar em Concluído, Arquivado ou pendente; comentar em arquivado; reabrir um tópico juntado), 429 (5 tópicos por dia, 120 votos por hora). A chave de API usa o módulo upvotes (ver Autenticação). Ver Upvotes.