Skip to main content

DeBox Bot Development Overview

DeBox Bot Development Overview​

This is the bot overview guide for external developers, covering the full path from finding BotMother, creating/managing bots, and choosing webhook or long polling development with SDKs.

1. Find BotMother first​

You can open BotMother in 3 ways:

  1. Deep link: https://m.debox.pro/user/chat?id=u7ooqdjt&start=
  2. Address search: 0xda521900ac9dfeff8a8e692bb627ff8cd80a7b28
  3. DeBox AI assistant entry

Recommended sequence starts from AI assistant:

1.1 Find BotMother from AI assistant​

AI assistant entry

1.2 Enter BotMother conversation entry​

BotMother entry

1.3 Check BotMother command menu​

BotMother commands

2. Create a bot with BotMother​

Follow the instruction flow shown by BotMother. Typical flow:

  1. Trigger bot creation command.
  2. Set bot profile (name, avatar, description).
  3. Complete creation and enter bot management list.

3. Manage and update bot settings​

After creation, finish baseline settings first, then choose development mode.

3.1 Bot management home​

Bot management home

On this page you can:

  • View all bots
  • Enter a specific bot management page
  • Add or remove bots

3.2 Single bot management page​

Single bot management

On this page you can configure:

  • Bot profile (name, avatar, description)
  • Credentials (API Key, and App Secret when needed)
  • Webhook settings (App Domain, Webhook URL)

4. Choose one receiving mode (required)​

DeBox Bot supports two receive modes:

  • Webhook mode (platform pushes to your service)
  • Long polling mode (getUpdates pull)

They are strictly mutually exclusive:

  • If webhook is configured, webhook is the active receive path.
  • Long polling will receive none or near-none updates in that state.
  • To switch back to long polling, clear webhook config first.

5. Webhook mode​

Minimal setup steps:

  1. Configure App Domain in bot settings.
  2. Configure Webhook URL (public HTTPS endpoint).
  3. Implement callback API and validate X-API-KEY == Webhook Key.
  4. Handle payload and send replies with OpenAPI.

References:

6. Long polling mode​

Minimal setup steps:

  1. Ensure webhook is not configured.
  2. Initialize bot with API Key + API Secret via SDK.
  3. Enable listener and process updates from GetUpdates/GetUpdatesChan.
  4. Send replies using SDK/OpenAPI.

7. SDK options (3 official SDKs)​

  1. Go SDK:
  1. Nodejs SDK:
  1. Python SDK:

8. API reference boundary​

SDK docs focus on usage patterns, while OpenAPI is the source of truth for field constraints and response contracts.

Use together:

  1. Create bot in BotMother and complete baseline settings.
  2. Start with webhook for small-scale integration testing.
  3. Select Go/Nodejs/Python SDK by team stack.
  4. Validate all request/response details against OpenAPI.