Botlar için Messenger API & Webhook Entegrasyonu (2026 Eğitimi)

Geliştirme süreçlerini hızlandırmanın en pratik yollarından biri, messenger botları aracılığıyla bildirimleri otomatikleştirmektir. Build tamamlandığında, hata oluştuğunda veya deployment başarıyla bittiğinde anında uyarı alırsın. Bu rehber, popüler mesajlaşma platformlarında webhook tabanlı otomatik mesaj gönderen botları nasıl kuracağını adım adım gösteriyor. CI/CD sonuçlarını, sunucu uyarılarını veya süreç tamamlanmalarını ekibine bildirmek mi istiyorsun? Bu entegrasyonlar işini çok kolaylaştıracak. Yalnızca bot desteği kolay olan platformları ele aldık. Gizliliği ön planda tutan ve otomasyonu desteklemeyen güvenli mesajlaşma uygulamaları ise ayrı bir bölümde listelendi.

Webhook Tabanlı Bot Otomasyonunu Anlamak

Webhook tabanlı botların çalışma mantığı oldukça basittir. Uygulaман bir URL'ye HTTP POST isteği gönderir. Mesajlaşma platformu da bu içeriği ilgili kanala veya kullanıcıya iletir.

Bu yaklaşım pek çok otomasyon görevi için idealdir:

• Build bildirimleri - Build başarılı ya da başarısız olduğunda hata detaylarıyla birlikte uyarı gönder
• Deployment güncellemeleri - Kodun staging veya production ortamına ulaştığında ekibi bilgilendir
• İzleme uyarıları - Sunucu sağlık uyarıları veya kesinti bildirimleri gönder
• Zamanlanmış raporlar - Günlük metrik özetleri veya durum raporları ilet

Temel iş akışı üç adımdan oluşur:

1. Hedef platformda bir bot veya webhook URL'si oluştur
2. Otomasyon aracını (CI/CD, izleme sistemi veya özel script) HTTP istekleri gönderecek şekilde yapılandır
3. Mesaj payload'ını platformun gereksinimlerine göre biçimlendir

Doğru platformu seçmek, güvenlik özelliklerine de bağlıdır. Platform güvenliğini daha ayrıntılı incelemek için 2026 Yılı İçin Kapsamlı Messenger Rehberimize göz atabilirsin.

Messenger Bot Entegrasyon Rehberleri

Aşağıda, webhook tabanlı bot entegrasyonunu kolayca destekleyen her platform için adım adım kurulum rehberleri yer almaktadır.

Discord Webhook Bot

Discord, en kolay webhook kurulumuna sahip platformlardan biridir. Temel mesaj göndermek için bir bot uygulamasına veya kimlik doğrulama token'ına ihtiyaç yoktur.

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ğundan "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'a bir isim ver (örn. "Build Bot"), bir kanal seç ve isteğe bağlı olarak avatar ekle
5. Webhook URL'sini Kopyala - "Webhook URL'sini Kopyala"ya tıkla ve güvenli bir yerde sakla

Webhook ile Mesaj Gönderme

