The Beginner Guide Tutorial covers the most fundamental yet essential steps for newcomers to Agentria.

In this tutorial, you’ll learn how to activate the Slack Node, connect it with your Slack workspace, and create an Ability that sends a message through a bot.

Prerequisites

Before getting started, create a project in Agentria and open the Ability Editor Canvas.

For detailed instructions on accessing the canvas, refer to Step 1 (Create a Project and Select an Editor) in the Get started in 3-Steps.

By completing this tutorial, you will be able to:

1. Add nodes

2. Declare variables in the Start Node

3. Connect nodes

4. Register Slack credentials

5. Add a Slack app and link your workspace

6. Configure credentials in the Slack Node

7. Set up a bot message in the Slack Node

8. Run a test to verify workflow execution results

Step 1: Create Slack OAuth and Credentials

To use the Slack Node, you must configure credentials based on an authentication key.

A Slack access token can only be issued through the OAuth flow.

If this is your first time setting up Slack OAuth, refer to the Slack Credential Guide.

Credentials are authentication details required to verify users and grant access to a system or service.

For this tutorial, when registering you credential, set the template to Slack.

Step 2: Add a Slack Node

Click the +Add Node button at the bottom of the canvas, then open the Tools category in the sidebar.

Select the Slack Node and place it on the canvas using drag and drop.

Hover over the node and click the Edit button to open the options panel.

Rename the node to Send Slack Node.

Since the Slack Node supports multiple actions such as Send, Update, Delete, and List, it’s recommended to rename the node based on its intended operation.

Step 3: Declare Input Variables

By default, the Agentria canvas includes one Start Node and one End Node.

• The Start Node initiates the entire workflow.

• The End Node terminates the workflow.

Double-click the Start Node to open its editor.

Here, you can configure the data type, name, and description of each variable.

In this tutorial, since we’ll be sending a bot message, set the data type to String and declare the following variables:

• Channel

• Text

After declaring the variables, return to the editor canvas.

Step 4: Connect Nodes with an Edge

To use the variables received from the Start Node in the Slack Node, you need to connect the two nodes using an edge.

Connect the Out-Pin on the right side of the Start Node to the In-Pin on the left side of the Slack Node.

This connection passes the input values from the Start Node directly to the Slack Node.

Step 5: Configure the Slack Node

Double-click the Slack Node to open the node editor.

Select the previously registered Slack Credential to load it into the node.

The Slack Node allows you to define how the bot will be used through the Task setting.

Since this tutorial focuses on sending bot messages, select Send Message.

In the Start Node, we declared the channel name(Channel), and message content(Text) as variables to send a bot message.

To use these input values, you’ll need to map them as adapter variables.

Click Show Optional Variables, then click +Add Optional Variables to view available Slack options.

Select channel and text.

Step 6: Bind Variables via Drag and Drop

In Agentria, variables can be connected effortlessly without writing any code — simply use drag and drop.

Match the input variables from the Start Node to the adapter variables as follows:

• channel: Channel

• text: Text

The Slack Node outputs data in JSON format by default.

Step 7: Configure Slack Workspace

7-1 ) Copy the Channel ID

This tutorial is based on the Slack desktop version.

In the Slack application, open the channel or direct message window where the bot will send messages.

Click the More options button in the top-right corner of the message window.

Then, click Open channel details.

When the popup window appears, copy the Channel ID.

You’ll use this value in Step 7.

7-2 ) Invite the Bot

By following the Slack Credential Guide, you’ll have already configured a Slack bot that can send messages.

Using the bot’s name, invite it to the desired channel or direct message window.

You can check the bot’s name in the App Home tab on the Slack API site.

메시지 입력창에 봇의 이름을 @이름 형식으로 검색하고 엔터(Enter)키를 누른 뒤 메시지를 전송하여 초대합니다.

팝업창에서 채널에 추가(Add to Channel) 버튼을 클릭합니다.

만약 해당 과정이 원활하게 진행되지 않는다면 슬랙 API 사이트 앱 홈(App Home) 탭에서 내 봇 항상 온라인 상태 표시(Always Show My Bot as Online) 토글을 활성화한 후 초대를 다시 진행합니다.

In the message input field, search for the bot using the format @bot-name , press Enter, and send a message to invite it.

Then, click Add to Channel in the popup window.

If the invitation doesn’t work properly, go to the App Home tab in the Slack API site and toggle on Always Show My Bot as Online, then try inviting the bot again.

Step 8: Run a Node Test

After completing the setup, click the TEST button in the Input section of the node editor to perform a node test.

A node test allows you to verify the functionality of an individual node within the editor.

By testing nodes independently, you can ensure they are configured correctly before connecting them — minimizing errors and maintaining stable workflow execution.

Enter the channel and text values, then click Test.

The result section will display the transmission details.

• In the Channel field, enter the Channel ID you copied in Step 6.

• In the Text field, enter the message content you want the bot to send.

If the bot successfully sends a message in the invited channel or direct message window, the node has been configured correctly.

Step 9: Connect the End Node

Pass the Slack message delivery result to the End Node.

Return to the canvas and connect the Slack Node to the End Node using an edge.

Double-click the End Node to open its editor, then add a variable named Result with the JSON data type.

Select or drag and drop the result variable (which contains the output from the Slack Node) and connect it to the Result variable.

Your ‘Send Slack Message’ workflow is now complete.

Step 10: Run the Full Workflow Test

Click the Run Test button in the bottom-right corner of the canvas to execute the complete workflow.

Enter the channel and text values in the input fields, then click Test.

The result field will display the transmission details.

If the bot successfully sends a message to the invited channel or direct message window, your node has been configured correctly.

Next Step

🎉 Congratulations! you’ve completed your fourth Agentria workflow — ‘Send Slack Message.’

Now, try applying different configurations, reviewing the results, and adding more variables to expand your workflow.

Agentria is a space where ideas turn into reality.

With your imagination, workflows can expand infinitely.

For more beginner-friendly examples, visit the Beginner Guide page.