Botlar için Messenger API ve Webhook Entegrasyonu (2026 Rehberi)

Mesajlaşma botları aracılığıyla messenger botları ile bildirimleri otomatikleştirmek, geliştirme iş akışlarını kolaylaştırır ve derleme tamamlandığında, hatalar oluştuğunda veya dağıtımlar bittiğinde anında uyarılar gönderilmesini sağlar. Bu rehber, popüler mesajlaşma platformları arasında webhook'lar aracılığıyla otomatik mesajlar gönderebilen botların entegrasyonu için adım adım talimatlar sunar. CI/CD pipeline sonuçları, sunucu izleme uyarıları veya herhangi bir otomatik süreç tamamlanması hakkında ekibini bilgilendirmen gerekiyorsa, bu entegrasyonlar bunu mümkün kılar. Sadece kolay bot entegrasyonu yeteneklerine sahip platformları ele alıyoruz - bazı güvenli mesajlaşma uygulamaları, gizliliği otomasyon özelliklerinden daha öncelikli tutar ve kasıtlı olarak dahil edilmemiştir.

Webhook Tabanlı Bot Otomasyonunu Anlamak

Webhook tabanlı botlar basit bir prensiple çalışır: uygulamanız belirli bir URL'ye bir HTTP POST isteği gönderir ve mesajlaşma platformu bu içeriği bir kanala veya kullanıcıya iletir. Bu mimari aşağıdaki gibi otomasyon senaryoları için idealdir:

• Derleme bildirimleri - Derleme başarılı olduğunda veya hata detaylarıyla başarısız olduğunda uyarı
• Dağıtım güncellemeleri - Kod staging veya production ortamına ulaştığında ekipleri bilgilendirme
• İzleme uyarıları - Sunucu sağlığı uyarıları veya kesinti bildirimleri gönderme
• Planlanmış raporlar - Günlük metrikler veya durum özetleri iletme

Temel iş akışı şunları içerir:

1. Hedef platformda bir bot veya webhook URL'si oluşturma
2. Otomasyon aracınızı (CI/CD, izleme sistemi, özel script) HTTP istekleri göndermek üzere yapılandırma
3. Mesaj yükünü platform özelliklerine göre biçimlendirme

Farklı mesajlaşma platformlarının güvenliği ve şifrelemeyi nasıl ele aldığını anlamak, bildirimleriniz için doğru platformu seçmek açısından çok önemlidir. Platform özelindeki güvenlik değerlendirmeleri hakkında daha derinlemesine bilgi için, 2026'da Mesajlaşma Uygulamaları Hakkında Nihai Rehberimize bakabilirsin.

Messenger Bot Entegrasyon Rehberleri

Aşağıda, otomatik mesajlar göndermek için kolay webhook tabanlı bot entegrasyonunu destekleyen her platform için adım adım rehberler bulunmaktadır.

Discord Webhook Botu

Discord, temel mesaj gönderimi için bot uygulaması veya kimlik doğrulama belirteçleri gerektirmeyen en basit webhook uygulamalarından birini sunar.

Adım Adım Kurulum

1. Sunucu Ayarlarını Aç - Sunucu adına sağ tıkla ve "Sunucu Ayarları"nı seç
2. Entegrasyonlara Git - Sol kenar çubuğunda "Entegrasyonlar"a tıkla
3. Webhook Oluştur - "Webhook'lar"a ve ardından "Yeni Webhook"a tıkla
4. Webhook'u Yapılandır - Webhook'una bir isim ver (örn., "Derleme Botu"), hedef kanalı seç ve isteğe bağlı olarak bir avatar yükle
5. Webhook URL'sini Kopyala - "Webhook URL'sini Kopyala"ya tıkla ve güvenli bir şekilde sakla

Webhook Aracılığıyla Mesaj Gönderme

curl -X POST -H "Content-Type: application/json" \
  -d '{"content": "✅ Derleme başarıyla tamamlandı!\n\nProje: MyApp\nBranch: main\nSüre: 3m 42s"}' \
  https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN

