Using Slack add-on

Requirements#

• A registered (free or paid) account on Slack.
• A Slack app added to workspace (instructions below).

Creating Slack App#

The Slack API uses OAuth 2.0 to validate all connections, so it is necessary to set up an app in order to connect the ShopMagic Slack add-on with your workspace.

1. Go to your Slack Apps admin.
2. Create an app by clicking on the Create New App button:
   
3. You'll see a form with:
   • App Name: set a name for your app, i.e. ShopMagic.
   • Development Slack Workspace: select a workspace to which you want to add integration.

   

4. When you are directed to next page, scroll down to see App Credentials:
5. Your app has been created. Please do not close this page, because you will also need it in the next step.

Fill in app credentials in ShopMagic settings#

1. In your WordPress dashboard, go to menu: ShopMagic → Settings → Slack.
2. Fill in the form to get started. Copy the Client ID and Client Secret from your Slack app that you created in the previous step and save settings:
   
3. When the Client ID and Client Secret are saved, copy the callback URL that is visible above the form. It should look like this https://changetoyourdomain.com/wc-api/shopmagic_slack/.
4. Go back to your Slack app that you created before.
5. In the sidebar click the OAuth & Permissions link:
6. Enter and save your callback URL as shown below:
7. Next, scroll to Scopes and in the Bot Token Scopes section add: channels:read , groups:read, and chat:write:
8. Go back to ShopMagic Slack settings in your WordPress dashboard.
9. You will be able to connect, click the Connect with Slack button:
10. You will be redirected to Slack. When you see permissions screen, click Allow to proceed:
11. You will be redirected back to ShopMagic Slack settings. You will notice a success message:

General Settings#

After a successful connection you will be presented with some general settings.
Defaults
You can set up some default values. You will be able to override these when you configure your automation.

• Default Channel
• Default Name
• Default Emoji

Additional options#

• Debug: you can enable logging important information to WooCommerce logs.
• Test Notification: you can send a test notification to confirm that everything is working as expected. In order to be able to send a test notification, please select the default channel.
• Reload Channels: if you have added a new channel and it\'s not showing, this will refresh the list.

Adding a new Slack automation#

In order to add a new Slack automation, please follow the steps described here.
When you scroll to the Actions meta box, you will be able to add Post to Slack action:

• Message: create a message that will be sent to Slack. You can use placeholders here.
• Channel: select a channel to post to.
• Name: enter a name that will appear next to the message.
• Emoji: enter an emoji for the message.

If you do not fill channel, name, or emoji fields, defaults from general settings will be used.
When the selected event occurs a message will be sent to your Slack:

You may also read more on how to send notifications from Slack with ShopMagic.