Buzz8nAI

Your First Workflow

Create a simple workflow that sends you a Telegram message when you click a button. This tutorial takes about 5 minutes.

What you'll build: A workflow with a Manual Trigger that sends a message to your Telegram account.

Prerequisites

Before you begin, make sure you have:

  • A Buzz8n account (sign up if you haven't already)
  • A Telegram account and bot token (learn how to get one)

Step-by-Step Guide

1

Create a New Workflow

From your dashboard, click the "New Workflow" or "+" button in the top right corner.

Give your workflow a descriptive name like "My First Telegram Bot" and click Create.

Use clear names for your workflows so you can easily find them later!
2

Set Up Telegram Credentials

Before adding nodes, you need to set up your Telegram credentials:

  1. Click "Credentials" in the top navigation bar
  2. Click "Add Credential" or the "+" button
  3. Select "Telegram" from the provider list
  4. Give it a name like "My Telegram Bot"
  5. Paste your bot token in the token field
  6. Click "Save"
Don't have a bot token yet?

You need to create a Telegram bot first:

  1. Open Telegram and search for @BotFather
  2. Send the command /newbot
  3. Follow the prompts to name your bot
  4. Copy the bot token that BotFather gives you

Read the full guide

3

Understand the Manual Trigger Node

When you create a new workflow, Buzz8n automatically adds a Manual Trigger node. This is your starting point!

The Manual Trigger node starts your workflow when you click the play button.

Every workflow needs a trigger node. The Manual Trigger is perfect for testing and workflows you want to run on-demand.
4

Add a Telegram Node

Now let's add a node to send a Telegram message:

  1. Look for the + button on the right side of the Manual Trigger node
  2. Click it to open the node palette
  3. Search for "Telegram" or browse the actions
  4. Click "Send a message" to add it to your workflow

You'll see the Telegram node appear, connected to your Manual Trigger with a line (edge).

5

Configure the Telegram Node

Click on the Telegram node to open its configuration panel on the right side of the screen.

You'll need to fill in three fields:

1. Select Credential

Choose the Telegram bot credential you created in Step 2.

2. Chat ID

This is your Telegram user ID. To find it:

  1. Open Telegram and send any message to your bot
  2. Open this URL in your browser (replace YOUR_BOT_TOKEN):
https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates

Look for the "id" field under "chat" - that's your Chat ID!

3. Message

Type the message you want to send. For example:

Hello from Buzz8n! 🎉 My first workflow is working!
If you see a red warning icon on the node, it means some required fields are empty. Make sure all three fields are filled in!
6

Save Your Workflow

Before testing, save your work! Click the "Save" button in the top right corner.

You should see a success message confirming your workflow has been saved.

7

Test Your Workflow

Time to see your workflow in action!

  1. Click on the Manual Trigger node
  2. A Play button will appear on the left side of the node
  3. Click the Play button to run your workflow

Watch as your workflow executes! You'll see:

  • The nodes light up as they execute
  • A loading indicator while the message is being sent
  • A green checkmark when it's complete
Success! Check your Telegram - you should have received the message from your bot!
8

View Execution Logs

Want to see what happened behind the scenes?

  1. Look for the "Executions" tab at the bottom or right panel
  2. Click on the latest execution to see detailed logs
  3. You can see the input and output of each node
Execution logs are super helpful for debugging when things don't work as expected!

Troubleshooting

I'm not receiving the Telegram message

If you're not receiving messages, check these common issues:

  • Did you message your bot first? You must send at least one message to your bot before it can message you back.
  • Is your Chat ID correct? Double-check the ID by visiting the getUpdates URL again.
  • Is your bot token valid? Try sending a test request to the Telegram API to verify.
  • Check the execution logs for any error messages.
I see a red warning icon on my node

The red warning icon means your node configuration is incomplete. Click on the node to see which fields need to be filled in. All required fields must have values before the workflow can run.

The workflow execution failed with an error

Check the execution logs to see the specific error message. Common errors include:

  • Invalid bot token: Your credential might be incorrect
  • Invalid chat ID: Make sure you copied the correct ID
  • Network error: Check your internet connection
Congratulations!
You've created your first workflow! 🎉 You now know the basics of building automations with Buzz8n.

What's Next?

Now that you've mastered the basics, here are some ideas for what to learn next:

Use Webhooks

Learn how to trigger workflows from external services

Add AI to Your Workflows

Use AI agents to make your workflows smarter

Build a Full Telegram Bot

Create a bot that responds to commands and messages

Send Automated Emails

Set up email credentials and send automated emails