# 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**
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.fylamynt.com/integrations/slack.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.