Slacktivity

Do you want to know right away when your users do something really important? Slacktivity is a lightweight Javascript analytics library that allows you to send crucial user activity directly to your team's Slack. It's especially great for startups to know exactly what their early users are doing.

Why use Slacktivity?

Slacktivity has a different use case than traditional analytics platforms such as Google Analytics and Mixpanel. These platforms are fantastic for gathering tons of data on users and giving a clean interface to later interpret user behavior. Slacktivity, on the other hand, shines when there are special and relatively rare user events that you wanted to be notified of right away.

Some examples of when Slacktivity would be useful are:

• You're an early-stage startup with only a few users, and you want to be notified any time a user logs in.
• You're a SaaS company that just released a new, special feature to a small set of customers, and you want to know exactly when your customers use the new feature, and how they're using it.
• You have a crucial feature that should never break, but you want to be notified immediately if it does.

Installation

bower install slacktivity

or

npm install slacktivity

or

Copy slacktivity.js into your project and add <script src="slacktivity.js"> to your HTML header.

Configuration

If you haven’t already, set up an incoming Webhook in the integrations section of your Slack dashboard.

In the config section at the top of slacktivity.js, add your own webhook_url. You also have the option to add a custom title, icon_url, or text in the config.

Usage

#Overview

After you include the script into your page, it binds a Slacktivity object to the window. To fire an event to your Slack channel, call it from any Javascript on the page:

	window.Slacktivity.send({
		“User Email”: “[email protected]”,
		“Company”: “Apple, Inc.”
	});

where the parameter is an object of key-value pairs of data. Feel free to specify any custom attributes in the parameter object.

Metadata Custom Keys

There are some specific keys you can include to modify the post’s metadata. By default, they include:

• “title”: The post’s title
• “text”: The text below the title
• “color”: The post sidebar color (a hex string like "#0393DD")
• “fallback”: The notification’s banner text
• “icon_url”: The icon next to the Slack post
• "channel": Override the default webhook's channel to send to other channels (ex. "#random")

To fire an event, call:

window.Slacktivity.send();

Specify any custom attributes as an object. For example,

window.Slacktivity.send({"title": "Important Login Event!", "icon_url": "http://a.abcnews.go.com/images/Technology/GTY_Apple_CEO_Tim_Cook_MT_140716_25x14_992.jpg", "Company": "Apple, Inc.", "User Email": "[email protected]”, "text": "Tim Cook just logged in"})

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/MightySignal/slacktivity. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The project is available as open source under the terms of the MIT License.

Blog Post about Slacktivity

https://medium.com/@MightySignal/slacktivity-a-javascript-library-that-tells-you-right-away-when-your-users-do-something-really-efe18e6cbd74