/HangoutsChatPollsBot

A chatbot that allows building a custom poll within Google Chat

Primary LanguageJavaScriptGNU General Public License v3.0GPL-3.0

Hangouts Chat Polls Bot

Builds a custom poll within hangouts chat

Features

  • Polls can be made single choice per voter or multi choice.
  • Allow votes to be identified or choose the poll to be anonymous.
  • Optionally set an expiration time for the poll.

Minor features:

  • Users can add an optional short description per poll choice.
  • If a poll choice summary exceeds 32 chars and and no description part is specified then choice summary text is split into parts where the later part is moved into choice description.

Roadmap

Features to come:

  • Add an option to show poll results only after the poll has concluded.
  • Add an option to expire a poll manually by the poll owner (rather than time-based).
  • Add the ability for sub responses .. (for example: show YES, NO, Maybe under a given possible response).
  • For time based polls add the ability to show time correctly by the participant time zone.
  • Add the ability to visually construct the poll (using cards too).

Configuration

Please refer to https://developers.google.com/hangouts/chat/how-tos/bots-publish on how to add the bot to configure and prepare be your bot for deployment.
Additioanlly in the code make sure to set the BOT_NAME variable to match the name you picked for your bot during bot configuration step.

Usage

After you add the bot to a room or a space you may start a new poll by posting a question with choices as follows:
When do you want to meet? Friday 8:00 PM, Saturday 8:00 AM, Sunday 3:00 PM.
The bot would then ask you few questions about the nature of the poll.
Note: A poll needs to have at least two options!

Once you finish answering the follow up questions the bot will post the poll into the room and starts counting the votes from different participants as shown below: