Slack | Engini

Discover how to effortlessly connect Engini to Slack. Engini’s Slack connector enables seamless integration, allowing you to send messages, retrieve channel data, and manage Slack interactions directly within your workflows. Streamline communication and enhance productivity with this powerful integration.

Getting Started with Slack #

Prerequisites #

A Slack account.

Connecting Engini to Slack #

Enter your Engini account at https://app.engini.io.
Navigate to Connections page by clicking on the Connections on the left side bar or by clicking here.
Click on the “Add connection” option located at the top bar.
Choose Slack option from the available applications.
Enter the following details in the “Add Connection” form:
- Connection name.
- Connection Type:
  - User: Connects Engini to Slack using a specific user’s permissions, allowing workflows to perform actions on behalf of that user.
  - Bot: Connects Engini to Slack through a bot, enabling workflows to interact with Slack channels and users autonomously, without relying on a specific user’s permissions.
- Access Token:
  - A credential used to authenticate and authorize access to Slack’s API. Depending on your connection type (user or bot), the token grants Engini the necessary permissions to perform actions within your Slack workspace.
- Click on the Save button to save the connection.
- Sign in to your Slack account, review the requested permissions, and click “Allow” to grant Engini access to interact with your Slack workspace.

Triggers #

Actions that initiate or “trigger a workflow. There are three types of triggers related to Slack Connection:

Check for New Files #

Triggers the workflow when a new file is uploaded.

Channel Type: Choose the type of Slack channel where the trigger will be active: Direct Messages, Multiparty Direct Messages, Private Channel, or Public Channel.
Channel ID: Select the specific channel ID where the trigger will be applied.
File Types: You can choose to monitor all file types or specify individual types such as Spaces, Snippets, Images, GDocs, ZIPs, and PDFs.
Select Time Frame: Define when the trigger should start and how often it should run.
Top N Condition (Optional): You can add an additional condition to limit the trigger to the top N results if you want to retrieve a specific number of data items.

Check for New Messages #

Triggers the workflow when a new message is posted in a selected Slack channel.

Channel Type: Choose the type of Slack channel where the trigger will be active: Direct Messages, Multiparty Direct Messages, Private Channel, or Public Channel.
Channel ID: Select the specific channel ID where the trigger will be applied.
Select Time Frame: Define when the trigger should start and how often it should run.

Check for User Updated #

Triggers the workflow when users are created or updated across the entire Slack workspace.

Select Time Frame: Define when the trigger should start and how often it should run.

Actions #

Specific tasks you want to perform in your Slack workspace through Engini. These actions can automate communication, manage files, or interact with channels and users within Slack.

Add Member to a Channel #

Adds a specified user to a selected Slack channel.

Channel ID: Select the specific channel where you want to add the user.
Users: Choose the user you want to add to the selected channel in your Slack workspace.

Create Conversation #

Creates a new Slack channel with a specified name, and optionally sets it as private or public.

Name: Choose the name for the new channel.
Create Private Channel (Boolean): Set to true if you want the channel to be private, or false for a public channel.

Create Message #

Sends a new message to a specified Slack channel, with options to customize the bot’s username, include rich formatting blocks, and more.

Channel ID: Specify the channel where the message will be posted.
Text: Enter the content of the message.
Additional Fields:
- Bot’s Username: Select the bot’s username that will post the message.
- Blocks: Add blocks to structure the message with rich formatting.
- Icon Emoji: Choose an emoji to represent the bot’s icon.
- Markup Parsing: Specify whether to parse the message text using Slack’s markup.
- Icon URL: Provide a URL for a custom icon to be used with the bot.
- Reply Broadcast: Set whether replies to this message should be broadcasted to the entire channel.
- Parse: Define how Slack should parse the message

Update Message #

Updates the content of an existing message in a Slack channel.

Channel ID: Select the channel where the message you want to update is located.
Timestamp of Message: Enter the timestamp of the message you want to update.
Enter Text: Input the new text that will replace the current message content.

Get Channels #

Downloads a file from Slack using a private URL.

Channel Types: Enter a comma-separated list of channel types (use concat if needed) to specify which types of channels to retrieve.
Filter Options:
- Team ID: Specify the team or workspace ID to filter the channels.
- Exclude Archived: Set a condition to exclude archived channels from the results.
Top N: Enter the total number of channels to retrieve (default is unlimited).

Get Members in a Channel #

Retrieves a list of members in a specified channel.

Channel ID: Select the ID of the channel from which you want to retrieve the list of members.

Get Messages #

Retrieves messages from a Slack channel based on selected filters.

Channel ID: Select the ID of the channel from which you want to retrieve messages.
Filter Options:
- Include All Metadata: Choose whether to include all metadata in the retrieved messages.
- Inclusive: Specify additional inclusive filters for the messages.
- Latest: Filter messages to retrieve only those sent before this specified timestamp.
- Oldest: Filter messages to retrieve only those sent after this specified timestamp.
Top N: Enter the total number of messages to retrieve (default is unlimited).

Get Message #