Hata Bildirimleri için Zengin Embed Örneği

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "embeds": [{
      "title": "❌ Derleme Başarısız",
      "color": 15158332,
      "fields": [
        {"name": "Proje", "value": "MyApp", "inline": true},
        {"name": "Branch", "value": "feature/login", "inline": true},
        {"name": "Hata", "value": "```TypeError: Cannot read property of undefined```"}
      ],
      "timestamp": "2026-01-15T10:30:00.000Z"
    }]
  }' \
  YOUR_WEBHOOK_URL

Resmi Dokümantasyon: Discord Webhook Dokümantasyonu

Slack Webhook Botu

Slack, zengin mesaj biçimlendirme ve kanal esnekliği sunan Slack Apps sisteminin bir parçası olarak Incoming Webhook'ları sağlar.

Adım Adım Kurulum

1. Slack Uygulaması Oluştur - api.slack.com/apps adresini ziyaret et ve "Yeni Uygulama Oluştur"a tıkla
2. Oluşturma Yöntemini Seç - "Sıfırdan" seçeneğini seç ve uygulamanı adlandır (örn., "CI/CD Bildirimleri")
3. Incoming Webhook'ları Etkinleştir - Sol kenar çubuğunda "Incoming Webhooks"a git ve etkinleştir
4. Çalışma Alanına Webhook Ekle - "Çalışma Alanına Yeni Webhook Ekle"ye tıkla
5. Kanal Seç - Bildirimlerin görüneceği kanalı seç ve "İzin Ver"e tıkla
6. Webhook URL'sini Kopyala - Benzersiz webhook URL'n artık görüntülenir

Webhook Aracılığıyla Mesaj Gönderme

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ Production ortamına dağıtım başarıyla tamamlandı!"}' \
  https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXX

Detaylı Bildirimler için Block Kit Mesajı

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "blocks": [
      {
        "type": "header",
        "text": {"type": "plain_text", "text": "🚨 Derleme Başarısız"}
      },
      {
        "type": "section",
        "fields": [
          {"type": "mrkdwn", "text": "*Proje:*\nMyApp"},
          {"type": "mrkdwn", "text": "*Branch:*\nmain"},
          {"type": "mrkdwn", "text": "*Hata:*\n`Module not found`"}
        ]
      }
    ]
  }' \
  YOUR_WEBHOOK_URL

Resmi Dokümantasyon: Slack Incoming Webhooks Rehberi

Microsoft Teams Webhook Botu

Microsoft Teams, bağlayıcılar sistemi üzerinden entegre edilen kanal bildirimleri için Incoming Webhook'ları destekler.

Adım Adım Kurulum

1. Kanal Ayarlarını Aç - Hedef kanala git, kanal adının yanındaki üç noktaya (•••) tıkla
2. Bağlayıcıları Seç - "Bağlayıcılar"a tıkla (veya yeni sürümlerde "Kanalı yönet" ve ardından "Bağlayıcılar")
3. Incoming Webhook'u Bul - "Incoming Webhook" için arama yap ve "Yapılandır"a tıkla
4. Webhook'una İsim Ver - Bir isim belirle (örn., "Derleme Uyarıları") ve isteğe bağlı olarak bir resim yükle
5. Oluştur ve URL'yi Kopyala - "Oluştur"a tıkla ve sağlanan webhook URL'sini kopyala

Webhook Aracılığıyla Mesaj Gönderme

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ #1234 numaralı derleme main branch üzerinde başarıyla tamamlandı"}' \
  YOUR_TEAMS_WEBHOOK_URL

Zengin Bildirimler için Adaptive Card

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "type": "message",
    "attachments": [{
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "type": "AdaptiveCard",
        "version": "1.2",
        "body": [
          {"type": "TextBlock", "size": "Large", "weight": "Bolder", "text": "❌ Derleme Başarısız"},
          {"type": "FactSet", "facts": [
            {"title": "Proje:", "value": "MyApp"},
            {"title": "Hata:", "value": "Derleme başarısız"}
          ]}
        ]
      }
    }]
  }' \
  YOUR_TEAMS_WEBHOOK_URL

Resmi Dokümantasyon: Microsoft Teams Incoming Webhooks

Telegram Botu

Telegram, programlı olarak mesaj göndermeye olanak tanıyan güçlü bir Bot API sunar. Webhook'ların aksine, istekleri doğrudan Telegram'ın API'sine gönderirsin.

