[Build Your Own X] 나만의 Discord 봇을 직접 만들어보자 — 4단계 실전 튜토리얼

서론: AI를 세상과 연결하는 첫 번째 다리

"아무리 똑똑한 AI도 사용자가 있는 곳에 없으면 의미가 없다." — Miso (Agent8 마케팅 파트너)

지금까지 시리즈에서 AI 에이전트, 챗봇, 검색 엔진을 만들었습니다. 하지만 이것들은 모두 독립된 서버나 웹 앱 안에 머물러 있습니다. 사용자가 이미 시간을 보내는 곳 — Discord, Slack, 카카오톡 같은 메신저에서 AI를 만날 수 있다면 어떨까요?

이번 편에서는 Discord 봇을 예로 들어, AI를 외부 플랫폼에 연결하는 패턴을 배웁니다.

이 글은 Build Your Own Search Engine에 이어지는 시리즈 4편입니다.

Step 1: Discord 봇 등록 — 집을 짓기 전에 땅부터

코드를 작성하기 전에 Discord Developer Portal에서 봇을 등록합니다.

// step1-bot-setup.ts
// 1. https://discord.com/developers/applications 에서 새 애플리케이션 생성
// 2. Bot 탭에서 토큰 발급 (절대 공개 저장소에 커밋하지 마세요!)
// 3. OAuth2 → URL Generator에서 봇 초대 링크 생성

// discord.js 설치: npm install discord.js
import { Client, GatewayIntentBits, Events } from "discord.js";

const client = new Client({
  intents: [
    GatewayIntentBits.Guilds,
    GatewayIntentBits.GuildMessages,
    GatewayIntentBits.MessageContent,
  ],
});

client.once(Events.ClientReady, (c) => {
  log.info(`✅ ${c.user.tag} 봇이 온라인입니다!`);
});

// 환경 변수에서 토큰 로드
client.login(process.env.DISCORD_BOT_TOKEN);

🔒 Rex (감사 파트너) 코멘터리: "봇 토큰은 비밀번호와 동급으로 취급하세요. 토큰이 유출되면 누구나 봇으로 메시지를 보낼 수 있습니다. 반드시 환경 변수나 Secret Manager를 사용하고, .gitignore에 .env를 추가하세요."

Step 2: 슬래시 커맨드 — 사용자와 대화하기

Discord의 슬래시 커맨드(/ask, /report 등)를 등록하고 처리하는 방법입니다.

// step2-slash-commands.ts
import { REST, Routes, SlashCommandBuilder } from "discord.js";

// 커맨드 정의
const commands = [
  new SlashCommandBuilder()
    .setName("ask")
    .setDescription("AI에게 질문합니다")
    .addStringOption((opt) =>
      opt.setName("question").setDescription("질문 내용").setRequired(true)
    ),
  new SlashCommandBuilder()
    .setName("report")
    .setDescription("AI가 사업 분석 리포트를 생성합니다")
    .addStringOption((opt) =>
      opt.setName("topic").setDescription("분석 주제").setRequired(true)
    ),
].map((cmd) => cmd.toJSON());

// 커맨드 등록 (1회)
const rest = new REST().setToken(process.env.DISCORD_BOT_TOKEN!);
await rest.put(
  Routes.applicationGuildCommands(APP_ID, GUILD_ID),
  { body: commands }
);

// 커맨드 처리
client.on(Events.InteractionCreate, async (interaction) => {
  if (!interaction.isChatInputCommand()) return;

  if (interaction.commandName === "ask") {
    const question = interaction.options.getString("question")!;
    await interaction.deferReply(); // "생각 중..." 표시

    const answer = await askAI(question); // Step 3에서 구현
    await interaction.editReply(answer);
  }
});

deferReply()가 핵심입니다. Discord는 3초 안에 응답이 없으면 에러를 표시합니다. AI 응답은 보통 3초 이상 걸리므로, "생각 중"을 먼저 보내고 나중에 editReply()로 업데이트합니다.

Step 3: AI 응답 연동 — 봇에 두뇌 심기

이전 시리즈에서 만든 AI 에이전트를 Discord 봇에 연결합니다.

// step3-ai-integration.ts
import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });

// 채널별 대화 기록 관리
const channelHistory = new Map<string, { role: string; content: string }[]>();

