Dialog uses a per-user Telegram bot model — you create and register your own bot so you control exactly who can interact with it. Once connected, you can chat with your agent directly in Telegram and receive scheduled research results without opening the app.Documentation Index
Fetch the complete documentation index at: https://docs.dialog.tools/llms.txt
Use this file to discover all available pages before exploring further.
For the high-level overview of how channels work, see Channels.
Setting up Telegram
Create a bot with @BotFather
Open Telegram and search for @BotFather. Use the
/newbot command, give your bot a name and a handle, and @BotFather will reply with a bot token. Keep it handy — you’ll paste it into Dialog in the next step.Register the bot in Dialog
Go to Settings > Channels in Dialog. In the Telegram section, paste your bot token and save. Dialog connects to your bot and shows it as Active with the bot handle and registered timestamp.
Choose a default agent
Use the Default Agent dropdown to pick which agent handles new Telegram conversations. This is the agent that replies by default; users can switch per-conversation with the
/agent command.Add allowed users
Only Telegram users on your allowlist can talk to your bot. For each user, add their numeric Telegram User ID (with an optional label like their name). To look up a user’s ID, have them message @userinfobot on Telegram — it replies with their ID.
Bot commands
| Command | What it does |
|---|---|
/new | Start a new research session |
/agent | Switch the agent handling this conversation |
/history | View recent sessions |
/tools | List available data sources |
/credits | Check your credit balance |
/help | Show all available commands |
How delivery works
Once connected, your agent can push research results to your Telegram chat:- Results are formatted for readability in Telegram (bold, code blocks, clickable links)
- Long research briefs are split into multiple messages at Telegram’s 4,000-character per-message limit so nothing gets cut off
- Citations and URLs are preserved as clickable links
- You can pair Telegram delivery with scheduled tasks for automated daily or weekly briefings
Connection health
If your bot connection drifts, click Re-sync Webhook in Settings > Channels. If the bot token has been revoked, create a new bot with @BotFather and register the new token.Use cases
Morning briefing
Schedule a daily digest to be delivered to Telegram before your workday starts.
Competitor alerts
Get pushed whenever a feed or competitor page has new signal.
Async research
Kick off research in the app, close it, and receive results in Telegram later.
Team sharing
Forward research results from Telegram to team channels or individuals.

