# Slack

{% hint style="info" %}
Skip to the [Set Up](#set-up) below for instructions on how to deploy or reconfigure this integration.
{% endhint %}

{% embed url="<https://www.loom.com/share/ae6708a8668547dc9fd7a5dc27950011>" %}
Demo of Slack notifications in action
{% endembed %}

Get notified in [Slack](https://slack.com/) of ION events to close the loop on critical issues and help your factory move faster. Any notification in ION can be output to Slack, allowing teams to bring users back to ION at key moments. This is important for onboarding new team members who need to develop the habit of using ION on a daily basis.

If a user is subscribed to a certain ION object and that object changes state, a user is mentioned in a comment, or assigned a task, ION will notify that user directly in Slack.

For example, if as user is mentioned are mentioned (@Alice) in a comment in ION that will send a direct message to Alice in Slack with a link back to ION where the location that the mention came from.

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2F9zt6UVR0usQI6Mgk33xK%2Fimage.png?alt=media&#x26;token=47076b1c-0195-46cb-87c1-f0bac45c6c1b" alt=""><figcaption><p>Examples of notification types within ION</p></figcaption></figure>

## Notification Types&#x20;

ION has many notification types to configure - see the list below or reference the `NotificationTypeEnum` in the [GraphQL API explorer](https://manual.firstresonance.io/api/interactive-api-explorer). Your organization can choose to add these below notification types as values to the integration, which will then allow the integration to send them to Slack. See step 6 in the [#set-up](#set-up "mention")section below on how to configure your organization Slack notifications.

|    Keyword in Slack Integration   |                                                                                                                                                 Notes                                                                                                                                                |
| :-------------------------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
|         `approval_request`        | The user is requested to approve an ION object, like a [Purchase](https://manual.firstresonance.io/features/purchasing/purchase-orders), [Standard Step](https://manual.firstresonance.io/features/procedures/standard-steps) or [Redline](https://manual.firstresonance.io/features/runs/redlining) |
|             `comment`             |                                                                                                                        Someone commented on an object a user is subscribed to.                                                                                                                       |
|     `datagrid_value_assigned`     |                                                                                    The user is requested to review a [datagrid](https://manual.firstresonance.io/features/procedures/steps/datagrid) cell signoff                                                                                    |
| `issue_approval_request_assigned` |                                                                                         The user is assigned to an approval request for an [Issue](https://manual.firstresonance.io/features/quality/issues)                                                                                         |
|          `issue_assigned`         |                                                                                                     The user is assigned to an [Issue](https://manual.firstresonance.io/features/quality/issues)                                                                                                     |
|          `issue_created`          |                                                                                         An [Issue](https://manual.firstresonance.io/features/quality/issues) is created on an object subscribed by the user.                                                                                         |
|       `issue_status_changed`      |                                                                                                                           An Issue the user is subscribed to changes state                                                                                                                           |
|             `mention`             |                                                                                                                                 The user is @ mentioned in a comment                                                                                                                                 |
|        `part_kit_assigned`        |                                                                                                          The user is assigned to a [Kit](https://manual.firstresonance.io/features/kitting)                                                                                                          |
|     `part_kit_status_changed`     |                                                                                                  A [Kit](https://manual.firstresonance.io/features/kitting) the user is subscribed to changes state                                                                                                  |
|        `procedure_released`       |                                                                                               A [Procedure](https://manual.firstresonance.io/features/procedures) the user is subscribed to is released                                                                                              |
|     `procedure_status_changed`    |                                                                                              A [Procedure](https://manual.firstresonance.io/features/procedures) the user is subscribed to changes state                                                                                             |
|              `review`             |                                                                                                         A user approved a [Procedure](https://manual.firstresonance.io/features/procedures).                                                                                                         |
|          `review_request`         |                                                                                                  The user is requested to review a [Procedure](https://manual.firstresonance.io/features/procedures)                                                                                                 |
|           `run_assigned`          |                                                                                                            The user is assigned to a [Run](https://manual.firstresonance.io/features/runs)                                                                                                           |
|        `run_step_assigned`        |                                                                                                       The user is assigned to a step in a [Run](https://manual.firstresonance.io/features/runs)                                                                                                      |
|         `run_step_changed`        |                                                                                                 A [Run](https://manual.firstresonance.io/features/runs) step the user is subscribed to changes status                                                                                                |
|     `run_step_field_assigned`     |                                                                                     The user is requested to review a run step [field](https://manual.firstresonance.io/features/procedures/steps/fields) signoff                                                                                    |
|             `signoff`             |                                                                                       The user is requested to sign off a [field](https://manual.firstresonance.io/features/procedures/steps/fields) in a Run.                                                                                       |
|     `purchase_order_assigned`     |                                                                                           The user is assigned to a [Purchase Order](https://manual.firstresonance.io/features/purchasing/purchase-orders)                                                                                           |

## Set up&#x20;

1. Navigate to the [Integrations page](https://staging.firstresonance.io/integrations) designated by the two arrows in the bottom lefthand corner of your screen.

   <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FVzPVRlUNumtATgWH858H%2Fimage.png?alt=media&#x26;token=49e2fadf-28ed-47b6-8028-adfb7b9b7b92" alt=""><figcaption><p>Select Integrations in the Bottom Left Hand Corner</p></figcaption></figure>
2. Select Slack integration instance from the marketplace, and hit **Configure.**&#x20;
3. Hit **Next** and add your API credentials. You can find documentation on API credentials here [api-keys](https://manual.firstresonance.io/api/api-keys "mention")
   * **IMPORTANT:** Each API Key is associated with a specific environment, be sure to generate the API keys from the correct environment and configure the automation to the designated environment.<br>

     <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FtRleYTBzwTTV1gFsbcqZ%2Fimage.png?alt=media&#x26;token=e43b10c4-2436-42d0-9c98-f9caa52e9f8b" alt=""><figcaption><p>Set your Environment According to Where the API Keys were Generated</p></figcaption></figure>
4. Connect with Slack to download the application
5. Scroll down to where you can **Add value.**&#x20;
6. Here, you can type in the notifications you want your organization to receive from the list above or hit the trash button to delete types you do not want to receive. By default, all of the notifications are turned on. Be sure to add them in lowercase!

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FgfXXszlnDRzyEzOJZBDu%2Fimage.png?alt=media&#x26;token=ad5498eb-598d-45af-8129-2a737bd84355" alt=""><figcaption></figcaption></figure>