BotDeckEmperor Smart Solutions
Developer Documentation

BotDeck REST API Reference

Programmatically manage bots, VIP subscribers, broadcasts, and inbox threads with scoped tenant API keys.

Open Interactive Swagger

API Key Authentication

Generate bdk_live_... keys inside Dashboard → Settings → Developer API. Pass via x-api-key header.

Strict Tenant Isolation

Every API key is scoped strictly to its workspace organizationId and respects suspension policies.

Base URL

https://botdeck.emperorsmartsolutions.com/api/v1

1. Authenticate Requests

curl -X GET "https://botdeck.emperorsmartsolutions.com/api/v1/bots" \
  -H "x-api-key: bdk_live_YOUR_GENERATED_API_KEY" \
  -H "Content-Type: application/json"

2. Trigger a Segmented Broadcast

curl -X POST "https://botdeck.emperorsmartsolutions.com/api/v1/campaigns" \
  -H "x-api-key: bdk_live_YOUR_GENERATED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "botId": "<YOUR_BOT_ID>",
    "name": "Weekly Market Digest",
    "messageText": "Your VIP analysis report is live.",
    "audienceType": "VIP_ACTIVE"
  }'

3. Core Endpoint Map

MethodEndpointDescription
GET/api/v1/botsList connected official Telegram bots
GET/api/v1/bots/chatsList detected Channels & Supergroups
GET/api/v1/vip/plansList Paid VIP subscription plans
GET/api/v1/vip/subscriptionsQuery active/expired VIP subscribers
GET/api/v1/inbox/conversationsFetch shared inbox threads
POST/api/v1/inbox/conversations/:id/messagesSend Bot DM or Business DM reply
POST/api/v1/campaignsEnqueue immediate or scheduled broadcast