// botlar

VOID İÇİN BOT YAP

Bot, Void sunucularında senin yerine iş yapan küçük bir program. Mesaj gönderir, tepki verir, üyeleri yönetir, komutlara ve butonlara yanıt verir. Hiç API kullanmamış biri bile başlayabilir: tek adresli bir webhook ile mesaj at, biraz kod ile tam kontrolü ele al ya da uygulama içinden kodsuz akış kur.

// nereden başlayayım

en kolay

Gelen webhook

> Kod bilmesen bile

Tek bir adrese mesaj at, bir kanala düşsün. Bot da token da gerekmez.

  1. Sunucu Ayarları > Webhooks bölümünden bir webhook oluştur, bir metin kanalına bağla.
  2. Sana verilen adresi kopyala (gizli bilgi adresin içinde).
  3. Herhangi bir script ile o adrese bir mesaj gönder.
tam kontrol

REST API'li bot

> Programın mesaj gönderip okusun

Kendi programın Void ile konuşsun: mesaj gönder, oku, tepki ver, moderasyon yap.

  1. Masaüstü uygulamada Ayarlar > Geliştirici bölümünden bir uygulama oluştur, token’ı kopyala.
  2. Bir sunucu yöneticisi botunu sunucusuna kursun.
  3. Programın API'ye istek atsın (aşağıdaki 3 adıma bak).
kodsuz

Kodsuz akışlar

> Hiç programlama yapmadan

Uygulamanın içinde, kutucukları birleştirerek otomasyon kur. Tek satır kod yok.

  1. Uygulamada Ayarlar > Geliştirici bölümünü aç.
  2. Bir tetikleyici ve adımlar seç (ör. biri katılınca karşılama mesajı).
  3. Yayınla, gerisini Void halletsin.

// ilk mesajını 3 adımda gönder

Merhaba, dünya

  1. Void masaüstü uygulamasında Ayarlar > Geliştirici bölümünü aç, bir uygulama oluştur ve token’ı kopyala. Token yalnızca bir kez gösterilir, o an kopyala.
  2. Bir sunucu yöneticisinden botunu sunucusuna kurmasını iste ve bir kanal kimliği (channel id) not et.
  3. Aşağıdaki komutu çalıştır (CHANNEL_ID ve token’ı kendininkiyle değiştir).
bashmesaj gönder
curl -X POST https://api.thevoidhub.com/bot/v1/channels/CHANNEL_ID/messages \
  -H "Authorization: Bearer void_app_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"Hello from my bot!"}'

Yanıt olarak oluşturulan mesajı geri alırsın:

jsonyanıt
HTTP/1.1 201 Created

{
  "message": {
    "id": "b4d7e9a1-3c25-4f80-9d16-5e7a8b9c0d1e",
    "channelId": "CHANNEL_ID",
    "authorId": "bot_a1b2c3",
    "body": "Hello from my bot!",
    "createdAt": "2026-08-25T12:00:00.000Z"
  }
}

> Daha da kolayı: webhook (bot gerekmez)

Bir sunucu yöneticisi Sunucu Ayarları > Webhooks bölümünden bir kanala webhook oluşturur ve sana bir adres verir. Herhangi bir sistem o adrese POST atınca mesaj kanala düşer. Token ya da kurulum yok.

bashwebhook
curl -X POST https://api.thevoidhub.com/hooks/ID/TOKEN \
  -H "Content-Type: application/json" \
  -d '{"text":"Build finished ✅"}'

▶ Tüm API belgeleri

// sık sorulanlar

> Kod bilmiyorum, yine de bot yapabilir miyim?

Evet. En kolayı gelen webhook: bir adrese mesaj atarsın, kanala düşer. Ya da uygulamadaki kodsuz akışlarla, tek satır kod yazmadan otomasyon kurabilirsin.

> Token’ı nereden alıyorum?

Masaüstü uygulamada Ayarlar > Geliştirici bölümünden bir uygulama oluşturunca token verilir. Token yalnızca bir kez gösterilir, güvenli bir yere kaydet.

> Botum neden hiçbir şey yapamıyor?

Bir botun bir sunucuda çalışabilmesi için o sunucunun yöneticisi tarafından kurulması gerekir. Kurulum, botun neleri yapabileceğini (izinleri) belirler.

> Botu ücretsiz mi yapabilirim?

Evet. Uygulama oluşturmak, webhook kullanmak ve API çağırmak için ödeme gerekmez.

Hadi ilk botunu yap

Void’i indir, Ayarlar > Geliştirici’den bir uygulama oluştur ve başla.