KENDİ ARAÇLARINI
YAZ

Webhook'lar ve bot API'siyle sunucunu otomatikleştir. Beş dakikada ilk mesajını gönder.

Webhook nedir?

Webhook, bir kanala dışarıdan mesaj göndermenin en kolay yolu: sana özel bir URL verir; o URL'e HTTP POST attığında mesaj kanala düşer. Bot çalıştırmana, oturum açmana gerek yok — tek bir istekle çalışır. Maç bildirimleri, sunucu uyarıları, CI/CD haberleri… ne istersen.

1

Webhook oluştur

Uygulamada mesaj göndermek istediğin kanalın ayarlarını aç: Kanal Ayarları → Entegrasyonlar → Webhook Oluştur. İstersen webhook'a bir isim ve avatar ver.

2

URL'i kopyala

Oluşan webhook URL'ini kopyala. Bu URL gizli bir anahtardır — elinde olan herkes o kanala mesaj atabilir. Kimseyle paylaşma.

3

POST isteği at

URL'e application/json gövdesiyle POST at. Saniyeler içinde mesajın kanalda. Hepsi bu.

Kod örnekleri

Aynı istek, üç dilde. WEBHOOK_URL yerine kendi URL'ini koy.

CURL
# Tek satırda mesaj gönder
curl -X POST $WEBHOOK_URL \
  -H "Content-Type: application/json" \
  -d '{"content": "Maç başlıyor, herkes odaya!"}'
JAVASCRIPT
await fetch(WEBHOOK_URL, {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({content: 'Sunucu yedeği tamamlandı.'}),
});
PYTHON
import requests

requests.post(WEBHOOK_URL, json={
    "content": "Turnuva kayıtları açıldı!",
    "username": "Turnuva Botu",
})
AlanZorunluAçıklama
contentEvetGönderilecek mesaj metni.
usernameHayırBu mesaj için webhook adını geçersiz kılar.
avatar_urlHayırBu mesaj için webhook avatarını geçersiz kılar.

Bot hesapları

Webhook tek yönlüdür: sadece mesaj gönderir. Mesajları okumak, komutlara cevap vermek ya da sunucuyu yönetmek istiyorsan bot hesabı kurarsın. Botlar API'ye kendi token'ıyla bağlanır ve gerçek bir üye gibi sunucuda yaşar.

1

Bot hesabı oluştur

Uygulamada Ayarlar → Geliştirici → Uygulamalarım bölümünden yeni bir bot uygulaması oluştur ve bot token'ını al.

2

Token ile kimlik doğrula

REST isteklerinde Authorization başlığına token'ını koy. Token'ın botunun şifresidir — koda gömme, ortam değişkeninde tut.

3

Sunucuna ekle ve çalıştır

Botu sunucuna davet et; API üzerinden mesaj okusun, cevap versin, rol/kanal yönetsin — izinlerini sen belirlersin.

REST — MESAJ GÖNDERME (BOT)
curl -X POST https://app.clansnetwork.com/api/v1/channels/KANAL_ID/messages \
  -H "Authorization: Bot $BOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content": "Komut alındı, işleniyor…"}'
Güvenlik: Webhook URL'ini ve bot token'ını asla herkese açık yere koyma (GitHub, ekran görüntüsü, sohbet). Sızdığını düşünüyorsan hemen yenile — eski anahtar anında geçersiz olur.

Ne yapabilirsin?

Maç bildirimleri

Turnuva sistemin maç başlamadan 10 dakika önce webhook'la duyuru kanalına hatırlatma bassın.

Karşılama botu

Sunucuya katılan her yeni üyeyi isimle karşılayan, kuralları DM'den gönderen bir bot yaz.

Sunucu izleme

Oyun sunucun düştüğünde izleme scriptin webhook'la anında yöneticilere haber versin.

İstatistik botu

Haftalık en aktif üyeleri, ses odasında geçirilen toplam süreyi otomatik raporlayan bir bot kur.

Takıldığın yer olursa Yardım Merkezi her zaman burada.