curl -X POST -H "Content-Type: application/json" \
  -d '{"content": "✅ Build completed successfully!\n\nProject: MyApp\nBranch: main\nDuration: 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": "❌ Build Failed",
      "color": 15158332,
      "fields": [
        {"name": "Project", "value": "MyApp", "inline": true},
        {"name": "Branch", "value": "feature/login", "inline": true},
        {"name": "Error", "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 Bot

Slack, Slack Apps sistemi kapsamında Incoming Webhook'ları destekler. Zengin mesaj biçimlendirmesi ve esnek kanal hedefleme imkanı sunar.

Adım Adım Kurulum

1. Slack Uygulaması Oluştur - api.slack.com/apps adresine git ve "Yeni Uygulama Oluştur"a tıkla
2. Oluşturma Yöntemini Seç - "Sıfırdan" seçeneğini seç ve uygulamana bir isim ver (örn. "CI/CD Bildirimleri")
3. Incoming Webhook'ları Etkinleştir - Kenar çubuğundan "Incoming Webhooks"a git ve açık konuma getir
4. Çalışma Alanına Webhook Ekle - "Çalışma Alanına Yeni Webhook Ekle"ye tıkla
5. Kanal Seç - Bildirimlerin gönderileceği kanalı seç ve "İzin Ver"e tıkla
6. Webhook URL'sini Kopyala - Sana özel webhook URL'si ekranda görünecektir

Webhook ile Mesaj Gönderme

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ Deployment to production completed successfully!"}' \
  https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXX

Ayrıntılı Bildirimler için Block Kit Mesajı

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "blocks": [
      {
        "type": "header",
        "text": {"type": "plain_text", "text": "🚨 Build Failed"}
      },
      {
        "type": "section",
        "fields": [
          {"type": "mrkdwn", "text": "*Project:*\nMyApp"},
          {"type": "mrkdwn", "text": "*Branch:*\nmain"},
          {"type": "mrkdwn", "text": "*Error:*\n`Module not found`"}
        ]
      }
    ]
  }' \
  YOUR_WEBHOOK_URL

Resmi Dokümantasyon: Slack Incoming Webhooks Rehberi

Microsoft Teams Webhook Bot

Microsoft Teams, kanal bildirimleri için Incoming Webhook'ları destekler. Bunlar, connector sistemi üzerinden yapılandırılır.

Adım Adım Kurulum

1. Kanal Ayarlarını Aç - Hedef kanala git ve kanal adının yanındaki üç noktaya (•••) tıkla
2. Connector'ları Seç - "Connector'lar"a tıkla (yeni sürümlerde "Kanalı Yönet" ardından "Connector'lar")
3. Incoming Webhook'u Bul - "Incoming Webhook" ara ve "Yapılandır"a tıkla
4. Webhook'a İsim Ver - Bir isim gir (örn. "Build Uyarıları") ve isteğe bağlı olarak bir görsel yükle
5. Oluştur ve URL'yi Kopyala - "Oluştur"a tıkla ve webhook URL'sini kopyala

Webhook ile Mesaj Gönderme

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ Build #1234 completed successfully on main branch"}' \
  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": "❌ Build Failed"},
          {"type": "FactSet", "facts": [
            {"title": "Project:", "value": "MyApp"},
            {"title": "Error:", "value": "Compilation failed"}
          ]}
        ]
      }
    }]
  }' \
  YOUR_TEAMS_WEBHOOK_URL

Resmi Dokümantasyon: Microsoft Teams Incoming Webhooks

Telegram Bot

Telegram, programatik mesaj göndermek için güçlü bir Bot API'sine sahiptir. Webhook URL'si yerine, istekleri doğrudan Telegram'ın API'sine gönderirsin.

Adım Adım Kurulum

1. BotFather ile Bot Oluştur - Telegram'ı aç ve @BotFather hesabını ara
2. Yeni Bot Başlat - /newbot komutunu gönder
3. Botuna İsim Ver - Görünen ad ve kullanıcı adını belirlemek için yönergeleri takip et (kullanıcı adı "bot" ile bitmeli)
4. API Token'ını Kaydet - BotFather sana 123456789:ABCdefGHIjklMNOpqrsTUVwxyz formatında bir token verir
5. Chat ID'yi Al - Botu grubuna veya kanalına ekle, bir mesaj gönder, ardından https://api.telegram.org/bot<TOKEN>/getUpdates adresini ziyaret ederek chat ID'yi bul

Bot API ile Mesaj Gönderme

curl -X POST \
  "https://api.telegram.org/bot/sendMessage" \
  -d "chat_id=" \
  -d "text=✅ Build completed successfully!%0A%0AProject: 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": "❌ Build Failed\n\nProject: MyApp\nBranch: main\nError: Module not found",
    "parse_mode": "HTML"
  }'

Resmi Dokümantasyon: Telegram Bot API

Mattermost Webhook Bot

Mattermost, Slack'e açık kaynaklı bir alternatiftir. Güçlü webhook desteğine sahiptir ve kendi sunucunda barındırılan ekip iletişimi için oldukça uygundur.

Adım Adım Kurulum

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

Webhook ile Mesaj Gönderme

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ Build completed successfully!"}' \
  https://your-mattermost-server.com/hooks/YOUR_WEBHOOK_ID