Adım Adım Kurulum

1. BotFather ile Bot Oluştur - Telegram'ı aç ve @BotFather için arama yap
2. Yeni Bot Başlat - /newbot komutunu gönder
3. Botuna İsim Ver - Ekran adı ve kullanıcı adını belirlemek için yönergeleri izle (kullanıcı adı "bot" ile bitmelidir)
4. API Token'ını Kaydet - BotFather, 123456789:ABCdefGHIjklMNOpqrsTUVwxyz gibi bir API token'ı sağlar
5. Sohbet ID'sini Al - Botu grubuna/kanalına ekle, bir mesaj gönder, ardından sohbet ID'sini bulmak için https://api.telegram.org/bot<TOKEN>/getUpdates adresini ziyaret et

Bot API Aracılığıyla Mesaj Gönderme

curl -X POST \
  "https://api.telegram.org/bot/sendMessage" \
  -d "chat_id=" \
  -d "text=✅ Derleme başarıyla tamamlandı!%0A%0AProje: MyApp%0ABranch: main" \
  -d "parse_mode=HTML"

HTML ile Biçimlendirilmiş Mesaj

curl -X POST \
  "https://api.telegram.org/bot/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "",
    "text": "❌ Derleme Başarısız\n\nProje: MyApp\nBranch: main\nHata: Module not found",
    "parse_mode": "HTML"
  }'

Resmi Dokümantasyon: Telegram Bot API

Mattermost Webhook Botu

Mattermost, kendine ait sunucularda barındırılan ekip iletişimi için ideal olan, mükemmel webhook desteğine sahip açık kaynaklı bir Slack alternatifidir.

Adım Adım Kurulum

1. Entegrasyonlara Eriş - Hamburger menüsüne tıkla, ardından "Entegrasyonlar"a tıkla
2. Incoming Webhook Oluştur - "Incoming Webhooks"u seç, ardından "Incoming Webhook Ekle"ye tıkla
3. Webhook'u Yapılandır - Başlık, açıklama belirle ve varsayılan kanalı seç
4. Kaydet ve URL'yi Kopyala - "Kaydet"e tıkla ve webhook URL'sini kopyala

Webhook Aracılığıyla Mesaj Gönderme

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ Derleme başarıyla tamamlandı!"}' \
  https://your-mattermost-server.com/hooks/YOUR_WEBHOOK_ID

Zengin Ek Mesaj

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "attachments": [{
      "fallback": "Derleme Başarısız",
      "color": "#FF0000",
      "title": "❌ Derleme Başarısız",
      "fields": [
        {"short": true, "title": "Proje", "value": "MyApp"},
        {"short": true, "title": "Branch", "value": "main"},
        {"short": false, "title": "Hata", "value": "```Module not found```"}
      ]
    }]
  }' \
  YOUR_WEBHOOK_URL

Resmi Dokümantasyon: Mattermost Incoming Webhooks

Matrix/Element Botu

Matrix, merkezi olmayan iletişim için açık bir protokoldür ve Element en popüler istemcidir. Bot entegrasyonu, Matrix Client-Server API'sini kullanmayı gerektirir.

Adım Adım Kurulum

1. Bot Hesabı Oluştur - Ana sunucunda veya matrix.org üzerinde botun için yeni bir Matrix hesabı kaydet
2. Erişim Token'ı Al - Giriş yap ve Element'ten erişim token'ını al: Ayarlar → Yardım ve Hakkında → Gelişmiş → Erişim Token'ı
3. Oda ID'sini Al - Botunla hedef odaya katıl, ardından Oda Ayarları → Gelişmiş bölümünde oda ID'sini bul
4. Botu Odaya Davet Et - Bot hesabının mesaj göndermek istediğin odaya katıldığından emin ol

Matrix API Aracılığıyla Mesaj Gönderme

curl -X PUT \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"msgtype": "m.text", "body": "✅ Derleme başarıyla tamamlandı!"}' \
  "https://matrix.org/_matrix/client/r0/rooms/YOUR_ROOM_ID/send/m.room.message/$(date +%s)"

