---
title: Telegram
description: Connect your agent to a Telegram bot for 1:1 and group chats.
type: channel
keywords:
  - chat
  - messaging
  - bot
---

# Telegram

Channel integration for eve. Connect your agent to a Telegram bot for 1:1 and group chats.

## Install

Add this channel from eve's registry. This writes `agent/channels/telegram.ts`:

```bash
eve add channel/telegram
```

## Quick start

Create `agent/channels/telegram.ts`:

```ts
// agent/channels/telegram.ts
import { telegramChannel } from "eve/channels/telegram";

export default telegramChannel({
  credentials: { botToken: () => process.env.TELEGRAM_BOT_TOKEN! },
});
```

## Configure

Create a bot with [@BotFather](https://t.me/botfather), then register the webhook to point at eve's route (`/eve/v1/telegram`). Store the bot token in an environment variable. See the [Telegram channel docs](/docs/channels/telegram) for group privacy and command setup.

[Read the full channel documentation](/docs/channels/telegram)

---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)