Entegrasyonun Vazgeçilmezi Webhook Nedir?

Teknoloji dünyasında birçok terimle karşılaşıyoruz, fakat bazıları var ki adeta sessiz kahramanlar gibi. İşte Webhook’lar da tam olarak böyle bir kavram. Peki, Webhook nedir ve neden bu kadar önemli?

Webhook’lar, iki sistem arasında gerçek zamanlı iletişimi sağlayan otomatik bildirim mekanizmalarıdır. Basitçe açıklamam gerekirse, bir uygulamanın diğerine “Hey, burada bir şeyler oldu, haberdar olmalısın!” demesinin modern yoludur.

WebHook Nasıl Çalışır ?

Günlük hayattan bir örnekle açıklayalım: Bir kargo firmasının SMS bildirimi sistemini düşünün. Paketiniz teslim edildiğinde otomatik olarak bir mesaj alırsınız. İşte webhook’lar da aynen böyle çalışır — bir olay gerçekleştiğinde, önceden belirlenmiş bir adrese otomatik olarak bilgi gönderir.

Teknik açıdan örnek vermek gerekirse:

{    "event_type": "kargo_teslim",    "order_id": "12345",    "timestamp": "2024-03-21T10:30:00Z",    "details": {        "customer_name": "Hüseyin Karacif",        "total_amount": 150.00,        "status": "onaylandi"    }}

Günlük Hayatımızdaki Webhook’lar

Büyük şirketlerden örnek uygulamaları aşağıda görebilirsiniz. Webhook’lar her yerde. Orada bir köy var uzakta, bilmesekte, görmesekte 😄

Github Events

• PR açıldığında ekibin Slack kanalına otomatik bildirim gönderme
• Jenkins’te otomatik build tetikleme, CI/CD için.
• Proje yönetiminde kolaylıklar Jira’da oto task güncelleme

Github WebHook Events

Stripe, Paypal, Shopify

• Stripe — Başarılı ödemeler sonrası sipariş sisteminin otomatik güncellenmesi
• Stripe — Ödeme durumlarının satıcı sistemlerine anlık bildirimi
• Paypal — Başarısız ödemelerde müşteri hizmetlerine otomatik bildirim
• Paypal — Şüpheli işlem tespitinde güvenlik ekiplerine otomatik uyarı
• Shopify — Stok güncellemelerinin tedarikçilere anlık iletimi
• Shopify — Yeni sipariş oluştuğunda kargo firmasına otomatik bildirim

Stripe, Paypal, Shopify Webhook Events

Instagram

• Yeni bir fotoğraf paylaşıldığında Facebook’ta otomatik paylaşım
• İşletme hesaplarında etkileşim analizlerinin CRM sistemlerine aktarımı

Instagram Webhook Events

Slack Webhook Events

Webhooks denilince akla ilk gelen büyük firmalardan biriside nitekim Slack olmalı. Bu konuda ekipler gayet güzel bir ekosistem kurmuşlar. 👏

• Takım içi iletişimde diğer uygulamalardan gelen bildirimlerin entegrasyonu
• Trello, Jira gibi proje yönetim araçlarıyla anlık senkronizasyon

Slack Webhook Events

Incoming: Dış sistemlerden bildirim göndermek için

Outgoing: Basit chatbot/otomatik yanıtlar için

Slash Commands: Kullanıcı komutları ve interaktif işlemler için

Events: Karmaşık olay yakalama ve işleme için

Express ve Axios Kullanarak Ufak Bir Örnek

Javascript kullanarak ufak bir webhook örneği ile öğrendiklerimiz veya hatırladığımız bilgilerimizin pekişmesi için;

const express = require('express');
const app = express();

app.use(express.json());

app.post('/webhook', (req, res) => {
    try {
        const webhookData = req.body;
        
        console.log('Webhook verisi alındı:', webhookData);
        
        res.status(200).json({
            durum: 'başarılı',
            mesaj: 'Webhook verisi alındı'
        });
    } catch (hata) {
        res.status(500).json({
            durum: 'hata',
            mesaj: hata.message
        });
    }
});

// Sunucuyu başlatıp dinliyoruz...
const PORT = 3000;
app.listen(PORT, () => {
    console.log(`Sunucu ${PORT} portunda çalışıyor`);
});

Bir server oluşturduk, webhook endpointini dinleyecek gelen post isteklerini işleyip json bir mesaj dönecek şekilde yazdık.

const axios = require('axios');

const test = {
    olay: 'new_order',
    sipariş_id: '12345',
    müşteri: 'Hüseyin Karacif',
    tutar: 150.99
};

async function webhookSend() {
    try {
        const response = await axios.post('http://localhost:3000/webhook', test);
        console.log('Webhook yanıtı:', response.data);
    } catch (err) {
        console.error('Webhook hatası:', err.message);
    }
}

webhookSend();

Burada axios yeni siparişimizi http isteği ile webhook’a iletir. Sunucudan gelen yanıtı konsola yazdırıyoruz. Burada gelen siparişi anlık bildirim ile sunucuya göndermeyi test ettik.

Kısaca nasıl kullanılır değil, neden kullanıldığını ve nasıl bir mantığa sahip olduğunu öğrenmemiz yeterli.

Webhook vs. WebSocket vs. API: Temel Farklar

Son olarak Webhook’lar ile yeni tanışanlar sıklıkla WebSocket ve API’lerle karıştırabilir. Aralarındaki temel farkları bilmek gerekiyor.

Webhook (HTTP Push)

• Tek yönlü iletişim
• Olay tabanlı çalışır
• “Push” prensibi: Veri hazır olduğunda otomatik gönderilir
• Örnek: Ödeme bildirimleri, form gönderimleri

WebSocket

• Çift yönlü, gerçek zamanlı iletişim
• Sürekli açık bağlantı
• Canlı veri akışı gerektiğinde kullanılır
• Örnek: Canlı sohbet uygulamaları, online oyunlar, borsa verileri

API (REST/HTTP)

• İstemci tarafından tetiklenir (Pull)
• Düzenli aralıklarla sorgulama gerektirir
• Anlık bildirim özelliği yoktur
• Örnek: Hava durumu verilerini çekmek için yapılan periyodik sorgulamalar, ürün listesi alma, CRUD

Ne Zaman Hangisi Kullanılmalı?

• Webhook: Belirli olaylar gerçekleştiğinde anlık bildirim gerekiyorsa
• WebSocket: Gerçek zamanlı, çift yönlü iletişim gerekiyorsa
• API: Talep üzerine veri alışverişi yeterliyse

Bu konuda güzel bir kaynak bırakıyorum, her teknolojinin ihtiyaca ve duruma bağlı olarak kullanılacağını bilerek hareket etmemiz daha doğrudur.

Understanding API, Webhook, and WebSocket: When to Use Each

Okuduğunuz için Minnettarım. Sağlıcakla Kalın Dostlarım..