Zengin Ek Mesajı

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "attachments": [{
      "fallback": "Build Failed",
      "color": "#FF0000",
      "title": "❌ Build Failed",
      "fields": [
        {"short": true, "title": "Project", "value": "MyApp"},
        {"short": true, "title": "Branch", "value": "main"},
        {"short": false, "title": "Error", "value": "```Module not found```"}
      ]
    }]
  }' \
  YOUR_WEBHOOK_URL

Resmi Dokümantasyon: Mattermost Incoming Webhooks

Matrix/Element Bot

Matrix, merkezi olmayan iletişim için açık bir protokoldür. Element ise en popüler istemcisidir. Bot entegrasyonu için Matrix Client-Server API'sini kullanırsın.

Adım Adım Kurulum

1. Bot Hesabı Oluştur - Kendi homeserver'ında veya matrix.org üzerinde bot için yeni bir Matrix hesabı kaydet
2. Erişim Token'ını Al - Oturum aç ve Element'te erişim token'ını bul: Ayarlar - Yardım ve Hakkında - Gelişmiş - Erişim Token'ı
3. Oda ID'sini Al - Botu hedef odaya ekle, ardından oda ID'sini Oda Ayarları - Gelişmiş bölümünden bul
4. Botu Odaya Davet Et - Bot hesabının mesaj göndereceği odaya katıldığından emin ol

Matrix API ile Mesaj Gönderme

curl -X PUT \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"msgtype": "m.text", "body": "✅ Build completed successfully!"}' \
  "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": "Build Failed\nProject: MyApp\nError: Module not found",
    "format": "org.matrix.custom.html",
    "formatted_body": "
❌ Build Failed
Project: MyApp
Error: 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 Bot

WhatsApp, otomatik mesajlaşma için bir Business API sunar. İşletme doğrulaması gerektirir ve diğer platformlara kıyasla kurulumu daha karmaşıktır.

Adım Adım Kurulum

1. Meta İşletme 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ını Yapılandır - Bot için bir telefon numarası ekle (geliştirme aşamasında test numaraları mevcuttur)
4. Erişim Token'ını Al - Uygulama kontrol panelinden kalıcı bir erişim token'ı oluştur
5. İşletme Doğrulamasını Tamamla - Yayına geçmeden önce işletme doğrulamasını tamamla

Cloud API ile 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": "✅ Build completed successfully!"}
  }'

Resmi Dokümantasyon: WhatsApp Cloud API Dokümantasyonu

Facebook Messenger Bot

Facebook Messenger botları için bir Facebook Uygulaması ve Sayfası gereklidir. Mesajlar Send API aracılığıyla gönderilir.

Adım Adım Kurulum

1. Facebook Uygulaması Oluştur - developers.facebook.com adresine git ve yeni bir uygulama oluştur ("İşletme" türünü seç)
2. Messenger Ürününü Ekle - Uygulama kontrol panelinde "Ürün Ekle"ye tıkla ve Messenger'ı seç
3. Facebook Sayfasını Bağla - Uygulamana bir Facebook Sayfası bağla (gerekirse yeni bir sayfa oluştur)
4. Sayfa Erişim Token'ı Oluştur - Messenger ayarlarında sayfan için bir token oluştur
5. PSID'yi Al - Kullanıcıların önce sayfana mesaj göndermesi gerekir. Webhook olaylarından onların Page-Scoped ID'lerini (PSID) yakala

Send API ile 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": "✅ Build completed successfully!"},
    "access_token": "YOUR_PAGE_ACCESS_TOKEN"
  }'

Resmi Dokümantasyon: Facebook Messenger Platform Dokümantasyonu

Bot Desteği Olmayan Uygulamalar

Aşağıdaki mesajlaşma uygulamaları gizlilik ve güvenliği ön planda tutar. Bu nedenle webhook tabanlı bot entegrasyonu ya mümkün değildir ya da pratikte uygulanamaz:

