> Discover all available pages from the documentation index: https://mastra.zisheng.pro/ja/llms.txt

# Telegram

Telegram channel を使用すると、Mastra Agent は Telegram のダイレクトメッセージ、グループメッセージ、Bot へのメンションを受信できます。Mastra は Agent の接続と Webhook ルートを処理します。Bot の設定、Webhook の登録、ポーリングの動作については、Chat SDK の Telegram アダプターのドキュメントを参照してください。

## アダプターのインストール

Chat SDK から Telegram アダプターをインストールします。

**npm**:

```bash
npm install @chat-adapter/telegram
```

**pnpm**:

```bash
pnpm add @chat-adapter/telegram
```

**Yarn**:

```bash
yarn add @chat-adapter/telegram
```

**Bun**:

```bash
bun add @chat-adapter/telegram
```

## Agent の設定

Agent の `channels.adapters` オブジェクトに `createTelegramAdapter()` を追加します。

```typescript
import { Agent } from '@mastra/core/agent'
import { createTelegramAdapter } from '@chat-adapter/telegram'

export const telegramAgent = new Agent({
  id: 'telegram-agent',
  name: 'Telegram Agent',
  instructions: 'Answer questions and help with tasks in Telegram.',
  model: 'openai/gpt-5.6-sol',
  channels: {
    adapters: {
      telegram: createTelegramAdapter(),
    },
  },
})
```

Mastra インスタンスに Agent を登録します。

```typescript
import { Mastra } from '@mastra/core'
import { telegramAgent } from './agents/telegram-agent'

export const mastra = new Mastra({
  agents: { telegramAgent },
})
```

## アダプターの設定

BotFather、Webhook の登録、シークレットトークン、ポーリングモードなど、Telegram 固有の設定については、[Chat SDK Telegram アダプターのドキュメント](https://chat-sdk.dev/adapters/official/telegram)に従ってください。

アダプターは、次のような環境変数から Telegram の認証情報を読み取ります。

```bash
TELEGRAM_BOT_TOKEN=your-telegram-bot-token
TELEGRAM_WEBHOOK_SECRET_TOKEN=your-webhook-secret-token
TELEGRAM_BOT_USERNAME=your_bot_username
```

## Webhook URL

Mastra は、Agent ID とアダプターキーから Telegram の Webhook ルートを生成します。

```text
/api/agents/telegram-agent/channels/telegram/webhook
```

公開されている Mastra サーバーの URL をベース URL として使用します。

```text
https://your-app.example.com/api/agents/telegram-agent/channels/telegram/webhook
```

Telegram アダプターのドキュメントで Webhook URL が求められる箇所には、この URL を使用します。Telegram はポーリングモードもサポートしています。ローカル開発でポーリングを使用する場合は、Chat SDK アダプターのドキュメントに従ってください。

## 関連情報

- [Channels の概要](https://mastra.zisheng.pro/ja/docs/capabilities/channels/overview)
- [その他](https://mastra.zisheng.pro/ja/docs/capabilities/channels/other-adapters)