# Telegram

DM zot from anywhere.

Pair zot with a BotFather token and DM it from anywhere. It reads, writes, edits, and runs, same as the TUI. Photos and image attachments are forwarded to vision-capable models.

Inside a live TUI session, type `/telegram` (or `/tg`) to connect. DMs become prompts in the same session; a `tg` tag appears in the status bar while connected.

## Headless daemon

```shell
zot telegram-bot setup     # paste a BotFather token, verify, save
zot telegram-bot run       # foreground: long-poll in this terminal
zot telegram-bot start     # background: detach and return immediately
zot telegram-bot stop      # SIGTERM the background bot
zot telegram-bot logs -f   # tail $ZOT_HOME/logs/bot.log
zot telegram-bot status    # config (token masked) + running/stopped
```

## Protocol-agnostic core

Telegram is one adapter on top of a generic, protocol-agnostic bot core. See [Messaging backends](/docs/messaging-backends) for the architecture and how to add new transports like Discord, Slack, or Signal.
