NetaWebhook, bir platformdaki olay gerçekleştiğinde başka bir sisteme gönderilen HTTP bildirimidir. Meta ekosisteminde yeni mesaj, yorum veya durum değişikliği gibi olaylar ilgili uygulamanın tanımladığı adrese iletilebilir.
Webhook tek başına müşteri mesajlaşması değildir: gelen olayın doğrulanması, doğru kanalla ilişkilendirilmesi, saklanması ve arayüzde gösterilmesi için sunucu tarafı işlem gerekir.
Bir webhook ile normal API isteği arasındaki fark
Normal API isteğinde uygulama bilgi almak için karşı sisteme soru sorar. Webhook modelinde ise olay gerçekleştiğinde platform uygulamaya haber verir. Bu ayrım yeni bir yorumu veya gelen mesajı sürekli sorgulamadan işlemek açısından önemlidir.
Webhook teslimatı anlık görünebilir; yine de ağ gecikmesi, yeniden teslimat veya farklı sırada gelen olaylar hesaba katılmalıdır. Bir olayı iki kez işlememek için olay kimliği ve kalıcı kayıt yaklaşımı gerekir.
İmza doğrulaması ve güvenlik
Bir HTTP isteğinin gerçekten beklenen kaynaktan geldiği varsayılamaz. İmza doğrulaması, yapılandırılmış gizli anahtar kullanılarak gelen bildirimin bütünlüğünü kontrol etmeye yardımcı olur.
Webhook adresini gizlemek tek başına güvenlik sağlamaz. Yetkiler, kimlik doğrulama, kayıt ve mümkün olan en az erişim ilkesi birlikte ele alınmalıdır.
NetaSocial içindeki karşılığı
NetaSocial’da Meta’dan gelen bildirimlerin imzası doğrulanır ve olaylar kaybolmaması için sıraya alınarak işlenir. Bu yapı, gelen olayın işlenmesini kullanıcı ekranındaki sayfa yüklenmesinden ayırır.
Webhook üzerinden gelen her olay aynı tür konuşma değildir. Instagram yorumu ile WhatsApp mesajının farklı yanıt yöntemleri ve izinleri vardır; NetaSocial bu kanal ayrımını koruyarak ortak gelen kutusunda gösterir.
Örnek olay: Instagram yorumunun ekrana ulaşması
Bir kullanıcı Instagram gönderisinin altına soru bıraktığında olay ilk olarak Meta tarafında oluşur. İlgili abonelik ve izinler bulunduğunda Meta uygulamanın webhook adresine olay bildirimi gönderir. Sunucu bu isteğin imzasını kontrol eder; bildirimi ayrıştırıp ilgili Instagram hesabı, gönderi ve yorumla eşleştirir. Sonrasında ekip panelindeki yorum görünümü güncellenebilir.
Bu akışın her aşaması ayrı sorumluluk taşır. Webhook’un 200 yanıtı vermesi, yorumun mutlaka veritabanına eksiksiz yazıldığı anlamına gelmez. İşleme kuyruğu başarısız işlemlerin tekrar ele alınmasını, hata kayıtları da sorunun hangi aşamada yaşandığını görmeyi kolaylaştırır.
Yoruma herkese açık cevap veya uygun durumlarda özel mesaj gönderme aşaması ise yeni bir dış API isteğidir. Gelen bildirim ve gönderilen yanıt aynı iş değildir; gönderim sonucu ayrıca doğrulanmalıdır.
Webhook entegrasyonunda kontrol listesi
Olay aboneliğinin doğru hesaba bağlı olduğunu, gerekli Meta izinlerinin geçerli olduğunu ve adresin doğrulanabildiğini kontrol edin. Üretim ortamında test hesabıyla çalışan izinlerin gerçek müşteri hesaplarında da geçerli olacağını varsaymayın.
İmza doğrulamasını atlamayın; olayları kimlikleriyle kaydedin, tekrarlı teslimatı güvenle işleyin, kuyruk gecikmesini ve hata sayılarını izleyin. Uygulamanın webhook adresini herkese açık hale getirmek, tüm yönetim uç noktalarını herkese açık yapmak anlamına gelmemelidir.
Sık sorulan sorular
Webhook çalışmazsa mesajlar kaybolur mu?
Tek başına webhook kullanımı böyle bir garanti vermez; tekrar deneme, olay kaydı ve hata izlemesi gerekir. NetaSocial’ın kalıcı işleme yaklaşımı bu riskin yönetimine yöneliktir.
Webhook ile otomatik cevap aynı şey mi?
Hayır. Webhook olayı sisteme bildirir; cevap gönderme ayrı bir iş akışı ve kanalın izinlerine bağlı bir işlemdir.
NetaSocial ile çalışma biçimini görün
Kanal, yorum ve ekip akışlarını 14 günlük ücretsiz denemede kendi hesaplarınızla inceleyin.
Ücretsiz Deneyin →