HTML ile Biçimlendirilmiş Mesaj

curl -X PUT \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "msgtype": "m.text",
    "body": "Derleme Başarısız\nProje: MyApp\nHata: Module not found",
    "format": "org.matrix.custom.html",
    "formatted_body": "
❌ Derleme Başarısız
Proje: MyApp
Hata: Module not found
"
  }' \
  "https://matrix.org/_matrix/client/r0/rooms/YOUR_ROOM_ID/send/m.room.message/$(date +%s)"

Resmi Dokümantasyon: Matrix Client-Server API Spesifikasyonu

WhatsApp Business Botu

WhatsApp, otomatik mesajlaşma için Business API sunar, ancak işletme doğrulaması gerektirir ve diğer platformlardan daha karmaşık bir kuruluma sahiptir.

Adım Adım Kurulum

1. Meta Business Hesabı Oluştur - business.facebook.com adresini ziyaret et ve bir işletme hesabı oluştur
2. WhatsApp Business'ı Kur - developers.facebook.com adresine git, bir uygulama oluştur ve WhatsApp ürününü ekle
3. Telefon Numarası Yapılandır - Botun için bir telefon numarası ekle (geliştirme için test numaraları mevcuttur)
4. Erişim Token'ı Al - Uygulama panosundan kalıcı bir erişim token'ı oluştur
5. İşletmeyi Doğrula - Üretim kullanımı için işletme doğrulamasını tamamla

Cloud API Aracılığıyla Mesaj Gönderme

curl -X POST \
  "https://graph.facebook.com/v17.0/YOUR_PHONE_NUMBER_ID/messages" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "RECIPIENT_PHONE_NUMBER",
    "type": "text",
    "text": {"body": "✅ Derleme başarıyla tamamlandı!"}
  }'

Resmi Dokümantasyon: WhatsApp Cloud API Dokümantasyonu

Facebook Messenger Botu

Facebook Messenger botları bir Facebook Uygulaması ve Sayfası gerektirir, mesajlar Send API aracılığıyla gönderilir.

Adım Adım Kurulum

1. Facebook Uygulaması Oluştur - developers.facebook.com adresini ziyaret et ve yeni bir uygulama oluştur ("İşletme" tipini seç)
2. Messenger Ürününü Ekle - Uygulama panosunda "Ürün Ekle"ye tıkla ve Messenger'ı seç
3. Facebook Sayfasını Bağla - Uygulamanı bir Facebook Sayfasına bağla (gerekirse bir tane oluştur)
4. Sayfa Erişim Token'ı Oluştur - Messenger ayarlarında, sayfan için bir token oluştur
5. PSID Al - Kullanıcılar önce sayfana mesaj göndermelidir; webhook olaylarından Page-Scoped ID'lerini (PSID) yakala

Send API Aracılığıyla Mesaj Gönderme

curl -X POST \
  "https://graph.facebook.com/v17.0/me/messages" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": {"id": "USER_PSID"},
    "message": {"text": "✅ Derleme başarıyla tamamlandı!"},
    "access_token": "YOUR_PAGE_ACCESS_TOKEN"
  }'

Resmi Dokümantasyon: Facebook Messenger Platform Dokümantasyonu

Kolay Bot Desteği Olmayan Mesajlaşma Uygulamaları

Aşağıdaki mesajlaşma uygulamaları, otomasyon özelliklerinden ziyade gizlilik ve güvenliğe öncelik verir, bu da webhook tabanlı bot entegrasyonunu imkansız veya pratik olmayan hale getirir:

• Signal - Resmi bir bot API'si yok. Signal, uçtan uca şifrelemeye ve kullanıcı gizliliğine öncelik verir, güvenliği tehlikeye atabilecek otomasyon özelliklerinden kasıtlı olarak kaçınır.
• Session - Bot altyapısı olmayan merkeziyetsiz mesajlaşma uygulaması. Soğan yönlendirme mimarisi, otomatik mesajlaşmayı pratik olmaktan çıkarır.
• Briar - Aktivistler ve gazeteciler için tasarlanmış eşler arası mesajlaşma uygulaması. Sunucu altyapısının olmaması, webhook özelliğinin olmadığı anlamına gelir.
• Wire