Telegram Bot Setup

HTTP API bot with polling/webhook support

Overview

The Telegram bot enables SingularCore to receive commands and send notifications through Telegram messaging platform. It supports both polling and webhook modes for maximum flexibility.

Difficulty

Easy

Setup Time

5 minutes

Notification Tiers

Normal, High, Urgent

Prerequisites

Telegram account
Python 3.9+
python-telegram-bot library

Create Bot with BotFather

Open Telegram and search for @BotFather
Send /start then /newbot
Name your bot (e.g., MySingularCore)
Choose username ending in bot
Save the bot token provided by BotFather

Get Your Chat ID

Option A: Via @userinfobot

Search for @userinfobot
Click Start
Copy your Chat ID

Configure Bot

Edit config/comms.json:

{
  "telegram": {
    "enabled": true,
    "bot_token": "YOUR_BOT_TOKEN",
    "allowed_chat_ids": ["YOUR_CHAT_ID"],
    "auto_setup": true
  }
}

Supported Commands

Command	Description	Tier
/status	System health check	0
/skills	List all skills	0
/approve	Approve pending action	1+

Troubleshooting

Bot Not Responding

Check bot token is correct
Verify bot is added to chat
Check allowed_chat_ids includes your ID

Documentation Menu

Back to Channels