Webhook nedir, mesaj bize nasıl ulaşır

Meta yeni mesajı panele nasıl bildirir, abonelik nedir, neden bazen "Webhook aboneliğini yenile" düğmesi çıkar.

Son güncelleme: 30 Eylül 2026

Bu sayfada

Ne işe yarar
Abonelik nasıl kurulur
Bir mesaj panele nasıl ulaşır
Güvenlik tarafı
Sizin yapmanız gereken var mı
Somut bir örnek
Sık yapılan hatalar ve çözümleri
İlgili makaleler

Webhook, Meta'nın yeni bir olayı {{brand.name}}'e kendiliğinden haber vermesi demektir. Panel Meta'ya "yeni mesaj var mı" diye sürekli sormaz; biri size DM yazdığı anda Meta bize bir bildirim gönderir ve mesaj saniyeler içinde gelen kutunuza düşer. Bu makale o yolun nasıl kurulduğunu ve bozulduğunda ne olduğunu anlatır.

Ne işe yarar

Webhook olmadan gelen kutusu boş kalır. Şu olayların hepsi bu yolla gelir:

Yeni DM ve WhatsApp mesajı
Butona basılması, hızlı yanıt seçilmesi
Mesajın okunduğu bilgisi ve tepkiler
Yeni yorumlar, canlı yayın yorumları ve etiketlenmeler
Reklam ya da etiketli bağlantı üzerinden gelen sohbetlerin kaynağı

Otomasyonlarınız da bu olaylarla tetiklenir: anahtar kelime tetikleyicisi, bir mesajın panele ulaşmasıyla çalışır.

Abonelik nasıl kurulur

Hesabı bağladığınız anda panel, arka planda Meta'ya "bu hesabın olaylarını bana gönder" der. Buna abonelik denir ve nereye yapıldığı kanala göre değişir:

Instagram ile bağlanan hesap — abonelik doğrudan Instagram hesabına yapılır.
Facebook sayfası üzerinden bağlanan hesap — abonelik hesabın bağlı olduğu sayfaya yapılır. Sayfa aboneliği yapılamazsa mesaj hiç gelmez.
WhatsApp numarası — abonelik numaraya değil, numaranın bağlı olduğu WhatsApp işletme hesabına yapılır. Yani aynı işletme hesabındaki bütün numaraların olayları aynı abonelikle akar.

✅ Bu yüzden aynı WhatsApp işletme hesabında iki numaranız varsa ve birinin bağlantısını keserseniz, öbürü çalışmaya devam eder: ortak abonelik ancak son numara ayrıldığında kaldırılır.

Abonelik bağlanma anında başarısız olursa hesap bağlı kalır ama durumu hata olur ve kartta "Webhook aboneliği yapılamadı; mesajlar gelmeyebilir" yazar. Bu durumda karttaki Webhook aboneliğini yenile düğmesi çıkar.

Bir mesaj panele nasıl ulaşır

Sıra şudur:

Kişi size yazar. Instagram ya da WhatsApp mesajı alır.
Meta bize bildirim gönderir. Bildirimin içinde hesap kimliği, gönderen ve mesaj vardır.
Panel imzayı doğrular. Her bildirim Meta tarafından imzalanır; imzası tutmayan istek reddedilir. Böylece Meta adına sahte istek gönderilemez.
Bildirim kalıcı bir kuyruğa yazılır. Meta'ya hemen "aldım" yanıtı döner; işleme bundan sonra başlar. Bu ayrım önemlidir: panel yoğunsa bile Meta bekletilmez ve hiçbir bildirim kaybolmaz.
Kuyruk işlenir. Mesaj kişiyle eşleştirilir, yazışmaya eklenir ve gelen kutusunda görünür.
Otomasyonlar çalışır. Mesajın tetiklediği akış hemen yanıt verir.

İşleme sırasında geçici bir aksaklık olursa bildirim yeniden denenir; denemeler arası süre artarak en çok 8 kez tekrarlanır. Bu yüzden kısa süreli bir aksaklıkta mesaj kaybolmaz, biraz gecikerek gelir.

⚠️ Not: Aynı bildirim iki kez gelirse ikinci kez işlenmez ve aynı mesaj yazışmaya iki kez düşmez. Meta bazen aynı bildirimi yineler; bu koruma o yüzden vardır.

Güvenlik tarafı

İmza denetimi. İmzası geçersiz olan istek hiçbir şey yapamaz; reddedilir.
Eski bildirimler kabul edilmez. Bildirimin kendi zamanına bakılır; 24 saatten eski bir gövde yeniden gönderilse bile işlenmez. Bu, eski bir bildirimi kaydedip sonradan yeniden oynatma denemesini boşa çıkarır.
Tek uç. Bütün hesaplar tek bir güvenli adrese bildirim alır; hesap başına ayrı bir adres yoktur ve sizden hiçbir teknik ayar istenmez.

Sizin yapmanız gereken var mı

Normalde hayır. Abonelik bağlanma anında kurulur, bakımı sistem yapar. Yalnız iki durumda müdahale edersiniz:

Kart hata durumunda ve nedeni abonelikse: Webhook aboneliğini yenile'ye basın. Başarılı olursa kart Aktif'e döner ve "Webhook aboneliği yenilendi" yazar.
Yenileme de başarısız olursa hesabı yeniden bağlayın; genellikle sorun abonelikte değil, anahtarın ya da izinlerin geçersizliğindedir.

Somut bir örnek

Bir yedek parça satıcısısınız ve Instagram hesabınızı yeni bağladınız. Kart Aktif görünüyor ama bir arkadaşınızdan test DM'i istediğinizde mesaj gelmiyor. Bağlantı sayfasını açıp karta bakıyorsunuz: durum hata, altında "Webhook aboneliği yapılamadı; mesajlar gelmeyebilir" yazıyor. Webhook aboneliğini yenile'ye basıyorsunuz, "Webhook aboneliği yenilendi" mesajını alıyorsunuz ve arkadaşınıza tekrar yazmasını söylüyorsunuz. Bu kez mesaj saniyeler içinde geliyor. Karttaki Son olay satırı da "az önce" diyor; bu satır aboneliğin çalıştığının en hızlı kanıtıdır.

Sık yapılan hatalar ve çözümleri

Mesaj gelmiyor diye hesabı silip yeniden bağlamak. Önce Webhook aboneliğini yenile'yi deneyin; çoğu durumda yeter ve verileriniz yerinde kalır.
Kendi hesabınızdan kendinize yazmak. Kendi hesabınızdan gönderdiğiniz mesaj gelen kutusunda bir müşteri mesajı gibi davranmaz. Test için başka bir hesap kullanın.
"Son olay" satırına bakmamak. Bu satır en son ne zaman bir olay geldiğini söyler; aboneliğin gerçekten çalışıp çalışmadığını en hızlı oradan anlarsınız.
Facebook yolunda sayfa izinlerini eksik vermek. Sayfa aboneliği izni olmadan abonelik hiç kurulamaz; hesap bağlı görünür ama sessiz kalır.
Aboneliği düzeltip onay sorununu unutmak. Abonelik çalışsa bile Meta onayı yoksa yalnız uygulamada rolü olan kişilerin mesajları iletilir; bkz. Meta uygulaması ve App Review.

İlgili makaleler

Bu makale yardımcı oldu mu?