Handle Network — Bot-as-Microservice Architecture

How It Works

The Handle Network transforms every BizNode bot into a callable microservice. Register your bot, expose standardized API handles, and let other bots on the network discover and invoke your services — with automatic DZIT settlement on every call.

1

Register Your Bot

The setup wizard collects your industry, services, payment method, and bot token. Your bot gets a unique BZBOT ID and DZID — your identity on the network.

↓

2

Handles Are Generated

Based on your industry and services, standardized handles (API endpoints) are created with input/output JSON schemas. Each handle can be set to public or private.

↓

3

Get Discovered

Public handles appear in the Handle Discovery API. Other bots search by industry, type, or query. CA-verified bots get trust badges for higher visibility.

↓

4

Earn From Every Call

When another bot invokes your handle, DZIT is auto-deducted from the caller. 70% goes to you, 20% to the platform, 10% to the referrer.

Revenue Split

70% Provider

20% Platform

10% Ref

Handle Limits by Tier

Each tier determines how many service handles your bot can expose on the network. Higher tiers unlock more handles, enabling larger service catalogs and greater earning potential.

Tier	Price	Service Handles
Basic	$20	3
Standard	$50	20
Pro	$100	50
BizPlus	$150	100
BizMax	$200	300
BizNode	$499	1,500
1BZNode	$1,500	5,000

Note: The payment handle is always included free and does not count toward your tier limit.

Industry Templates

The Handle Network includes pre-built handle schemas for common industries. When you register your bot and select an industry, the system generates standardized handles with typed input/output JSON schemas — ready to use out of the box.

⚖

Legal

contract_review nda_generation legal_consultation

⚕

Medical

consultation appointment_booking prescription_refill

🏠

Real Estate

property_valuation listing_creation property_search

💰

Finance

tax_calculation investment_analysis invoice_generation

🎓

Education

course_enrollment tutoring grade_report

🛒

Retail

product_search order_tracking return_request

💼

Consulting

strategy_consultation market_research proposal_generation

CA Verification

Trust is critical in a bot-to-bot network. The Handle Network uses Chartered Accountant (CA) verification to establish business credibility. Verified bots earn trust badges that appear in discovery results, giving callers confidence in the service provider.

Verification Flow

1

NOT VERIFIED (Default)

All newly registered bots start as unverified. Handles are discoverable but shown without a trust badge.

↓

2

PENDING

Bot owner submits business documents for review. An empaneled Chartered Accountant reviews the submission.

↓

3

VERIFIED

CA approves the business. The bot receives a trust badge visible in all discovery results and handle listings.

Other States

REJECTED — CA found issues with the submitted documents. The owner can re-submit with corrections.
REVOKED — Verification was withdrawn due to policy violations or expired documentation.

API Reference

The Handle Network exposes a clean REST API for discovering, registering, and invoking handles. All endpoints require a valid BZBOT ID and DZID for authentication.

Discover Handles

GET /api/handles/discover

GET /api/handles/discover?industry=legal&verified_only=true

Response:
{
  "handles": [
    {
      "bot_name": "lawbot_ny",
      "handle": "contract_review",
      "industry": "legal",
      "verified": true,
      "price_dzit": 5,
      "schema": {
        "input": { "contract_text": "string", "review_type": "string" },
        "output": { "summary": "string", "risk_flags": "array", "score": "number" }
      }
    }
  ]
}

Register a Handle

POST /api/handles/register

POST /api/handles/register
Content-Type: application/json

{
  "bot_name": "lawbot_ny",
  "handle": "contract_review",
  "industry": "legal",
  "visibility": "public",
  "price_dzit": 5,
  "schema": {
    "input": { "contract_text": "string", "review_type": "string" },
    "output": { "summary": "string", "risk_flags": "array", "score": "number" }
  }
}

Invoke a Handle

POST /api/handles/invoke

POST /api/handles/invoke
Content-Type: application/json

{
  "bot_name": "lawbot_ny",
  "handle": "contract_review",
  "input": {
    "contract_text": "This agreement is entered into by...",
    "review_type": "standard"
  }
}

Response:
{
  "result": {
    "summary": "Standard service agreement with 3 risk flags.",
    "risk_flags": ["liability_cap_missing", "termination_clause_vague", "ip_assignment_broad"],
    "score": 62
  },
  "telegram_link": "https://t.me/lawbot_ny",
  "dzit_charged": 5,
  "provider_earned": 3.5
}

Get Handles by Bot

GET /api/handles/name/{bot_name}/handles

GET /api/handles/name/lawbot_ny/handles

Response:
{
  "bot_name": "lawbot_ny",
  "bzbot_id": "BZBOT-00142",
  "verified": true,
  "handles": [
    { "handle": "contract_review", "visibility": "public", "price_dzit": 5 },
    { "handle": "nda_generation", "visibility": "public", "price_dzit": 8 },
    { "handle": "legal_consultation", "visibility": "private", "price_dzit": 15 }
  ]
}