BOT API

gerekli messages.write + SEND_MESSAGES

Bir kanala mesaj gönderir. content 1-4000 karakter. replyTo ve components isteğe bağlıdır.

Yanıt bir MessageDto döner (id, channelId, authorId, body, createdAt ve fazlası).

{
  "content": "Hello!",
  "replyTo": "b4d7e9a1-3c25-4f80-9d16-5e7a8b9c0d1e",
  "components": []
}

HTTP/1.1 201 Created

{
  "message": {
    "id": "b4d7e9a1-3c25-4f80-9d16-5e7a8b9c0d1e",
    "channelId": "3f9a1c02-8b7e-4d21-9a10-0c1d2e3f4a5b",
    "authorId": "bot_a1b2c3",
    "body": "Hello!",
    "createdAt": "2026-08-25T12:00:00.000Z"
  }
}

gerekli messages.write

Botun KENDİ mesajını düzenler. content, components ya da ikisini birden gönder (en az biri). Bir alanı atlarsan değişmeden kalır; components: [] butonları temizler. Başarıda 204. Bot kendi mesajı değilse 403, mesaj silinmişse 410.

{
  "content": "new text",
  "components": []
}

gerekli messages.manage + MANAGE_MESSAGES

Bir mesajı siler (moderasyon). Başarıda 204.

gerekli messages.read

Bir kanaldaki son 50 mesajı okur.

{
  "messages": [
    {
      "id": "b4d7e9a1-3c25-4f80-9d16-5e7a8b9c0d1e",
      "authorId": "9e1f2a3b-4c5d-4e6f-8a9b-0c1d2e3f4a5b",
      "content": "gm",
      "createdAt": "2026-08-25T12:00:00.000Z"
    }
  ]
}

gerekli reactions.write + ADD_REACTIONS

Bir mesaja tepki (emoji) ekler.

{
  "messageId": "b4d7e9a1-3c25-4f80-9d16-5e7a8b9c0d1e",
  "emoji": "👍"
}

gerekli messages.write

Botun kendi mesajındaki butonları ve menüleri değiştirir. components bir buton/menü nesneleri dizisidir; boş dizi ([]) hepsini temizler. Kullanıcı bir butona ya da menüye dokununca gateway üzerinden interaction.create (kind: component) gelir.

{
  "components": []
}

gerekli sunucuya kurulu olmak

Sunucu bilgisini ve herkese açık kanallarını döner.

{
  "group": { "id": "7c2e5d18-1f4a-4b93-8e6c-2a9b0c1d3e4f", "name": "My Server" },
  "channels": [
    { "id": "3f9a1c02-8b7e-4d21-9a10-0c1d2e3f4a5b", "name": "general" }
  ]
}

gerekli channels.manage + MANAGE_CHANNELS

Bir metin kanalı oluşturur.

{
  "name": "announcements"
}

gerekli channels.manage + MANAGE_CHANNELS

Bir kanalı yeniden adlandırır.

{
  "name": "new-name"
}

gerekli channels.manage + MANAGE_CHANNELS

Bir kanalı siler.

gerekli members.read

Üyeleri listeler (sayfalı). limit ve after (bir önceki sayfanın son userId’si) parametrelerini kullan. nextAfter null olana kadar devam et.

GET /bot/v1/groups/{groupId}/members?limit=100&after=9e1f2a3b-4c5d-4e6f-8a9b-0c1d2e3f4a5b

{
  "members": [
    {
      "userId": "9e1f2a3b-4c5d-4e6f-8a9b-0c1d2e3f4a5b",
      "username": "ada",
      "displayName": "Ada",
      "role": "member",
      "isBot": false,
      "joinedAt": "2026-01-02T09:00:00.000Z"
    }
  ],
  "nextAfter": "9e1f2a3b-4c5d-4e6f-8a9b-0c1d2e3f4a5b"
}

gerekli members.read

Tek bir üyeyi ve rol kimliklerini döner.

{
  "userId": "9e1f2a3b-4c5d-4e6f-8a9b-0c1d2e3f4a5b",
  "username": "ada",
  "displayName": "Ada",
  "role": "member",
  "isBot": false,
  "joinedAt": "2026-01-02T09:00:00.000Z",
  "roleIds": ["d2c3b4a5-6f70-4819-a2b3-c4d5e6f7a8b9", "e3d4c5b6-7081-492a-b3c4-d5e6f7a8b9c0"]
}

gerekli roles.manage

Sunucunun rollerini listeler.

gerekli roles.manage + MANAGE_ROLES

Bir üyeye rol ekler. Bir bot yalnızca kendi grantı’nın alt kümesi izinlere sahip bir rolü atayabilir ve asla yetkililere (sahip/yönetici) rol veremez.

{
  "roleId": "d2c3b4a5-6f70-4819-a2b3-c4d5e6f7a8b9"
}

gerekli roles.manage + MANAGE_ROLES

Bir üyeden rolü kaldırır.

gerekli members.manage + KICK_MEMBERS

Bir üyeyi atar. Botlar yalnızca sıradan üyelere işlem yapabilir, asla sahip/yöneticiye değil.

gerekli members.manage + BAN_MEMBERS

Bir üyeyi banlar. reason isteğe bağlı; durationDays isteğe bağlı (kalıcı ban için boş bırak).

{
  "reason": "spam",
  "durationDays": 7
}

gerekli members.manage + BAN_MEMBERS

Bir üyenin banını kaldırır.

gerekli members.manage + MUTE_MEMBERS

Bir üyeyi belirtilen dakika kadar susturur.

{
  "minutes": 10
}

gerekli members.manage + MUTE_MEMBERS

Bir üyenin susturmasını kaldırır.

gerekli hepsini değiştir, en fazla 25

Slash komutlarını kaydeder (hepsini değiştirir, en fazla 25). Bir kullanıcı, botun kurulu olduğu bir kanalda /ping yazınca bota gateway üzerinden interaction.create gelir.

{
  "commands": [
    { "name": "ping", "description": "Check the bot is alive" }
  ]
}