Retrieves messages from a Slack channel starting from a specified timestamp.

Channel: Select the channel from which you want to retrieve messages.
Oldest: Specify the earliest timestamp to filter messages, retrieving only those posted after this timestamp.

Search For a Message #

Searches for messages in Slack based on keywords and additional filters.

Search Query: This is the keyword or phrase you want to search for within messages in your Slack workspace. It helps you find specific messages that contain the words or terms you’re looking for.
Filter Options:
- Highlight: Set to true to enable query highlight markers.
- Sort: Choose how to sort the search results, either by score or timestamp.
- Sort Dir: Select the direction to sort the results, either ascending or descending.
- Team ID: Provide the encoded team ID to narrow down the search within a specific team.

Get User #

Retrieves user details based on the user ID.

User ID: Select the ID of the user you want to retrieve information for.

Get Users #

Retrieve a list of users and their details in your Slack workspace.

Invite User to Conversation #

Invites users to a conversation in a specified channel.

Channel ID: Select the ID of the channel where you want to invite the user.
User(s) ID: Select the ID(s) of the user(s) you want to invite to the conversation.

Get Replies #

Retrieves replies to a specific message in a Slack channel.

Channel ID: Select the ID of the channel from which you want to retrieve replies.
Parent Message ID (ts): Enter the timestamp (ts) of the parent message for which you want to retrieve replies.

Filter Options:
- Include All Metadata: Set a condition to include all metadata in the retrieved replies.
- Inclusive: Apply a condition to include messages with the oldest or latest timestamps.
- Latest: Filter replies to retrieve only those sent before a specific timestamp.
- Oldest: Filter replies to retrieve only those sent after a specific timestamp.
Top N: Enter the total number of replies to retrieve (default is unlimited).

Set Conversation Topic #

Sets or updates the topic of a conversation in a Slack channel.

Channel ID: Select the channel for which you want to set the topic.
Topic: Enter the topic you want to set for the selected channel.

Set Conversation Purpose #

Sets or updates the purpose of a conversation in a Slack channel.

Channel: Select the channel for which you want to set the purpose.
Purpose: Enter the purpose or description you want to set for the selected channel.

Get Reactions #

Retrieves reactions (emojis) to a specific message or file.

Channel: Select the channel where the message or file is located.
File: Specify the file for which you want to get reactions.
File Comment: Specify the file comment for which you want to get reactions.
Full: Set to true if you want to always return the complete reaction list.
Timestamp: Enter the timestamp of the message for which you want to retrieve reactions.

Get Files #

Retrieves files from a Slack channel based on selected criteria.

Filter Options:
- Channel ID: Specify the channel ID to filter files from a particular channel.
- File Types: Choose the types of files to retrieve (e.g., images, documents).
- Show Files Hidden by Limit: Option to display files that are normally truncated by limits.
- Team ID: Specify the team or workspace ID to filter the files.
- Timestamp From: Filter files created after this specific timestamp.
- Timestamp To: Filter files created before this specific timestamp.
Top N: Enter the total number of files to retrieve (default is unlimited).

Upload a File #

Uploads a file to a specified Slack channel, with options to include a message and specify file details.

Channel ID: Select the channel where the message you want to update is located.
Timestamp of Message: Enter the timestamp of the message you want to update.
Enter Text: Input the new text that will replace the current message content.

Download File #

Downloads a file from Slack using a private URL.

URL Private Download: Enter the private download URL of the file you want to download.

Delete a File #

Deletes a specific file from the Slack workspace.

File ID: Enter the ID of the file you wish to delete from the Slack workspace.

Delete Message #

Deletes a specific message in a Slack channel based on its timestamp.

Channel ID: Enter the ID of the channel where the message you want to delete is located.
Timestamp of Message: Enter the timestamp of the message you wish to delete.

Create Reminder #

Creates a new reminder with specified text and time.

Text: A field to enter the reminder text.
Time: A field to specify the time for the reminder.
Additional Fields:
- Frequency: Select how often the reminder should occur.
- Weekdays: Choose specific weekdays for the reminder.
- Team ID: Select the team or workspace ID associated with the reminder.
- User: Choose the user to whom the reminder will be sent.

Get Reminders #

Retrieves a list of reminders based on the selected team ID.

Filters:
- Team ID: Select the team or workspace ID to filter and retrieve reminders specific to that team.

Delete Reminder #

Deletes a specific reminder by its ID.

Reminder: Enter the ID of the reminder you wish to delete.
Team ID: Specify the team or workspace ID associated with the reminder.

Archive Conversation #

Archives a specified Slack channel, making it read-only and removing it from active channel lists.

Channel ID: Select the channel you want to archive.

Unarchive Conversation #

Restores a previously archived Slack channel, making it active and accessible again.

Channel: Choose the channel you want to unarchive.

Append Block to Blocks Array #

Adds a new block to an existing array of blocks in a Slack message, allowing for enhanced formatting and interactive content.

Map the blocks to be combined with messages to create visually engaging and interactive content. For more details on text formatting, please consult the Slack documentation.

How can we help you?