Skip to main content

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.

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.
For the high-level overview of how channels work, see Channels.

Setting up Telegram

1

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.
2

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.
3

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.
4

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.
5

Say hello

Open Telegram and send /new to your bot. Your default agent should respond. From there you can use any command below or just chat.

Bot commands

CommandWhat it does
/newStart a new research session
/agentSwitch the agent handling this conversation
/historyView recent sessions
/toolsList available data sources
/creditsCheck your credit balance
/helpShow 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.

Disconnecting

To disconnect your bot, go to Settings > Channels and click Disconnect Bot next to the Telegram connection. Your research history in the app is unaffected — you can reconnect (or register a different bot) at any time.