EN
DE
PLWebhook Entegrasyonları
Workexe olaylarını Slack, Jira, Zapier, Make, n8n veya kendi uç noktanıza gönderin. HMAC imzalarıyla teslimatları doğrulayın, başarısız payload'ları yeniden oynatın ve webhook'ları proje bazında kapsamlayın.
Giden ve gelen webhook'lar
Giden webhook'lar bir şey değiştiğinde Workexe olaylarını yığınınıza iter (sıralama düşüşü, denetim bitti, rapor dışa aktarıldı). Gelen webhook'lar dış araçların imzalı POST ile Workexe aksiyonları tetiklemesine izin verir (görev oluştur, tarama başlat).
- Giden: Workexe → URL'niz (en yaygın)
- Gelen: aracınız → Workexe API (otomasyon platformları)
- Her ikisi de şema sürümü v1 ile JSON payload destekler
- Müşteri verisi projeler arası karışmaz, proje bazlı uç noktalar
Desteklenen olay türleri
Tüm olaylara abone olun veya alt küme seçin. Payload'lar proje ID, olay adı, zaman damgası (ISO 8601) ve normalize veri nesnesi içerir.
- keyword.position_changed
- backlink.new_or_lost
- site_audit.crawl_completed
- report.export_ready
- task.created
- workflow.run_failed
- integration.connected
3 adımda kurulum
Pro ve Agency planlarda mevcuttur. Yerel bağlayıcılar için kod gerekmez; özel yığınlar için ham URL.
- Ayarlar → Entegrasyonlar → Webhook'lar → Uç nokta ekle
- URL yapıştır, olayları seç, imza gizliliğini kopyala
- Test olayı gönder, teslimat günlüğünde 2xx yanıtı doğrula
- Test geçince canlı teslimatı etkinleştir
Güvenlik ve doğrulama
Her teslimat X-Workexe-Signature içerir (ham gövde + zaman damgası HMAC-SHA256). Replay saldırılarını önlemek için 5 dakikadan eski istekleri reddedin.
- Kesinti olmadan imza gizliliği döndürme (24 saat örtüşme)
- Enterprise'da opsiyonel IP izin listesi
- Hedef URL'lerde TLS 1.2+ zorunlu
- Gizlilikler oluşturulduktan sonra asla döndürülmez, kasanızda saklayın
Yeniden deneme, günlükler ve hata ayıklama
Başarısız teslimatlar otomatik yeniden denenir. Tam istek/yanıt gövdeleri 90 gün saklanır.
- 3 yeniden deneme: 1 dk, 5 dk, 30 dk geri çekilme
- Teslimat günlüğü: durum, gecikme, yanıt kodu, payload hash
- Günlük satırından manuel yeniden oynatma (tek tık)
- Uç nokta 1 saatte 10 kez başarısız olursa uyarı e-postası
Yerel bağlayıcılar
Ham URL yerine arayüz mü tercih edersiniz? Aynı webhook motorunu saran yerleşik bağlayıcıları kullanın.
- Slack: kanal seçici, sıralama uyarıları için zengin bloklar
- Jira: etiket ve atanan ile otomatik issue oluşturma
- Zapier / Make / n8n: resmi Workexe uygulama tetikleyicileri
- Google Sheets: dışa aktarım veya sıralama değişiminde satır ekleme
- 1Projeyi Aç
webhook entegrasyonları modülünü proje panelinden başlatın.
- 2Kaynakları Bağla
GSC, GA4 ve gerekli CSV içe aktarımlarını ekleyin.
- 3Kapsamı Ayarla
Lokasyon, dil, cihaz ve uyarı eşiklerini belirleyin.
- 4Doğrula
İlk taramanın çıktısını bilinen bir sayfa/sorgu ile kontrol edin.