Saltar para o conteúdo

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?

SondagemInquéritoUpvote
Quem perguntaA equipaA equipaOs membros propõem
OpçõesFixas, escritas pela equipaQuestionário em secçõesLista aberta, que cresce todos os dias
Onde viveNuma publicação do Feed ou do ConteúdoEspaço próprio e ligação públicaEspaço próprio
VotoEscolhe opção; só a equipa vê quem votou em quêResposta identificada ou anónimaUm voto por tópico, em quantos tópicos quiser; pode ser retirado
FimEncerra num prazoPeríodo, com resultado e NPSNunca encerra; cada tópico tem o seu desfecho
Para quêDecidir entre poucas opções agoraMedir satisfação e climaDescobrir 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çãoQuem
Ler o quadro, os tópicos e os comentáriosQuem abre o espaço; num espaço público, também o visitante sem sessão iniciada
Votar, retirar o voto e comentarQuem abre o espaço, com sessão iniciada
Propor um tópicoQuem o Quem pode publicar do espaço permite
Editar e apagar o próprio tópicoO autor, até outra pessoa votar nele
Aprovar, editar, mudar o estado, juntar, arquivar, reabrir, ver quem votou e apagarA equipa: proprietário, administrador e moderador. O financeiro não entra
Ligar a aprovação préviaProprietá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

EstadoO que quer dizerVotoComentário
AbertoA receber votosSimSim
PlaneadoA equipa vai fazerSimSim
Em cursoA equipa está a fazerSimSim
ConcluídoProntoCongeladoSim
ArquivadoNão vai avançar, com o motivo à vista de todosCongeladoNã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

LimiteValor
Tópicos novos5 por pessoa por dia (a equipa não tem limite; os pendentes e os apagados contam)
Votos120 por pessoa por hora
Título140 caracteres
Descrição5000 caracteres
FotografiasAté 4 por tópico (JPG, PNG ou WebP)
Nota ou motivo500 caracteres

Avisos por e-mail

Quem recebeQuando
O autor e quem votouO 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.

  1. No menu, em Adicionar Espaço, abra o separador Comunidade e escolha Upvote.
  2. 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.
  3. Crie. Depois, Configurar, na barra Gerir quadro, liga e desliga a aprovação prévia.

Propor um tópico

  1. No quadro, clique em Novo tópico (no telemóvel, no rodapé: "Tem uma ideia? Proponha-a.").
  2. Escreva o Título e veja Já existe algo parecido?: se um tópico for o que quer, Votar neste.
  3. Escreva a Descrição e, se quiser, Adicionar fotos (até 4).
  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çãoO que fazer
Não aparece Novo tópicoO Quem pode publicar do espaço não inclui o seu papel
Não é possível votarO 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ópicoOutra pessoa já votou nele; agora só a equipa edita
Não é possível comentarO tópico está arquivado ou a aguardar aprovação
Limite de 5 tópicos por diaAguarde que passem 24 horas desde o primeiro tópico
Não é possível reabrirO tópico foi juntado a outro: os votos já estão lá
Arquivar não guardaIndique 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_topic e find_similar_upvote_topics.
  • Para quem abre o espaço: vote_upvote_topic, unvote_upvote_topic e create_upvote_comment, sem confirmação; create_upvote_topic pede confirmação; update_upvote_topic e delete_upvote_topic (com confirmação), o autor até outra pessoa votar.
  • Da equipa: set_upvote_topic_status (inclui arquivar), reopen_upvote_topic e merge_upvote_topics, todas com confirmação, mostrando o motivo e quantas pessoas serão avisadas; merge_upvote_topics nã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.

RotaO que fazQuem
GET /api/upvotes/spaces/{spaceId}O quadro: se a pessoa pode propor e gerir, e os limitesQuem lê
PUT /api/upvotes/spaces/{spaceId}Liga ou desliga requireApprovalProprietário e administrador
GET · POST /api/upvotes/spaces/{spaceId}/topicsLista (sort = top, new ou trending; status; mine; voted; cursor) · propõeQuem lê · quem pode publicar
GET /api/upvotes/spaces/{spaceId}/similar?title=Até 5 tópicos parecidosQuem lê
GET · PATCH · DELETE /api/upvotes/topics/{id}Detalhe · edita · apagaQuem lê · autor (até outro voto) ou equipa
PUT · DELETE /api/upvotes/topics/{id}/voteVota · retira o votoQuem abre o espaço
GET /api/upvotes/topics/{id}/votersQuem votouEquipa
GET · POST /api/upvotes/topics/{id}/comments · DELETE /api/upvotes/comments/{id}ComentáriosQuem lê · quem abre o espaço · autor ou equipa
POST /api/upvotes/topics/{id}/status · …/reopen · …/mergeMuda 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.

Relacionados