# Slack

**A service offered by Pier Cloud that allows our FinOps platform to integrate with Slack for sending notifications related to identified anomalies and triggered alerts.**\
This document describes the steps required to configure and manage this integration, ensuring that your teams efficiently receive notifications and have access to the information they need.

### Connecting Slack to the Pier Cloud Platform

#### Prerequisite

To integrate with Slack, you must install the **PierCloudNotification App** in your workspace, which will enable the connection between the Pier Cloud platform and Slack.\
Further below, we will explain how to perform this installation.

{% hint style="warning" %}

#### Prerequisite

To integrate with Slack, you must install the **PierCloudNotification App** in your workspace, which will enable the connection between the Pier Cloud platform and Slack.\
Further below, we will explain how to perform this installation.
{% endhint %}

#### Step 1: Accessing Settings in Pier Cloud

1. Click on the **user profile**, then select **Settings**, as illustrated below:

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FCHGnCUyHOqrLdvbEFWZr%2Fimage.png?alt=media&#x26;token=7da4de41-e9f5-4322-842b-1e68047488bf" alt=""><figcaption></figcaption></figure>

2. The system will display a side menu with several configuration options. Select **Notifications**:

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FxZSEw4DUUEBSqIQldX1l%2Fimage.png?alt=media&#x26;token=e99692bb-21db-40d2-8ec6-37b826d9e0c2" alt=""><figcaption></figcaption></figure>

3. By clicking the "![](https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FGhH2eTQSEu27Te2h88OM%2Fimage.png?alt=media\&token=4a99072b-b5af-4dad-bd2a-88e34f9a8e79)" icon, the system allows you to view registered provider groups and add new ones.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2Funq0mE8s5T4jGCfdVOFh%2Fimage.png?alt=media&#x26;token=04debd93-8e2b-4b8e-8abb-19fd17ac75d9" alt=""><figcaption></figcaption></figure>

4. The system will then display a screen requesting the following information:
   * **Select type:** Slack
   * **Name:** Enter a name to identify the provider group

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FtychxVszHfwe9sHPBYX4%2Fimage.png?alt=media&#x26;token=9048b86a-a236-4c14-b32a-ad5d6e3788e0" alt=""><figcaption></figcaption></figure>

* **Settings:** For the Slack provider type, the following additional fields must be completed:
  * **Team ID:** A unique identifier for your Slack workspace.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2F6tH3U2fnuYCqfqBKkEx3%2Fimage.png?alt=media&#x26;token=c07dcc8a-3dcb-4373-b0d1-b4558c022e6f" alt=""><figcaption></figcaption></figure>

#### Step 2: Finding the Team ID via Automatic Installation

When selecting **Connect with Slack**, the system will redirect you to a screen requesting permission for the **PierCloudNotification App** to access your company’s Slack workspace:

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FTsaA415Jn7PnT1DAAFHx%2Fimage.png?alt=media&#x26;token=c35e50cb-0b4f-4d7b-9e79-9ce11e76c801" alt=""><figcaption></figcaption></figure>

Once you click **Allow**, the system will automatically install the PierCloudNotification App in your Slack marketplace and return to the provider registration screen, with the **Team ID** field automatically filled in.

<figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FkkdHlOLXnHCBqKPATr2N%2Fimage.png?alt=media&#x26;token=c6c7c00c-edf3-42bb-bc22-4faa84dfcd6f" alt=""><figcaption></figcaption></figure>

***

#### Step 3: Identifying the Team ID and Installing the App Manually

It is also possible to find the **Team ID** manually using Slack share links. To perform this process manually, you must first install the PierCloudNotification App from your Slack Marketplace:

1. Go to the **Apps** section in Slack.
2. Select **Manage and than, Search Apps**.
3. Search for *“PierCloudNotification”*.
4. Click **Install** to add the app to your Slack workspace.

Once the installation is complete, you must obtain your Team ID:

1. Go to the channel where you want to receive notifications.
2. Right-click and select: **Copy ⇒ Copy link**.
3. Paste the copied link into a text editor and extract the bold part, as shown in the example below:

Example:

```
https://app.slack.com/client/TSE1234/CC00000  
Team ID = TSE1234
```

This represents your **Team ID**, which must be entered into the **Team ID** field in the provider configuration.&#x20;

***

#### Step 4: Adding Recipients

Once the **Team ID** information is filled in, proceed with the next configuration fields:

**Recipient Type:** Select who will receive the notification in Slack, choosing from the following options:

* **Channel:** If you want the notification to be directed to one or more Slack channels.

  * **Channel Name:** Enter the exact channel name as it appears in Slack (without the "#" symbol), then click **Add**.

  <figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FHlux0gqPHpnoIpTHJSBJ%2Fimage.png?alt=media&#x26;token=ae005574-868d-4647-996b-2806a8a29954" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
For this type of insertion, via the **Notification Group** functionality, public channels must be used for the configuration to work. In the case of private Slack channels, the procedure must be carried out within the Slack channel itself, by sending an invitation to the **PierCloudNotification** App.

In the private channel where you want to send the notification, enter the following command in the message input area, as shown below:\
`/invite @PierCloudNotification`

<img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2Fr4WxkEX8H0zPCpZUfaqq%2Fimage.png?alt=media&#x26;token=88552aca-2af9-4027-9839-af9205132ec1" alt="" data-size="original">

Once this is done, click **Send** or press **Enter** so that the message is sent and the App is added to the channel.

![](https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2FM4Pr5SIXYFSmYsyUeALA%2FCaptura%20de%20Tela%202025-09-19%20a%CC%80s%2018.15.54.png?alt=media\&token=039bfcd0-b514-4f1c-9f2d-d49a5eac96eb)
{% endhint %}

* **Users:** If you want the notification to be directed to one or more Slack users.

  * **User Name:** The username can be identified from the email used in Slack, considering only the part before the **@** symbol.\
    Example: if the email is `user@company.com`, the username should be entered as `user`. Then click **Add**.

  <figure><img src="https://1687673077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ9sinLUl52lDK1vg6b8g%2Fuploads%2F1lawXeY8o9nmPR7ucKoz%2Fimage.png?alt=media&#x26;token=559f2abd-d60a-478e-aaa2-644a2e6cbbd2" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
The system allows only one recipient type per provider registration.

* If you add a **channel**, it will block adding users.
* If you add a **user**, it will block adding channels.

To include both recipient types, you must create **two separate Slack provider registrations**: one with a channel and another with a user.
{% endhint %}

#### Step 5: Saving the Configuration

Once all required information is entered, click **Save**. The system will store the data and return to the main screen, where you can view the registered provider within the notification group.
