When you are using Open Agora Slack application, it displays messages containing lots of buttons. At any time, if you are lost, do not hesitate to hit the help button: It displays explanations relative to the buttons contained in the current message.
If you are experiencing any kind of trouble with the polling app, please do not hesitate to contact us. You may also type /agora feedback your feedback/question/request directly in Slack.
Installing the Open Agora application adds two slash commands to your Slack workspace:
These are strictly equivalent, and may be used indifferently.
We first introduced the
/poll command, but this later on introduced conflicts
for some users who installed other polling apps, thus overloading this command.
The latest command,
/agora, is used to remove this ambiguity,
since it will always refer to the Open Agora app.
If in doubt, use
/agora, it is not so much longer to type (and Slack auto-completion works well here!).
In our examples, we will prefer to use this one.
Perform the following steps:
In order to vote, simply hit the Vote! button in the published post, or type /agora vote:
It opens a new “voting” message in Slack, similar to this one: By clicking on “choices” buttons you select Rank 1 choices (the choices you prefer).
Once you have selected at least one choice you may select choices for other ranks using the + Add rank button:
This button creates new voting ranks.
Note: since ranks with no selected choices cannot exist (having choices at rank 1 and choices at rank 3 would be the same as having choices at ranks 1 and 2), if at some point you remove all the choices of a given rank, the application will automatically “compact” your ranks.
Once you have selected choices at several ranks, you may browse between ranks and update your vote using direct buttons:
Yes! You simply need to hit the Result button in the published message, or to type /agora result: It will display a new message containing the current result of the poll:
In the above picture, Condorcet provides choices ranked from the most consensual to the least.
This list takes into account all the ranks in the vote of
(for more details, see the FAQ on Condorcet voting system)
If in this message you hit the Majority button (or type /agora result -majority), you get the following display: This vote count only presents the sum of the choices at first rank of each voters. When voters cast votes with more than one rank, Condorcet result is more accurate (see below). In our example, three choices have equal score in majority but Condorcet tells us that Choice 2 is the most favorable with 60 % approbation versus all other choices.
Clicking the Pie button (or typing /agora result -majority -pie) leads to:
Whenever the poll is non-anonymous, use the Voters button (or type /agora voters -l) to get the detailed votes of each voter:
Whenever the poll is non-anonymous, you may also use the Details button (or type /agora result -l) to get the votes cast for each choice:
Use the Voters button in the result message, or type /agora voters -l: It produces this message:
Click the Details button (or type /agora result -l) to get the votes cast for each choice:
Currently, it is not possible. We believe that it would induce too much complexity for our users. However, users may always create new channels in order to consider several polls.
Voters may cast several votes ranked by preference (the first ranks being used for the preferred choices). The Condorcet method is an approach that takes into account every voter’s preferences.
When they differ, the Condorcet winner is a better choice than the simple majority.
For example, consider a poll with 3 choices A, B and C. Assume that 5 voters rank A before B before C; 7 voters C before B before A; 4 voters B before A before C. Obviously the majority winner is C, with 7 votes (vs A, 5 votes and B, 4 votes). The Condorcet winner is B for the following reason:
The Condorcet method is, also, very efficient to break equality for a small group of voters (and when it does not, it really means that each solution is equally good for the voters). For example, the screenshots in this question underline this. The majority yields three choices with equal score, however, for Condorcet, choice 2 is the best choice.
In order to find the Condorcet winner, we use Schulze’s method. This method helps breaking equality in many cases.
For a deeper introduction to Condorcet voting system take a look at our blog post on this topic.
Consider the following result:
Choice 2 is the Condorcet winner, it means that it is better than any other choice for voters. Furthermore, it has a minimal satisfaction rate of 60 %: this means that it gets at least 60 % of victory versus any other choice.
Choice 3 and Choice 4 are second Condorcet winners, it means that they are better than all other choices except choice 2. Furthermore, they are preferred over these other choices (excluding choice 2) at least 59 % of the time.
Choice 1 and Choice 6 are third Condorcet winners, they are better than the last remaining choice (5). Furthermore, they obtain at least 58 % of victory versus choice 5.
Choice 5 it is the worst possible choice for voters, it has a score of 0.
Important note: these scores reflect "approval" of a given choice with respect to choices with a worst ranking. They do not add up to 100. It is deliberate.
Yes, in order to do this you have to create a private channel where you will hold “sensitive” restricted polls.
|/agora [new] poll_name [choice1 ...]||Creates a new poll (1 active poll max. per channel), described by poll_name with some initial choices.
You may use double quotes (") in order to bound the poll name or choices.
/agora "What is you favorite color?" blue "light green" "RGB(255,0,0)"
|/agora add choice1 [, choice2, ...]||Adds new choices for voters (can be called multiple times) on the active poll. You may use double quotes (") in order to bound choices (in particular if they contain commas).|
|/agora publish [result]||Publishes the list of available choices in the poll channel.
This makes the poll visible to all users inside the channel.
If called with the result parameter, publishes the current poll result to the channel.
|/agora show||Private display of the available choices for the current poll, with clickable buttons. It has the same effect as clicking on the Vote button of the publish message.|
|/agora vote num1 ..., num2 num3 ...||Sends a new vote for some choices, in decreasing order of preference.
Users are allowed to re-vote, thus replacing their previous vote (more details in the FAQ).
If called without arguments, shows the current vote, and clickable buttons to update it, just like /agora show.
|/agora result [-majority [-pie]] [-l/-v] [publish]||Private display of the current results for the current poll, according to the available votes.
By default, Condorcet results are displayed, "-majority" toggles majority display. In this case, a bar chart graph is displayed, which can be replaced by a pie chart using option "-pie" additionnally.
Use the "publish" parameter to publish results globally to the channel. If the poll is non-anonymous, parameters "-l/-v" also display the votes of each voter.
Note: the resulting message contains buttons that enable easy navigation between each of these options.
|/agora close [-l/-v] [-silent]||Closes the poll: votes can not be recorded anymore, final result is displayed.
If the poll is non-anonymous and a parameter -l/-v has been used, it also displays the votes of each voter.
Option -silent closes a poll without publishing it to the whole channel.
|/agora help command||Provides a detailed help on a given command.|
|/agora help [-a]||Lists basic commands. Option -a lists advanced commands.|
|/agora create poll_name||Deprecated, use /agora new ... instead.
Creates a new poll (1 active poll max. per channel), described by poll_name, without choices.
|/agora remove num1 [num2 ...]||Removes choices with index num1 num2 ... (and associated votes). Only for the creator of the poll.|
|/agora voters [-l]||Lists the users who have already cast a vote for the active poll.
Option -l may be used for vertical ("list") display; when the poll is non-anonymous, it also displays the choices of each voter.
|/agora anon[ymous]||Turns the poll into an anonymous poll: nobody (not even the poll creator) can see who voted what. Only the poll creator can use this command, and it cannot be reverted.|
|/agora open||Reopens the closed poll (before any other poll has been created in the channel).|
|/agora delete||Permanently deletes a closed poll and the associated results.|
|/agora feedback feedback text||Sends feedback to the Open Agora team: bugs, suggestions, congratulations, anything is welcome!|