Slack
Slack is a great and simple way to get complex analytics data into the hands of your staff. Using our integration, you can have real-time alerts coming into your business right in the user's current workflow—and they can be delivered in a helpful way right away. All set up within a few minutes with no technical knowledge required.
How It Works
This Slack integration works with Zengain and Zentitle2, or both. When you install it, you will see options based on what you have purchased from Nalpeiron—for this document, we will use Zentitle2 as the example.
This integration takes data from our APIs and parses it into simple messages that can be posted into a Slack channel based on the passed data. Thus, you can customize the channels you want the messages to be posted to based on how your team works and the data being received.
The whole process is very simple, assuming you already have Slack set up. During the installation, you can do a quick test to ensure the system is working.
Prerequisites
An existing Slack instance, or set one up.
Admin privileges or access to your admin to allow the "connection".
Before data mapping, an understanding of which channel names you want for the incoming data, and for these to be set up in Slack, e.g., #zentitle2_messages.
Knowing what data is going where will allow you to add the right team members to consume the insights and analytics data coming into Slack - shared or specific channels.
Setup Overview
Set Slack up, add channel names (or at least one), and open Slack.
Go to Admin > Integrations > Slack within the Nalpeiron Growth Platform.
Click the connect button and follow the process shown. The open instance of Slack will be connected to Nalpeiron, assuming you have admin permissions. Alternatively, you can wait for a colleague to permit the connection.
Set up which channels will receive what data.
Test for data flow between the systems.
Event types coming from Zentitle2 for your Slack channel naming
In Slack, you must make channels to receive this event data, see below.
If you are not sure what each event means, roll over the tooltip for more information.
Step 1: Open your Slack instance
Sign in to your Slack instance, or sign up.
Once in the desktop app, assuming you use that, we suggest adding some new channel names to receive the "licensing" data.
In Slack, click Channels > Create > Create Channel
Add details for your new channel (we will not show every detail here).
In this example, we will create five new channels for each dataset, but you can use just one channel for everything.
Now, you can switch to Nalpeiron and start the connection process.
Step 2: Connect either Zengain/Zentitle2 to your Slack instance
Go to Admin > Integrations > Slack within the Nalpeiron Growth Platform.
Click the connect button and follow the process shown. If you have multiple instances of Slack, as shown here, you need to use the navigator dropdown at the top right of the browser to select the one you need.
The open instance of Slack will be connected to Nalpeiron, assuming you have admin permissions.
Alternatively, you can wait for a colleague to permit the connection.
When you click the "allow" button, you will be redirected back to the Slack integration page, where you can check the integration status.
Next, you can set up which channels will receive what data by clicking the "edit" button at the top of the integration section.
You can see the various Zentitle2 event data types that can be used—you can choose all or only some of them, depending on your needs. Here, we have used the names previously created in Slack as channels and placed those names in this section.
Click "save" to map the data between systems.
Check Slack for the connection in the Apps section.
If you look in the Slack post connection, you should see the Nalpeiron Growth Platform installed under the "apps" section at the bottom of your Slack instance.
Step 3: Test the integration
The next step is to test the connection.
Click the "test" button at the top of the Slack section.
A pop-up message will confirm this action. Click OK to clear the message.
Switch to Slack and the #general channel to see if the data arrived.
Above, we can see the test message came over fine, so we know the connection is working well.
The final step will be to wait and see the Zentitle2 data coming in from the system. In this case, each data set will come into its own channel, and the team will be able to monitor each data set and make decisions accordingly.
Native Slack integration - Zentitle2 example - showing licensing data
Disconnecting Slack
If you need to disconnect the connection to switch to something else or to remove it completely, simply click the "Disconnect" button.
Last updated
Was this helpful?