Integrating Slack with kintone

With Slack integrated with kintone, users can use Slack's direct messaging feature to send a notification to an assignee of a task in the process management feature.
This feature is useful when you manage tasks using the App and Slack.

Preparation

Setting an E-Mail Address to Receive Notifications from Slack Integration

To integrate Slack with kintone, you must set the same e-mail address both in the Slack Workspace and kintone. This step is not necessary if you have already set the e-mail address in the user information or once you have set this up.
To configure the setting, you must have Users & System administrative privileges.

1. Click Settings to open Users & System Administration.
2. In "Departments & Users" under User Administration, click icon on the left of the user name of which you want to set the e-mail address.
   
3. Fill in the e-mail address and then click "Save".

Enabling Integrations

You can enable integrations in Users & System Administration. This step is not necessary once you have enabled this.
To configure the setting, you must have Users & System administrative privileges.

1. Click Settings to open Users & System Administration.
2. Click "Integrations"and enable Slack.
   

Creating an App on kintone

Create an app on kintone that will integrate with Slack.
See Various Ways to Create Apps.
Adding an app from Kintone marketplace is convenient to create an app quickly.

Enabling Process Management in the App

To send a notification as a Slack direct message to an assignee of a task, you must enable the process management in the kintone app.
See Setting Process Management.

Setting Up Slack Integration

1. In the kintone portal screen, click the kintone app that you want to integrate with Slack. In this help topic, open "Task Management" to integrate with Slack.
   
2. Click Settings in the upper right of the record list screen of the app.
   Opening App Settings Page
3. Click "App Settings" tab.

4. Click "Slack Integration".
   

5. Click "Add to Slack".
   

6. Confirm the Slack Workspace which you want to integrate, and click "Authorize".
   In this setting example, the Slack Workspace called "Cybozu" is used for the integration. If you want to change the Workspace to integrate, click "⯆" on the upper right side.

7. In the kintone app, ensure that the integrated Slack Workspace is displayed.
   In Slack, a bot user called "kintone" is added to Apps.

8. Click "Back to App Settings" button.
   

9. Click "Update App". Now you have completed the settings.

Let's Send a Notification

Let’s try to send a notification!

1. Access the kintone app that you integrated with Slack and open a record.
2. In the record details screen, click "Start".
3. Select a user to assign the task, and click "Confirm".
   

The assigned user of the task receives a direct message in Slack.
In the direct message, the title of each record is displayed. The URL of the record appears instead of the title, when the record number is selected as a record title, you do not have the permission to view the title, or the title is blank.

Removing Slack Integration

In the app settings screen, you can delete the integrations with Slack Workspace.

1. Click Settings in the upper right of the record list screen of the app.
   Opening App Settings Page
2. Click "App Settings" tab.
3. Click "Slack Integration".
4. Click the "x" icon of the Slack Workspace which you want to remove the integration.
5. Click "Remove".
6. Click "Back to App Settings" button.
   
7. Click "Update App". Now you have removed the integration.