# Slack
## Overview
One of the most common workflow integrations is the connection to user's communication suite. Slack is arguably the most popular communication tool.
This integration is a path forward for users who want to connect to their Slack workspace with the Fylamynt platform to interact with workflows, get execution statuses, approvals etc.
## Use Cases
The integration between Fylamynt and Slack lets you:
* Send notifications, message from Fylamynt workflows to Slack.
* Manage Fylamynt workflow approvals via direct messages to the Slack Team.
## Configure Slack in Fylamynt
* Navigate to **Settings** > **Integrations** > **Slack**.
* Configure a new integration instance.
* In **Slack Integration** page(Fylamynt), click “Add to Slack” button.
* You may be prompted to log into your Slack workspace. If not, verify that you are logged into the Slack workspace that you want to add Fylamynt to.
* Review the permissions required to install **Fylamynt** and click **"Allow"**.
* If installation is successful, you will be redirected back to the **Slack Integration** settings page of your Fylamynt instance.
* After installation, invite **"@Fylamynt"** Slack bot user to the Slack channel(s) where you would like to receive messages on.
## Interaction Actions
You can add these actions in the Fylamynt workflow builder, as part of your workflow.
1. [Approval](#approval)
2. [Slack Add Users](#slack-add-users)
3. [Slack Archive Channel](#slack-archive-channel)
4. [Slack Create New Channel](#slack-create-new-channel)
5. [Slack Send Message](#slack-send-message)
### Approval
Approve or Deny any request to continue the execution of a workflow.
**Input**
| **Parameter** | **Description** | **Required** |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------- | ------------ |
| alias | The target account for the run | True |
| Slack Channel | Select the Slack channel to notify for approval | True |
| Notes for Reviewer | This notes will be attached to the Slack message that request the approval. This message should give the user more context. | True |
| Timeout Interval | Specify an interval before timing out the request. The maximum timeout is 7 days. | True |
**Output**
| **Parameter** | **Type** | **Description** |
| -------------------- | -------- | ------------------------------------------------------------------------------------------------- |
| alias | String | The target account for the run |
| Execution Start Time | String | A string representation of time when the execution started. i.e *Wed 12 May 2021 22:52:46.441000* |
| Message Channel ID | String | The ID of the Slack channel where the message was sent. |
| Message Timestamp | String | Timestamp of the Slack message that was sent for approval. |
| Workflow Name | String | Name of the workflow associated with the execution. |
**Action Example**
### Slack Add Users
Add users to a previously created Slack channel.
**Input**
| Parameter | Description | Required |
| ------------ | --------------------------------------------------------- | -------- |
| Channel Name | The name of the channel to add the users. | True |
| Users | Dropdown list of Slack users to add to the above channel. | True |
**Output**
| Parameter | Type | Description |
| --------- | ------ | ------------------------------------------------------------ |
| message | String | List of the Slack User IDs of the users added to the channel |
**Action Example**
### Slack Archive Channel
Archives a specified Slack channel. Archived channels can still be searched, but are closed to any new activity.
**Input**
| Parameter | Description | Required |
| ------------ | ----------------------------------- | -------- |
| Channel Name | The name of the channel to archive. | True |
**Output**
| Parameter | Type | Description |
| --------- | ------ | ------------------------------ |
| message | String | Status of the archive command. |
**Action Example**
### Slack Create New Channel
Create a new slack channel. *Note*:The Fylamynt Slack bot user will be automatically added to any channel created using this action, public or private. This allows the other Slack actions to see the channel.
**Input**
| Parameter | Description | Required |
| ------------ | ---------------------------- | -------- |
| Channel Name | The name for the new channel | True |
| Private | Make the new channel private | False |
**Output**
| Parameter | Type | Description |
| ------------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| channel | Object | The output of the Slack conversations.create api call.
Channel names may only contain lowercase letters, numbers, hyphens, and underscores, and must be 80 characters or less.
|
| channel\_url | String | A URL for the newly created channel |
**Action Example**
### Slack Send Message
Send Slack messages to a given channel.
**Input**
| Parameter | Description | Required |
|---|
| Parameter | Description | Required |
| Slack Channel | Name of the Slack channel where we need to send the Slack message | True |
| Message Text | The message to be sent to the channel. | True |
**Output**
There is no output of this action.
**Action Example**
