A Slack bot to track statistics about who is talking the most
This is a Slack bot that monitors and reports on who is speaking in channels. It is an experiment by users of the LGBTQ in Technology Slack. But why?
It is beta-quality as we work out what we need. For now, it monitors any channel its a member of and reports on who has been speaking by whether or not they are men or people of colour.
To tell the bot you are a man, you send a direct message saying I am a man
, or Im not a man
, its complicated whether I am a man
and other such variations otherwise. You can say I am a person of colour
or I am white
. You can check what information has been recorded by saying info
. This interface is brittle but functional for now.
Its not my tendency to categorise the world as men vs. not-men, but in the case of space-domination, it seems like the necessary dichotomy.
The bot observes messages in channels its invited to. On every hour (configurable with REPORTING_INTERVAL
), it posts a brief report in each channel it has monitored, as long as a minimum REPORTING_THRESHOLD
of messages has been reached, 10 by default.
It also reports the detailed statistics for each channel in the STATS_CHANNEL
, which is #statsbot
by default.
If TOP_UNKNOWNS_TO_QUERY
is set to greater than 0 (it defaults to 2), the bot will message the two most talkative users who have not self-identified and have not yet been queried to ask them to self-identify.
Hey, Im a bot that collects statistics on who is taking up space in the channels Im in. For now, I only track whether or not a participant is a man and/or a person of colour. You can let me know Im not a man, I am a person of colour, its complicated whether I am white and other such variations, or ask for my current information on you with info. View my source at https://github.com/backspace/slack-statsbot If you dont want to answer thats okay, I wont ask again.
Admins on the Slack can configure the bot to skip reporting on particular attributes on a per-channel basis. For example:
Admin: ignore manness in #men
Bot: Okay, I will no longer report on manness in #men.
Admin: options for #men
Bot: #men reports ignore: manness
Admin: unignore manness in #men
Bot: I will again report on manness in #men.
From Seven Studies That Prove Mansplaining Exists:
- Women get interrupted more than men.
- Men interrupt women to assert power.
- Men dominate conversations during professional meetings.
- Men and boys dominate conversation in classrooms.
- Patients are more likely to interrupt female doctors than male doctors.
- Men get more space in print and online journalism.
- On Twitter, men are retweeted more often than women.
Heres an explanation from a Slack participant who is a man:
I think the way to think about the bot is that it's a gentle reminder that [] men are speaking more in the larger group spaces. We should look at it both as an encouragement for not-men to speak up ("Your voices are wanted and respected here"), and for men to engage in conversation with not-men (as in - make sure you don't run rough-shod over conversation points brought up by not-men, which is shockingly easy to do).
I am a man myself, and recognise my own complicity in these patterns even as I work to fight them. I try to have the humility to listen when someone wants to bring something up with me, so please do. Men who are angry or upset about this should direct their inquiries to me and other men on the Slack, not others, who can choose to participate or not.
UserRepository
, a wrapper around SequelizeThis uses ES2015 features and runs on (at least) Node 4.2.0.
The bot is for Slack, so youll need to set up a bot integration and have an API token ready. The user information is stored in a Postgres database.
The terse, in-channel reports use emoji for a concise, sparkline-like experience. Add the images at img/sb-*.png
as emoji manually or with one of the many brittle-seeming tools.
You can run the bot thusly:
DATABASE_URL=postgres://localhost/databasename \
SLACK_TOKEN=your_token \
npm start
You should be able to run the tests thusly:
npm test
If that doesnt work, this might:
for I in test/*.js; do $I; done
If you have a Heroku account, you can deploy the statsbot with minimal effort with the above button. Youll need your Slack token, but everything else has sufficient defaults. With Herokus new pricing structure, if you like the bot, you may need to move to a Hobby dyno to prevent it from being shut down.
Thanks to my mom for raising me with feminist values, even if they werent called that. Many friends and writers have helped me learn more about anti-oppression or social justice or whatever you like to call it.
The people in the Slack have been supportive as I worked on this, particularly @aredridel and @iarna. Thanks to @seldo for setting it up. Thanks to @joxn for the original sparkline emoji.