WooCommerce Slack

WooCommerce Slack brings your WooCommerce store into the heart of Slack channel conversations, allowing you and your team to easily stay current on what’s happening in your store with minimal effort.

Requirements ↑ Back to top

  • Slack account

Installation

  1. Download the extension from your WooCommerce.com dashboard
  2. Go to Plugins > Add New > Upload and select the .zip file you downloaded
  3. Click Install Now, and then click Activate

For more information on installing and managing plugins see here

Setup and Configuration ↑ Back to top

Slack API Key ↑ Back to top

Create a new token by going to the Slack API Page while logged in and visit the Legacy token generator section at the bottom of the page:

Extension setup ↑ Back to top

To set up WooCommerce Slack on your site:

  1. Go to WooCommerce > Settings > Integration > Slack and enter your Slack API key.
  2. Enter a Sender Name.
  3. Save changes to verify the API key has been entered correctly.
    • An error appears, if incorrect. Confirm your API key.
    • Other settings appear if correct. You may need to refresh.
  4. Select a default Channel.
  5. Set a default Emoji. More info in Emojis section below.
  6. Enable Debug mode, for troubleshooting purposes. Otherwise, leave disabled.
  7. Select preferences for seven Notifications. More info in Notifications section below.
  8. Send Test Notification explained in Testing section.
  9. Select Reload channels if you have added new channels to Slack, and they’re not showing.
  10. Save changes.

Emojis ↑ Back to top

Slack allows you to use any of many emojis available via the Emoji Cheat Sheet. They can also be used as your notification ‘icons’!

Set a default one:

Screen Shot 2014-10-05 at 4.53.26 pm

You can also set different emojis for specific notifications:

Screen Shot 2014-10-05 at 4.56.34 pm

Custom Emojis

Slack has a feature to add Custom Emoji that can be used in your account’s chat and in WooCommerce Slack.

Screen Shot 2014-10-05 at 5.10.29 pm

Assign a new ‘code’ to use the emoji, like :wooninja:, and then use it in your WooCommerce Slack settings.

Screen Shot 2014-10-05 at 5.11.37 pm

Screen Shot 2014-10-05 at 5.12.49 pm

Notifications ↑ Back to top

There are seven (7) notification events that can be enabled.

All notifications have options that appear after being enabled. All are optional:

  • Channel – Specific channel to send this notification to
  • Emoji – Specific emoji of this notification
  • Custom Notification Message – Custom message to use for this notification, made using the notification’s unique template tags
  • Extended NotificationSome notifications, have the option to send more detailed, several row notifications (like new order notifications with line item information).
The default options for each notification
The default options for each notification

New Order Notification

There is also an extra option for the new order notification:

  • Free Orders – If you select this option, notifications are also sent for free orders.

Screenshot on 2014-10-05 at 17-28-54

Custom Notifications

It’s possible to build your own custom notification messages for each notification type. Underneath each notification, the available template tags are listed. They’re straightforward to use but keep in mind that {xxxxx_link} provides the URL itself.

Special ‘Slack Formatting’ is allowed, like:

  • Bold: Wrap in *. eg. *some bold text*
  • Italic: Wrap in _. eg. _some italic text_
  • Links: Wrap in [[ & ]], with the format [[url|text to display]]. eg. [[http://woocommerce.com/|just view the Woo website!]]
Example of a custom notification message for new reviews
Example of a custom notification message for new reviews
The custom notification in Slack
The custom notification in Slack

Testing ↑ Back to top

To test the extension, the Permission Scopes in Slack need to be set as follows:

To send a Test Notification, go to WooCommerce > Settings > Integration > Slack and click the Send Test Notification button.

Test Notification

Customization ↑ Back to top

There are countless filters that can be used to customize the plugin and its notification messages.

Frequently Asked Questions ↑ Back to top

I added/removed a channel from my Slack account, but it’s not showing up.

To save your site resources, the plugin caches your rooms. Click the Reload Available Channels button at the bottom of settings and new rooms will appear!

Reload Channels
Reload Channels

Questions and Support ↑ Back to top

Have a question before you buy? Please fill out this pre-sales form.

Already purchased and need some assistance? Get in touch with a Happiness Engineer via the Help Desk.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top