Enquetes ao Vivo nos Comentários

Para criar uma enquete, clique no botão de enquete na barra de ferramentas do editor de comentários. Um editor de enquete abre abaixo da entrada de texto, onde você pode definir:

• A pergunta, até 200 caracteres.
• As opções, entre 2 e 10, cada uma com até 100 caracteres. Use Adicionar opção para adicionar mais.
• Quando a enquete termina: sem data de término, 1 dia, 3 dias ou 1 semana. Uma enquete encerrada mostra seus resultados finais e não aceita mais votos.
• Privacidade: se os votantes permanecem anônimos, são visíveis para administradores ou são públicos. Veja Privacidade do Votante.
• Exigir voto para ver resultados: quando marcado, os resultados permanecem ocultos de cada visualizador até que votem ou a enquete seja encerrada.

Escreva seu comentário como de costume e publique‑o. A enquete é publicada junto com o comentário. Enquetes podem ser adicionadas a novos comentários e a respostas.

Para descartar uma enquete antes de publicar, clique em Remover enquete.

Para votar, clique em uma opção. Os resultados são mostrados imediatamente, e a enquete mostra quantas respostas tem até agora.

Cada pessoa tem um voto por enquete. Enquanto a enquete estiver aberta, um eleitor pode clicar em Alterar voto para escolher uma opção diferente.

Os resultados são atualizados ao vivo. Quando alguém na página vota, as contagens e as barras são atualizadas para todos que visualizam a enquete, sem recarregar a página.

A menos que a enquete exija um voto para ver os resultados, os visualizadores podem clicar em Mostrar resultados para ver as contagens atuais antes de votar.

Cada enquete tem uma configuração de privacidade, escolhida pelo seu autor ao criá‑la. A enquete mostra sua configuração nas opções, para que os votantes saibam quem pode ver seu voto antes de enviá‑lo.

• Anônimo (o padrão): apenas os totais são mostrados. Ninguém, inclusive administradores, pode ver quem votou em quê.
• Administradores podem ver quem votou: apenas administradores e moderadores podem abrir Ver quem votou, que lista cada votante e sua escolha.
• Público: qualquer visualizador pode clicar em Ver quem votou e ver quem votou em quê.

Votos de visitantes que não estão logados são contabilizados, mas não têm nome associado, portanto não aparecem na lista de votantes.

O autor de uma enquete é notificado à medida que as respostas chegam:

• In-app: uma notificação sob o ícone de sino quando a enquete recebe uma nova resposta. Quando muitas pessoas votam, elas são agrupadas em uma única notificação.
• Email: um e‑mail diário para o autor da enquete quando sua enquete recebeu novas respostas naquele dia.

Só o primeiro voto de uma pessoa conta como uma nova resposta. Alterar um voto não envia uma notificação, e os autores não são notificados sobre seus próprios votos.

As notificações respeitam a privacidade da enquete. Para enquetes anônimas, elas apenas informam quantas novas respostas foram recebidas. Os nomes dos votantes são incluídos para enquetes públicas e para enquetes visíveis por administradores quando o autor é um administrador ou moderador.

O e‑mail inclui um link para interromper as notificações dessa enquete. Seu conteúdo pode ser alterado com o modelo Poll Response Notification, veja Email Templates.

Polls can also be managed from your own code with the REST API, for example to add a poll to a comment from your backend, close a poll, or export the votes:

• Poll Structure descreve o objeto da enquete e seus limites.
• GET, PUT, PATCH, and DELETE /api/v1/polls/:commentId leem, substituem, editam e removem a enquete de um comentário.
• PollVote Structure descreve um voto único.
• GET, POST, and DELETE /api/v1/poll-votes listam, registram e removem votos.

A poll can also be created along with its comment by passing poll to POST /api/v1/comments.

The API follows the same settings as the widget: polls must be enabled, and votes without a logged in user are rejected unless anonymous poll votes are allowed. Individual votes on anonymous polls cannot be read through the API.