Bots.Business API v2
  1. Bots.Business API v2
Bots.Business API v2
  • Bots.Business API v2
    • BB Api docs
    • Authentication
      • Sign in
      • Get Telegram login URL
      • Sign up
      • Telegram login
      • Reset Password
    • User account
      • Update password
      • Get user details
      • Update email
      • Get linked telegram accounts
      • Get telegram link url
      • Get users session token
      • Reset api key
      • Log out all device
      • Get iteration usage
      • Turn ON or OFF ads
      • Get payment plan
    • Bots
      • Create Bot
      • Get Bots
      • Get single bot
      • Edit Bot
      • Delete Bot
      • Start or Stop bot
      • Start CSV import
      • CSV import task status
      • Copy Bot
      • Git export
      • Git import
      • Get installed libraries
      • Install Lib
      • Uninstall lib
      • Get error log
      • Clear error logs
    • Commands
      • Folders
        • Create a folder
        • Get all folders
        • Delete a folder
      • Get Commands
      • Create Command
      • Get Command Details
      • Edit Command
      • Delete Command
    • Broadcast
      • Get broadcast tasks
      • Delete Broadcast task
      • Pause broadcast task
      • Resume broadcast task
    • Chats
      • Get chats
      • Block chat
      • Unblock chat
    • Properties
      • Get properties
      • Delete property
    • Libraries
      • Get libraries
    • Admin Panel
      • Get admin panels
      • Update admin panel values
    • Demo Store
      • Get store bots
      • Install demo bot
    • Get cloud plans
      GET
    • Schemas
      • Command Schema
      • User Public
      • Create & Edit Bot
      • Bot
  1. Bots.Business API v2

BB Api docs

Bots.Business API v2 is a production-ready REST API for building, running, and scaling Telegram bots from your own backend and tools. It covers the full lifecycle: authentication, bot creation and control, command management, broadcasting, chat moderation, configuration UIs, Git/CSV workflows, and access to a catalog of demo bots and libraries. The API is organized under api.bots.business/v2/....

What you can do#

Authenticate users with email/password or a Telegram deep-link flow. The Telegram flow returns a login URL and secret you redirect the user to, then you confirm login on your side.
Manage bots: create, edit, start/stop, copy; import/export from Git; bulk import via CSV; inspect and clear error logs.
Manage commands (CRUD) and folders to structure your bot logic.
Broadcast at scale and track task progress (active/completed).
Work with chats: list private/group chats, block/unblock when needed.
Ship configurable bots: expose settings via Admin Panels (typed fields, on-save hooks) and install reusable Libraries.
Start fast with a Demo Store of ready-made bots you can install via API.
Handle quotas & plans: read the current payment plan, toggle ads to raise iteration limits, and list cloud hosting plans.

Core concepts & endpoints (high level)#

Authentication
Email/password sign-in and session/token utilities.
Telegram Sign-In helper: POST /v2/tg_sign_in → returns a link and secret to complete login in Telegram.
Bots
Create/get/edit/delete; start/stop; Git import/export (/git_import_tasks, /git_export_tasks); CSV import and status; error logs.
Commands & folders
Organize bot logic with CRUD on commands and folders.
Broadcast
Query tasks: GET /v2/bots/{id}/broadcaster_tasks (progress, status, scope). Pause/resume/delete tasks as needed.
Chats
GET /v2/bots/{id}/chats returns private and group chats with user metadata. Block/unblock endpoints are available.
Admin Panels & Libraries
Admin Panels: deliver dynamic settings UIs (string/number/password/checkbox/text etc.) with optional command hooks on save.
Libraries: discover and install reusable modules (e.g., resources/balances).
Demo Store & Cloud
Demo Store collections: GET /v2/store/collections lists installable demo bots by category.
Cloud plans: GET /v2/clouds shows hosting options and specs.
Plans & quotas
Read your plan: GET /v2/user/payment_plan.
Toggle ads to increase iteration limits: POST /v2/user/iterations/toggle_ads.

Quickstart (cURL)#

Replace YOUR_API_KEY or use the sign-in / Telegram flow described in the docs.
List your bots
(See the Bots section for CRUD and start/stop.)
Get current payment plan
Check broadcast tasks for a bot
Install a demo bot (discover first)
(Then call the install endpoint for the selected demo bot.)
Raise iteration limits by enabling ads

When to use what#

Use Admin Panels if your bot needs an operator-friendly settings UI without rebuilding the app.
Use Libraries to avoid reinventing common features (e.g., balances/resources).
Use Git import/export for CI/CD and version control of bot code.
Use Broadcast for mass actions (announcements, command runs) with progress tracking.
Use the Demo Store to prototype quickly or as learning references.
Modified at 2025-11-02 09:04:30
Next
Sign in
Built with