Skip to main content
Gateway agents automatically know where a message came from and which channels they can deliver to — no extra code required. 
from praisonai.bots import Bot
from praisonaiagents import Agent

agent = Agent(
    name="gateway",
    instructions="Help users across platforms.",
)

bot = Bot("telegram", agent=agent)
bot.run()
The user messages on Telegram; the gateway agent replies with platform-aware routing.

​
Quick Start

1

Simple Usage

from praisonai.bots import Bot
from praisonaiagents import Agent

agent = Agent(
    name="gateway",
    instructions="Help users across platforms.",
)

# Token from TELEGRAM_BOT_TOKEN env var
bot = Bot("telegram", agent=agent)
bot.run()
The agent’s system prompt automatically includes the source platform, chat type, and reachable delivery targets.
2

With Configuration

Add a channel directory for cross-platform delivery:
from praisonai.bots import Bot
from praisonai.bots.delivery import ChannelDirectory
from praisonaiagents import Agent

agent = Agent(
    name="gateway",
    instructions="Help users and post summaries to Slack when asked.",
)

directory = ChannelDirectory()
directory.set_home_channel("slack", "C0123456")
directory.add_alias("team", "slack", "C0123456")
directory.add_alias("ops", "discord", "987654321")

bot = Bot("telegram", agent=agent, channel_directory=directory)
bot.run()

​
How It Works

StepWhat Happens
Origin detectiondetect_chat_type(platform, chat_id) classifies as group, direct, channel, or unknown
Target listingChannelDirectory.describe_targets() lists home channels and aliases
Prompt injectionA ## Session Context block is appended per turn
Agent respondsThe agent uses context to reply here or deliver elsewhere
Prompt injection happens after the system prompt cache boundary — the per-turn ## Session Context block is never cached.

​
Configuration Options

​
BotSessionManager

OptionTypeDefaultDescription
channel_directoryChannelDirectoryNoneNamed aliases and home channels for delivery
inject_session_contextboolTrueWhen False, suppress per-turn prompt injection

​
BotConfig media

OptionTypeDefaultDescription
max_inbound_media_bytesint20971520Max inbound media size; set 0 to disable

​
Chat-type detection

PlatformPatternType
telegramstarts with -100"unknown"
telegramstarts with -"group"
telegramotherwise"direct"
slackstarts with C / G / Dchannel / group / direct
whatsappcontains @g.us / @c.usgroup / direct

​
Common Patterns

​
Cross-platform delivery

directory = ChannelDirectory()
directory.set_home_channel("slack", "C0123456")
directory.add_alias("team", "slack", "C0123456")

agent = Agent(
    name="cross-platform",
    instructions="When asked to post somewhere, use delivery targets from Session Context.",
)
bot = Bot("telegram", agent=agent, channel_directory=directory)

​
Disable injection for privacy

bot = Bot("telegram", agent=agent, inject_session_context=False)
Context still flows to tools via get_session_context() — only the visible prompt block is suppressed.

​
Best Practices

The ## Session Context block is injected after the cache boundary — each turn gets fresh context without invalidating prior cache entries.
Prefer "team" or "ops" over raw channel IDs — the model matches user intent to alias names.
set_home_channel(platform, channel_id) designates the default delivery target; agents refer to it as "<platform>:home".
Set inject_session_context=False when platform metadata should not appear in the system prompt.

Cross-Platform Sessions

Unified conversation history across platforms

Channels Gateway

Connect agents to Telegram, Discord, Slack, and WhatsApp

Bot Message Routing

Route messages to different agents by channel

Gateway Tool Policy

Scope the toolset per route