Telegram

Delivery: Official add-on. Telegram is the fastest public bot surface for many Fased setups. The gateway owns the bot token, receives updates through long polling by default, and keeps DM and group access separate. Status: supported for DMs and groups. Long polling is default; webhook mode is optional.

Pairing

Pair unknown DMs before they can talk to the Agent.

Groups

Mention gating and group allowlists.

Troubleshooting

Shared channel diagnostics.

Quick setup

Open Agents > selected Agent > Channels > Telegram and click Install. Restart the Gateway when prompted.
In Telegram, open @BotFather.
Run /newbot and save the token.
Return to Agent > Channels > Telegram.
Paste the token and keep DM policy on pairing to start.
Save and approve the first DM pairing.

CLI install:

fased plugins install @fased/telegram
fased gateway restart

Config shape:

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123:abc",
      dmPolicy: "pairing",
      groups: {
        "*": { requireMention: true },
      },
    },
  },
}

Telegram does not use fased channels login telegram. Configure the token from Agent > Channels, config, or env, then start the gateway.

Telegram settings

Setting	Why it matters
Privacy mode	Controls whether the bot can see all group messages.
Group admin	Admin bots can receive all group messages when configured that way.
`/setjoingroups`	Allows or denies group adds.
`/setprivacy`	Changes group visibility behavior. Re-add the bot after changing it.

For most groups, keep mention gating on.

Access model

Area	Recommended start
DMs	`dmPolicy: "pairing"`
Groups	require mention
Sender access	owner or allowlist first
Agent routing	explicit route per peer/topic when needed

Gateway behavior

Long polling is the normal local mode.
Webhook mode is optional when you have a public HTTPS endpoint.
Forum topics can route to distinct sessions.
Task commands create Agent-owned Tasks; Telegram is only the transport and optional delivery target.

Useful commands

fased gateway
fased channels status telegram
fased pairing list telegram
fased pairing approve telegram <CODE>
fased logs --follow

Troubleshooting

Symptom	Check
Bot does not reply in DM	Pairing code, DM policy, token, gateway logs.
Bot ignores group messages	Mention requirement, privacy mode, admin status.
Topic replies go to wrong place	Use explicit topic routes.
Webhook conflicts with polling	Use one update mode at a time.

Overview

Common setup

Team and enterprise

Self-hosted and protocol

Optional and legacy

Configuration and behavior

Telegram

Pairing

Groups

Troubleshooting

Quick setup

Telegram settings

Access model

Gateway behavior

Useful commands

Troubleshooting

​Telegram

Pairing

Groups

Troubleshooting

​Quick setup

​Telegram settings

​Access model

​Gateway behavior

​Useful commands

​Troubleshooting

​Related

Telegram

Quick setup

Telegram settings

Access model

Gateway behavior

Useful commands

Troubleshooting

Related