WEVEN 봇 API 문서

curl http://localhost:3000/api/bot/me \
  -H "Authorization: Bot <토큰>"

const socket = new WebSocket("ws://localhost:3000/ws", {
  headers: { Authorization: "Bot <토큰>" },
});

{
  id: string;
  username: string;          // 고유한 사용자 이름
  displayName: string | null;
  accentColor: string;       // "#rrggbb"
  avatarId: string | null;   // 이미지: GET /api/uploads/{avatarId}
  bio: string;
  plan: "FREE" | "PLUS";
  bot: boolean;              // 봇·웹후크면 true
}

{
  id: string;
  room: "channel:<id>" | "dm:<id>";
  content: string;
  type: "DEFAULT" | "MEMBER_JOIN" | "PIN" | …;
  authorId: string;
  author: User;
  createdAt: string;            // ISO 8601
  editedAt: string | null;
  pinned: boolean;
  attachments: { id, name, size, type }[];   // 파일: GET /api/uploads/{id}
  reactions: { emoji, count, userIds }[];
  replyTo: { id, authorId, content } | null;
  poll: Poll | null;
  embeds: Embed[];
  interaction: { id, name, userId } | null;  // 슬래시 명령어 응답이면 설정됨
}

{
  "title": "제목",
  "description": "**마크다운**을 쓸 수 있어요",
  "url": "https://example.com",
  "color": "#5865F2",
  "timestamp": "2026-10-14T12:00:00.000Z",
  "author": { "name": "작성자", "url": "https://…", "iconUrl": "https://…" },
  "footer": { "text": "푸터", "iconUrl": "https://…" },
  "image": { "url": "https://…/big.png" },
  "thumbnail": { "url": "https://…/small.png" },
  "fields": [
    { "name": "시작", "value": "22:00", "inline": true },
    { "name": "길이", "value": "30분", "inline": true }
  ]
}

[
  {
    "name": "날씨",
    "description": "도시의 날씨를 알려 줘요",
    "options": [
      { "name": "도시", "description": "도시 이름", "type": "string", "required": true },
      {
        "name": "단위", "description": "온도 단위", "type": "string",
        "choices": [{ "name": "섭씨", "value": "c" }, { "name": "화씨", "value": "f" }]
      }
    ]
  }
]

{
  "type": "interaction_create",
  "interaction": {
    "id": "cm…",
    "applicationId": "cm…",
    "command": { "id": "cm…", "name": "날씨" },
    "options": { "도시": "서울", "단위": "c" },
    "resolved": { "users": {}, "channels": {}, "roles": {} },
    "room": "channel:cm…",
    "channelId": "cm…",
    "serverId": "cm…",
    "user": { "id": "cm…", "username": "minji", … },
    "member": { "nickname": null, "roleIds": ["cm…"] },
    "createdAt": "2026-10-14T12:00:00.000Z"
  }
}

await fetch(`http://localhost:3000/api/interactions/${interaction.id}/callback`, {
  method: "POST",
  headers: { Authorization: "Bot <토큰>", "Content-Type": "application/json" },
  body: JSON.stringify({
    content: "서울은 맑아요 ☀️",
    embeds: [{ title: "서울 날씨", description: "18°C", color: "#FEE75C" }],
    ephemeral: false,
  }),
});

curl -X POST "http://localhost:3000/api/webhooks/<id>/<token>" \
  -H "Content-Type: application/json" \
  -d '{"content":"배포 완료!","embeds":[{"title":"v1.2.0","color":"#57F287"}]}'

import WebSocket from "ws"; // npm install ws

const TOKEN = process.env.BOT_TOKEN;
const API = "http://localhost:3000/api";

async function api(method, path, body) {
  const res = await fetch(API + path, {
    method,
    headers: { Authorization: `Bot ${TOKEN}`, "Content-Type": "application/json" },
    body: body ? JSON.stringify(body) : undefined,
  });
  const data = await res.json();
  if (!res.ok) throw new Error(data.error);
  return data;
}

const socket = new WebSocket("ws://localhost:3000/ws", { headers: { Authorization: `Bot ${TOKEN}` } });

socket.on("message", async (raw) => {
  const event = JSON.parse(raw);

  if (event.type === "ready") {
    await api("PUT", "/bot/commands", [
      { name: "ping", description: "봇이 살아 있는지 확인해요" },
      { name: "안녕", description: "인사해요", options: [{ name: "이름", description: "누구에게", type: "string", required: true }] },
    ]);
    console.log("준비 완료:", event.user.username);
  }

  if (event.type === "interaction_create") {
    const i = event.interaction;
    if (i.command.name === "ping") {
      await api("POST", `/interactions/${i.id}/callback`, { content: "퐁! 🏓" });
    }
    if (i.command.name === "안녕") {
      await api("POST", `/interactions/${i.id}/callback`, {
        embeds: [{ title: `안녕하세요, ${i.options["이름"]}님!`, color: "#5865F2" }],
      });
    }
  }

  if (event.type === "message_create" && !event.message.author.bot && event.message.content === "!ping") {
    await api("POST", "/messages", { room: event.message.room, content: "pong!", replyToId: event.message.id });
  }
});

BOT_TOKEN=<토큰> WEVEN_URL=http://localhost:3000 WEVEN_GATEWAY=ws://localhost:3000/ws node examples/bot.mjs