본문으로 건너뛰기

전보

Telegram 채널을 사용하면 Mastra Agent가 Telegram에서 직접 메시지, 그룹 메시지 및 봇 멘션을 받을 수 있습니다. Mastra는 Agent 연결 및 웹훅 경로를 처리합니다. Chat SDK Telegram 어댑터 문서에서는 봇 설정, 웹훅 등록 및 폴링 동작을 다룹니다.

어댑터 설치
어댑터 설치에 대한 직접 링크

Chat SDK에서 Telegram 어댑터를 설치합니다.

npm install @chat-adapter/telegram

Agent 구성
Agent 구성에 대한 직접 링크

Agent의 channels.adapters 객체에 createTelegramAdapter()를 추가하세요.

src/mastra/agents/telegram-agent.ts
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를 등록합니다.

src/mastra/index.ts
import { Mastra } from '@mastra/core'
import { telegramAgent } from './agents/telegram-agent'

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

어댑터 설정
어댑터 설정에 대한 직접 링크

BotFather, 웹훅 등록, 비밀 토큰, 폴링 모드를 포함한 Telegram 전용 설정은 Chat SDK Telegram 어댑터 문서를 따르세요. 어댑터는 다음과 같은 환경 변수에서 Telegram 자격 증명을 읽습니다.

.env
TELEGRAM_BOT_TOKEN=your-telegram-bot-token
TELEGRAM_WEBHOOK_SECRET_TOKEN=your-webhook-secret-token
TELEGRAM_BOT_USERNAME=your_bot_username

웹훅 URL
웹훅 URL에 대한 직접 링크

Mastra는 Agent ID 및 어댑터 키에서 Telegram 웹후크 경로를 생성합니다.

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

공개 Mastra 서버 URL을 기본 URL로 사용하십시오.

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

Telegram 어댑터 문서에서 웹훅 URL을 요청하는 곳이면 어디든 이 URL을 사용하세요. 텔레그램은 폴링 모드도 지원합니다. 로컬 개발에 폴링을 사용하려면 Chat SDK 어댑터 문서를 따르세요.

On this page