Slack

Introduction

Slack is a messaging program designed specifically for the office but has also been adopted for personal use. You can find more details and the supported operations on Slack | qibb Catalog.

How to get started with Slack integration

Before you get started using Slack integration please make sure that you have permission to manage applications in your workspace because you will need to create certain settings.

1. Visit Your Slack Apps page and select the Bot User you would like to use with qibb or set a new Bot by clicking on Create New App button. Navigate to Oauth & Permissions and Copy it. Bot token strings begin with xoxb-********.

   

2. Go to qibb Workflow Editor, open Node Catalog in the right sidebar, and install Slack icon by clicking on the + button.

3. Drag the Slack Auth node and Slack node from the left sidebar to your flow and connect them.

4. Enter your Bot User OAuth Token into the Slack Bot Token field of the Slack Auth node, and select any of the operations of the Slack node to start using the integration!

   

It is also possible to authenticate against Slack API via Bearer Authentication method. You can enter your Bot User OAuth Token into Advance/Security section of the node.

Please note that it is not currently possible to use Error Handling functionality by default, as the Slack API server always sends 200 status code responses. The server sends error messages in payload. E.g.

CODE

{"ok": "false", "error": "Error Message"}

If you want to use Error Handling, you need to add an additional node (such as a switch node or function node) after the Slack node to be able to receive errors from a separate output.

Using the node to interact with Slack channels

If you want to use the Slack node to post messages to a channel, you need to invite your previously created Slack App into the channel first. This just needs a few steps:

1. In Slack, choose the channel where you want to invite the app.

2. In the message field, type "@" followed by the name of the bot you created (e.g., "bnz"). You'll see a notification that the bot is not in the channel.

3. Send the message to the channel.

4. You'll receive a pop-up dialog to guide you in inviting the bot user to the channel.

5. That’s it! Now your node should be able to read or write to that channel.

Importing flow examples of a node

Once you've successfully installed a node from the qibb catalog, you can easily import example flows that showcase how the nodes can be used. These example flows are directly accessible within the Flow Editor and are designed to guide users with helpful hints, including how to configure mandatory parameters and credentials.

Here's how to import examples:

1. In the top right corner of the Flow Editor, click on the menu icon.

2. Select Import to open the Import Dialog.

3. Click on the Examples tab.

4. Choose an example from the list.

5. Confirm your selection by clicking on the Import button.

By following these steps, you are now ready to make basic API calls using the provided examples. For further exploration of what’s possible, you can find more complex examples in the Flow Catalog.