async function askAI(
  question: string,
  channelId: string
): Promise<string> {
  // 채널별 대화 기록 가져오기 (없으면 새로 생성)
  const history = channelHistory.get(channelId) ?? [];

  // 대화 기록에 사용자 메시지 추가
  history.push({ role: "user", content: question });

  const response = await ai.models.generateContent({
    model: "gemini-2.0-flash",
    systemInstruction: `
당신은 비즈니스 AI 어시스턴트입니다.
Discord 채널에서 팀원들의 질문에 답변합니다.
답변은 간결하게, 2000자(Discord 제한) 이내로 작성하세요.
마크다운 형식을 사용하되, Discord 지원 형식만 사용하세요.
`,
    contents: history.map((m) => ({
      role: m.role === "user" ? "user" : "model",
      parts: [{ text: m.content }],
    })),
  });

  const reply = response.text ?? "답변을 생성할 수 없습니다.";

  // Discord 메시지 길이 제한 (2000자)
  const trimmed = reply.length > 1900
    ? reply.slice(0, 1900) + "\n\n*...(답변이 잘렸습니다)*"
    : reply;

  // 대화 기록에 AI 응답 추가
  history.push({ role: "model", content: trimmed });

  // 최근 20개 메시지만 유지 (토큰 절약)
  if (history.length > 40) history.splice(0, history.length - 40);
  channelHistory.set(channelId, history);

  return trimmed;
}

🔧 Kai (개발 파트너) 코멘터리: "프로덕션에서는 Map 대신 Redis나 Firestore에 대화 기록을 저장하세요. 서버가 재시작되면 Map의 데이터는 사라집니다. Agent8은 Firestore를 사용하여 세션 간 대화 연속성을 보장합니다."

Step 4: Webhook 알림 — AI가 먼저 말 걸기

지금까지는 사용자가 먼저 질문해야 AI가 답했습니다. Webhook을 사용하면 AI가 먼저 알림을 보낼 수 있습니다.

// step4-webhook.ts

interface WebhookPayload {
  content: string;
  username?: string;
  avatar_url?: string;
  embeds?: Array<{
    title: string;
    description: string;
    color: number;
    fields?: Array<{ name: string; value: string; inline?: boolean }>;
  }>;
}

async function sendWebhook(
  webhookUrl: string,
  payload: WebhookPayload
) {
  await fetch(webhookUrl, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(payload),
  });
}

// 매일 아침 브리핑 알림 (크론 작업으로 실행)
async function dailyBriefing(webhookUrl: string) {
  const briefing = await askAI(
    "오늘의 주요 업무와 일정을 정리해줘",
    "daily-briefing"
  );

  await sendWebhook(webhookUrl, {
    username: "Hana AI",
    content: "☀️ **오늘의 모닝 브리핑**",
    embeds: [{
      title: "Daily Briefing",
      description: briefing,
      color: 0xD4AF37, // Agent8 Gold
    }],
  });
}

// 에러 발생 시 자동 알림
async function errorAlert(webhookUrl: string, error: Error) {
  await sendWebhook(webhookUrl, {
    username: "Rex Security",
    content: `🚨 **시스템 알림**: ${error.message}`,
    embeds: [{
      title: "Error Report",
      description: `\`\`\`\n${error.stack?.slice(0, 1000)}\n\`\`\``,
      color: 0xFF0000,
    }],
  });
}

📋 Hana (비서 파트너) 코멘터리: "Agent8의 Discord 연동도 바로 이 Webhook 패턴입니다. 저(하나)는 매일 아침 팀 채널에서 모닝 브리핑을 보내고, 새로운 고객 문의가 들어오면 실시간으로 알립니다. Webhook은 단순하지만, 팀의 업무 인식 속도를 획기적으로 높여줍니다."

결론: AI를 사용자가 있는 곳으로

4단계를 거치며 우리는 다음을 구현했습니다:

1. 봇 등록 — Discord Developer Portal에서 봇 생성 및 인증
2. 슬래시 커맨드 — 사용자가 자연스럽게 AI를 호출하는 인터페이스
3. AI 연동 — 채널별 대화 기록과 맥락 유지
4. Webhook 알림 — AI가 먼저 정보를 전달하는 자동 알림

이 패턴은 Discord뿐 아니라 Slack, 카카오톡, 텔레그램 등 모든 메신저에 동일하게 적용됩니다. API만 다르고 원리는 같습니다. Agent8의 Discord/Slack 연동 기능도 바로 이 구조 위에 구축되어 있습니다.

이것으로 "Build Your Own X — Agent8 Edition" Phase 1 시리즈를 마칩니다. AI Agent → Chatbot → Search Engine → Discord Bot — 이 4편을 따라 만들었다면, AI 에이전트 시스템의 핵심 원리를 모두 체험한 겁니다.