• Signal - Resmi bir bot API'si yoktur. Signal, uçtan uca şifrelemeye odaklanır ve güvenliği azaltabilecek otomasyon özelliklerinden kaçınır.
• Session - Bot altyapısı bulunmayan merkezi olmayan bir mesajlaşma uygulamasıdır. Onion routing mimarisi, otomatik mesajlaşmayı pratikte imkansız kılar.
• Briar - Aktivistler ve gazeteciler için tasarlanmış eşten eşe bir mesajlaşma uygulamasıdır. Sunucu altyapısı olmadığından webhook desteği de yoktur.
• Wire - Bazı kurumsal API özellikleri sunsa da otomatik bildirimler için basit bir webhook sistemi yoktur.
• Wickr - Kamuya açık bir bot API'si bulunmayan kurumsal odaklı bir platformdur. Otomasyon için özel entegrasyon gerektiren Wickr Enterprise gereklidir.
• SimpleX - Kullanıcı tanımlayıcıları olmadan tasarlanmıştır; bu durum, bot entegrasyonunu mimarisiyle uyumsuz kılar.
• Threema - İşletmeler için Threema Gateway sunar; ancak bu, sözleşme gerektiren ücretli bir hizmettir ve basit bir webhook kurulumu değildir.
• Viber - Bot API'si mevcuttur; ancak işletme hesabı onayı gerektirir ve geliştirici bildirimleri için değil, müşteri hizmetleri için tasarlanmıştır.
• LINE - Messaging API sunar; ancak işletme hesabı doğrulaması gerektirir ve basit bildirim kullanım senaryoları için oldukça karmaşıktır.
• WeChat - Resmi Hesap API'sine sahiptir; ancak Çin'de işletme kaydı ve devlet onayı gerektirir.

Güvenli iletişim için bu platformları tercih ediyorsan, otomasyon için desteklenen bir platformla birlikte kullanmayı düşünebilirsin. Ayrıca özel mesajlarını gerçekten güvende tutma rehberimizi de okuyabilirsin.

Pratik Uygulama Örneği

Aşağıda, aynı anda birden fazla platforma build bildirimi gönderen eksiksiz bir Node.js örneği yer almaktadır:

const axios = require('axios');

const notifiers = {
  discord: async (message, webhookUrl) => {
    await axios.post(webhookUrl, { content: message });
  },

  slack: async (message, webhookUrl) => {
    await axios.post(webhookUrl, { text: message });
  },

  telegram: async (message, token, chatId) => {
    await axios.post(`https://api.telegram.org/bot${token}/sendMessage`, {
      chat_id: chatId,
      text: message,
      parse_mode: 'HTML'
    });
  },

  teams: async (message, webhookUrl) => {
    await axios.post(webhookUrl, { text: message });
  }
};

async function notifyBuildResult(success, project, branch, error = null) {
  const emoji = success ? '✅' : '❌';
  const status = success ? 'succeeded' : 'failed';
  let message = `${emoji} Build ${status}\n\nProject: ${project}\nBranch: ${branch}`;
  if (error) message += `\nError: ${error}`;

  const notifications = [
    notifiers.discord(message, process.env.DISCORD_WEBHOOK),
    notifiers.slack(message, process.env.SLACK_WEBHOOK),
    notifiers.telegram(message, process.env.TELEGRAM_TOKEN, process.env.TELEGRAM_CHAT_ID),
    notifiers.teams(message, process.env.TEAMS_WEBHOOK)
  ];

  await Promise.allSettled(notifications);
}

// CI/CD pipeline'ında kullanım
notifyBuildResult(false, 'MyApp', 'main', 'Module not found: @utils/helper');

Sonuç

Webhook tabanlı bot bildirimlerini mesajlaşma platformlarına entegre etmek, geliştirme iş akışına güçlü bir otomasyon katmanı ekler. Discord ve Slack, basit webhook URL'leriyle başlamak için en kolay seçeneklerdir. Telegram, güvenilir ve kurulumu kolay bir alternatiftir. Kurumsal ekipler için Microsoft Teams ve Mattermost, mevcut araçlarla uyumlu şekilde çalışır. Matrix ise tam API erişimiyle kendi barındırdığın, gizlilik dostu bir seçenek sunar.

Tek bir platformla başla. Bildirim iş akışını test et. Ardından ihtiyaç duydukça yeni kanallar ekle. Yukarıdaki kod örnekleri hemen çalışmaya hazırdır. Bir sonraki adımın, seçtiğin platformda bir webhook oluşturmak ve ilk otomatik mesajını göndermek - bu 10 dakikadan az sürer.

Sıkça Sorulan Sorular