Creating an extended integration for Slack users

Let Oomnitza be your single source of truth!

You'll get visibility of your Slack users as data from Slack is automatically transformed into consumable information and actionable insights.

Connect Oomnitza and Slack in minutes

Get the information and insights that you need to reduce costs and the time that you spend on administration tasks such as:

• Configurable dashboards and list views of key user information
• Configurable reports to share information about users with your colleagues and management

Navigation

Prerequisites

Creating the user integration

Creating custom mappings for the user integration

Slack to Oomnitza mappings

Prerequisites

Before you create the user integration, you need to have added your Slack OAuth credentials to Oomnitza.

Creating the user integration

1. From the menu, click Configuration > Integrations.
2. Click Integrations List View .
3. On the Integrations page, scroll down to the Extended section for User Integrations.
4. Click NEW INTEGRATION.
5. In the New User Integration sidebar, click Slack.
6. Click APPLY next to the Slack User Load, and then click NEXT twice.

Connect page

Best practice
To ensure that only live user records are streamed to Oomnitza, choose Update only as your integration preference. When you run the integration, you can check the error logs to see which user records weren't uploaded and why they weren't uploaded. You can then decide whether to upload the user records that were skipped by changing your integration preference to create and upload. See Access error logs.

On the connect page, complete the following steps to connect the integration:

1. Enter a descriptive name for the integration such as Slack User Load. This name will be displayed on the Integrations page once the setup is complete.
2. From the User Selection list, select User plus SaaS User or User only.
3. If you select User plus SaaS User and you have multiple instances of the same SaaS application, select the application from the SaaS Selection list. If you have a single instance of the SaaS application, skip this step.
4. From the installation type list, select Cloud.
5. From the Credentials list, select your OAuth credentials that you created in Adding your OAuth credentials.
6. From the Integration Preferences list, select Update only.   
7. Enter the name of the user of the integration.
8. Click Next.

Creating custom mappings for the user integration

Map the Slack fields to Oomnitza fields and create custom mappings to get the user information that you need.

Complete these actions:

1. Click Smart Mapping.
2. You must create a custom mapping for the Slack User Id field. To do this, complete these steps:
   1. Click the down arrow on the Id field.
   2. Select Add new Oomnitza users field.
   3. Change the name of the new field to Slack User Id. 
   4. Enable the Unique checkbox.
   5. Click CREATE. 
3. Create custom mappings to map any other field that you want to add to Oomnitza:
   1. Click the down arrow on the field that you want to map.
   2. Select Add new Oomnitza users field.
   3. Change the name of the field.
   4. Click CREATE. 
4. Assign a sync key to the Email field.
5. Click NEXT. 

Note: For all user loads, it is recommended that you map role information to an employee role in Oomnitza. Users need to have an employee role defined in order to access Oomnitza. If the role information is not available from the user load, it is recommended that you select Employee from the Oomnitza Role dropdown list. You have the option to overwrite this at a later point should the role information become available. 

Slack to Oomnitza mappings

The following Slack fields can be mapped to Oomnitza:

Connector Sync Time
Deleted?
Email
First Name
Is Admin?
Is bot user?
Is restricted (guest) user?
Is ultra restricted (single channel only) user?
Last Name
Phone
Skype
Team ID
Title
User ID
User Name

Want to map more fields to Oomnitza?
Contact Support, or see Mapping extended connectors.

When you've completed mapping the Slack to Oomnitza fields, click NEXT.

Schedule

By default, user data is streamed to Oomnitza once every day.

You can configure the schedule to meet your needs such as changing the interval or changing the time so that the data is streamed when your system isn't busy.

1. Configure your schedule.
2. Click FINISH.

Result
A new tile is created for the integration on the Integrations page. 

What to do next

If you want to see the information that is collected now, click the tile on the Integrations page and click RUN NOW.

If you want to change the integration settings, you can click a navigation link on the page, such as 4 Mappings, and edit the settings. 

Unleash the power of Oomnitza

To get valuable actionable insights that help you manage your assets, learn how to:

• Configure dashboards for your users and software
• Configure custom reports about your users and software
• Create workflows to automate tasks

Next steps

Now that you have run the Slack user integration, add your Slack API credentials to Oomnitza so that you can run the Slack last login integration.