What You Need to Integrate {{variable.Slack}}

A Workspace and a Channel in {{variable.Slack}}

You need at least one workspace in your {{variable.Slack}} account to use the integration. You also need at least one channel in this workspace.

You can choose to have a channel dedicated to the integration in your workspace or connect Nexudus to one of your existing channels.

You must manually invite {{variable.usersWP}} and admins to the relevant {{variable.Slack}} workspace and channel before they can access the public and private notifications sent from Nexudus.

Simply make sure you use the same email as the one they have on record in Nexudus.

Your {{variable.Slack}} App Manifest

You can find this manifest in your {{variable.Nexudus}} account by clicking Settings > Integrations > Slack on the {{variable.AdminPanel}}.

You can easily copy the app manifest by clicking on Copy to clipboard. You can leave this tab open before starting the integration process to make sure you have it on hand.

Integrating {{variable.Slack}}

Integrating Slack is a four-step process. You first need to create an app using {{variable.Slack}}'s API. Once you have the app, you can copy the relevant API tokens. You then need to invite to the relevant {{variable.Slack}} channel before enabling the integration in Nexudus.

Step 1. Creating Your {{variable.Slack}} App

Make sure you have your App manifest available under Settings > Integrations > Slack handy in another tab or already copied to your clipboard before getting started.

Go to https://api.slack.com/apps.
Sign in using the email and password you usually use to sign in to {{variable.Slack}}.
Click Create an App.
Select From an app manifest.
Select the Workspace where Nexudus should push the messages from your location and click Next.
Remove all the default code lines in the YAML tab.
Paste the App manifest you copied from your Nexudus account in the YAML tab.
Edit the name, description and background_color details if needed.
Nexudus gets those default details from your location's settings.

13.Click Next.

Click Create.

The app is now created and you can move to the next step of the integration.

Step 2. Installing Your {{variable.Slack}} App

Click on Install to Workspace.

Click Allow.
Scroll down to the App-Level Tokens section and click Generate Tokens and Scopes.
Name your token.
Click Add scope and select connections:write.
Click Generate.
Copy the Token and save it somwhere safe. You'll need to paste this token on the Admin Panel in Step 3.

Treat your token as you would any password.

Click Done.

You also need to copy and save your app's Bot User Oauth Token before moving to Step 3.

Click on Oauth & Permissions in the navigation menu.
Copy the Bot User OAuth Token and save it somewhere.

Treat your token as you would any password.

Now that you've copied both your App-level token and your Bot User OAuth token and saved them, you can move to the next step of the integration.

Step 3. Adding Your {{variable.Slack}} App to a Channel

Now that you have your {{variable.Slack}} app and saved the tokens you'll need in the next step, you can add your app to the channel of your choice.

This channel is where all the content you push from Nexudus will be posted in {{variable.Slack}}. You can use any of your existing channels or create one dedicated to the integration.

Go to slack.com/signin.
Sign in to your {{variable.Slack}} account.
Select the relevant Workspace if you manage more than one.
Click on your app under the Apps section of the navigation menu.

Click on the downturned arrow next to to the app's name.

Slack_DownturnArrow

Click on Add this app to a channel.
Select the channel that will publish content pushed from Nexudus.
Click Add.

You can make sure that the app was successfully added to the channel by opening the channel's settings and checking the Integrations tab.

Once your app and the relevant app are connected, you can move to the last step of the integration.

Step 4. Enabling the {{variable.Slack}} Integration

The last step of the process is to enable the integration on the {{variable.AdminPanel}}.

Have the App-level and Oauth Bot tokens you saved during Step 2 handy for this step.

{{snippet.FirstStepProcedure}}
{{snippet.Slack_Path}}
Enable the {{variable.Slack}} integration toggle.
Add the App-level token you saved during Step 2.
Add the Bot API token you saved during Step 2.
Add the name of the channel you used to invite your app during Step 3 in the Public anouncements channel field.
{{snippet.Save_Changes}}

{{variable.IntegrationComplete}} The {{variable.Slack}} integration is now complete and ready to use straight away.

Pushing Events and Article Notifications

Once the integration is enabled, you can push a notification by clicking the ellipsis icon next to any event or blog article you want to share in {{variable.Slack}}.

The notifications are pushed to the {{variable.Slack}} channel you defined as the Public announcement channel on the {{variable.AdminPanel}}. The notification includes a link to the event or article page on your {{variable.MembersPortal}}.

Pushing User Messages

Once the integration is enabled, {{variable.usersWP}} receive private messages in {{variable.Slack}} whenever you send them from the Admin Panel to their inbox and in {{variable.Slack}} automatically.

Automated Invoice Notifications for {{variable.usersWP}}

Once the integration is enabled, {{variable.usersWP}} will receive a private notification in {{variable.Slack}} every time they receive an invoice notification via email.

Automated Admin Notifications

Once the integration is enabled, admins will receive a private notification in {{variable.Slack}} every time Nexudus sends them an admin notification via email based on their notification preferences.

{{variable.MoreInformation}} Managing Admin Notifications.