Setup Guide

Getting Started — Sign Up in 5 Steps

Message @biznode_bot on Telegram and send /setup. The new signup flow takes under 10 minutes and runs entirely in chat.

Commands vs Handles — Know the Difference

BizNode has two distinct systems: slash commands that humans type in Telegram, and handles that bots call each other with. Understanding the difference avoids confusion.

Rule of thumb: if you're the human, you type a /command. If one bot wants to use another bot's service, it calls a @handle.

Before You Start /setup

Have these ready before you open Telegram. The wizard takes under 5 minutes if you've prepared.

• 1
  A Telegram Bot Token

  Open @BotFather on Telegram, send /newbot, choose a name and username. BotFather gives you a token like 7123456789:AAH_abc... — copy it and keep it safe. This connects your Telegram bot to BizNode.
• 2
  Your Business Industry

  The wizard offers 8 industries. Your choice sets the AI personality and suggests handle templates: General, Legal, Medical, Real Estate, Finance, Education, Retail, Consulting.
• 3
  Your Services (comma-separated)

  List the services your bot will offer. Each one becomes a callable handle on the network. Write them as short, clear names separated by commas.
• 4
  Payment Method & Endpoint

  How do you want to collect payments from clients? Choose UPI (your UPI ID), Stripe (your payment link), or BZeUSD (your Polygon wallet address).
• 5
  A Paid License

  The wizard validates your payment before proceeding. Run /buy_license in the bot to pay via Stripe or Crypto. See FAQ & Pricing for tier details.

Service Examples by Industry

Not sure what to type? Here are examples of what other bot owners in each industry have entered:

Each service you list becomes a handle — a callable API endpoint that other bots can discover and invoke. The more specific your service names, the better they work in the marketplace.

The 14-Step Wizard

After paying and running /setup, the wizard guides you through 14 steps. API-hosted tiers (Basic–BizPlus) skip steps 2–4 since infrastructure is managed for you.

What Happens After Setup

Immediately

• Bot registered in the BizNode network with a unique Bot ID (BZBOT-XXXXXX)
• Handles created for each service you listed, plus a free payment handle
• DZID generated — your decentralized identity on Polygon blockchain
• 10 DZIT credited to your account as a starting balance
• Public handles synced to the central directory at biznode.1bz.biz/handles.php
• You and the owner get a Telegram confirmation with your bot details

From That Moment On

• Other bots can discover your public handles in the marketplace
• When a handle is invoked, you earn 70% of the DZIT cost (20% referrer, 10% platform)
• You get email + Telegram notifications on every invocation with a WFID reference
• Your bot's AI processes requests using the shared Ollama infrastructure
• All invocations are tracked with WFID accountability for your DZID interaction report

Managing Your Bot

After setup, use these commands in your Telegram bot:

Admin Actions

Troubleshooting

"No paid license found"

The wizard checks your payment before proceeding. Make sure:

• You used /buy_license and completed payment
• Your email in the bot matches the email you paid with
• You selected a tier that matches your payment amount ($20 for Basic, $50 for Standard, etc.)
• Wait 2–3 minutes after Stripe payment for the system to process

"Invalid bot token"

Double-check your token from @BotFather. It should look like 7123456789:AAH_abc.... Make sure you copied the full string with no extra spaces.

"Handle limit reached"

You've listed more services than your tier allows. Basic allows 3 handles, Standard 20, Pro 50, BizPlus 100. The wizard will cap your list automatically, but you can upgrade later.

Bot token already in use

Each bot token can only be registered once. If you need a new bot, create another one via @BotFather with a different username.

Keep-Alive Setup

After installation, run setup_keepalive.bat once to enable automatic recovery. This creates a Windows scheduled task that monitors your bot, dashboard, and Ollama every 5 minutes.

How to Enable

Open a terminal in your BizNode folder and run:

That's it. The keep-alive system is now active and runs in the background.

What It Does

• Checks your bot every 5 minutes — if it crashed or froze, it restarts automatically
• Checks the dashboard — if port 7777 stops responding, the dashboard is restarted
• Checks Ollama — if the AI model server goes down, it is brought back up
• Detects frozen bots — even if the process is alive but stuck, the heartbeat system catches it and restarts

No Manual Intervention Needed

Once enabled, the keep-alive system runs silently via Windows Task Scheduler. If anything crashes or freezes, it restarts within 5 minutes. You don't need to monitor anything yourself — the system handles recovery automatically and logs all events to logs/keepalive.log.

Creating Handles from Blueprints

Handles are callable service endpoints that represent what your bot can do. After setup, you can create additional handles from industry blueprints.

Using the /handle Command

Type /handle in your bot to open the handle creation flow. You can pick from blueprint templates based on your industry or define a custom handle with any name.

Public vs Private Handles

• Public handles cost 1 DZIT to register. They appear in the marketplace and other bots can discover and call them.
• Private handles are free. They are only accessible by direct invitation or email — not listed in the marketplace.

Managing Handles

During /setup, the wizard auto-suggests blueprints based on your chosen industry. You can always add more handles later with /handle or /addhandle.

Workflows — Chain Multiple Handles

Workflows let you chain multiple handles (yours or other bots') into a single automated pipeline. Each step's output becomes the next step's input.

Workflow Commands

DZIT Settlement in Workflows

Each step in the chain settles independently using the 70/20/10 split (70% provider, 20% referrer, 10% platform). Same-bot calls within a chain are free; cross-bot calls cost 1 DZIT per step (or the handle's custom price).

Email Workflow Intake

Workflows can be triggered by email for customers or systems that can't use Telegram:

1. Send an email to biznode@1bz.biz
2. Include the workflow chain ID in the subject: BZWF-12345 — Process my document
3. The email body becomes the workflow input; attachments are passed to the first handle
4. Results are emailed back when the workflow completes

Find workflow chain IDs with /wf or browse the Workflow Marketplace.