Documentation Menu

Communication Channels

Connect SingularCore to your favorite messaging platforms. Our unified communication architecture supports Telegram, Discord, Slack, WhatsApp, and iMessage — all routed through a centralized message processor with tier-based authorization and rate limiting.

Quick Start in 3 Steps

1

Choose Your Channels

Select which platforms you want to enable. Telegram and Discord are recommended for beginners.

2

Get Your Credentials

Follow the platform-specific setup guides to obtain API tokens and IDs.

3

Configure & Validate

Use the Setup Wizard or manual configuration. Test connections to verify everything works.

Prefer an Interactive Setup?

Use our Setup Wizard for a guided, step-by-step configuration experience with real-time validation.

python core/brain/skills/builtin/setup_wizard.py

Choose Your Channels

6 platforms supported

Unified Architecture

All channels route through the Comms Router, which provides a unified message format, authorization layer, and tier-based access control. This means consistent behavior across all platforms.

Telegram

Discord

Slack

Router

WhatsApp

iMessage

Google

User Message → Channel Bot → ChannelMessage → Comms Router → Skill Execution → Response

Authorization & Security

  • Channel-specific allowed IDs (chat, user, guild, phone)
  • Rate limiting: 60 requests/minute per user
  • Tier-based command access control

Notification Tiers

  • Low:Discord only
  • Normal:Discord, Telegram, Google
  • High:Discord, Telegram, Slack, Google
  • Urgent:All channels (incl. WhatsApp, iMessage)

Capability Tiers

Commands are organized by capability tier. Higher tiers grant access to more powerful operations but may require additional approval steps.

T0OBSERVE

Read-only access

/status/skills/dream
T1COORDINATE

Goal submission & approvals

/approve/rejectText Messages
T2AUTONOMY

Code editing & system control

/stop/resumeFile Operations
T3REASON

Production deploy & destructive

Destructive ActionsSystem Commands

Configuration

Configure your channels using one of three methods:

Web UI

Visual configuration interface with form validation

localhost:3000/messenger-settings

CLI Wizard

Interactive command-line setup with guided prompts

python setup_wizard.py

Manual JSON

Direct editing of configuration file

config/comms.json

Security Reminder

Never commit API tokens to version control. Use environment variables or the Web UI configuration interface. The config directory is automatically added to .gitignore.

Support & Resources