İçeriğe atla
OrqLabs

Yardımcı

Webhook entegrasyonu: Zapier, Make veya kendi sisteminize imzalı veri

Custom Webhook, OrqLabs'tan herhangi bir HTTPS adresine veri göndermenin yoludur. Zapier, Make, n8n veya kendi sunucunuz üzerinden katalogda olmayan sistemlere bağlanırsınız; istekler isteğe bağlı olarak HMAC-SHA256 ile imzalanır.

Bağlantı türü
Özel
Kapsam
Organizasyon bazlı: tüm projeler aynı anahtarı kullanır
Yetenekler
CRM senkronu
Kurulum süresi
10 dk

OrqLabs'ta ne işe yarar?

Webhook entegrasyonu, OrqLabs'ın katalogda bulunmayan herhangi bir sisteme veri aktarmasını sağlar. Webhook gönder kutusu kendisine gelen öğeleri JSON olarak POST eder; CRM'e yaz kutusunda hedef olarak Custom Webhook seçildiğinde de her müşteri adayı aynı adrese ayrı bir istek olarak gider. Böylece Pipedrive veya Salesforce gibi CRM'lere Zapier, Make ya da n8n üzerinden ulaşırsınız.

Bağlantıda bir imza anahtarı tanımlarsanız her istek, Unix zaman damgası ile ham gövdenin birleşimi üzerinden HMAC-SHA256 ile imzalanır; imza ve zaman damgası ayrı başlıklarda gelir. Sunucunuz imzayı doğrulayıp eski zaman damgalı istekleri reddederek sahte ve tekrar oynatılan istekleri ayıklar. Extra headers alanına Authorization gibi kendi başlıklarınızı da ekleyebilirsiniz.

Webhook gönder kutusu isteği 10 saniyelik zaman aşımıyla gönderir. Bağlı hesapla yapılan gönderimlerde ağ hatası, 429 ve 5xx yanıtları otomatik olarak yeniden denenir, diğer 4xx yanıtları yeniden denenmez; başarısız gönderimler kutunun hata çıkışından ayrı bir yola yönlendirilebilir.

Neleri otomatikleştirebilirsiniz?

  • Zapier veya Make ile her yere

    Zapier'deki Catch Hook ya da Make'teki Custom webhook adresini Endpoint URL olarak girin; nitelikli adayları, yayınlanan gönderileri veya rapor özetlerini oradan diğer uygulamalarınıza dağıtın.

  • Kendi CRM'inize aday aktarımı

    CRM'e yaz kutusunda Custom Webhook'u seçin; her müşteri adayı ayrı ve imzalı bir istek olarak sisteminize ulaşır.

  • Ajan çıktısını iç sistemlere

    Bir ajan kutusundan sonra Webhook gönder ekleyerek raporu, içerik planını veya aday listesini kendi panelinize ya da veri ambarınıza iletin.

  • İş akışı olmadan olay aboneliği

    Ayarlar → Webhook'lar ekranında aday nitelendi, gönderi yayınlandı veya bütçe uyarısı gibi platform olayları için uç nokta tanımlayabilirsiniz (Giden webhook'lar).

Bu entegrasyonu kullanan kutular

İş akışı editöründe bu kutular Custom Webhook hesabınızla çalışır.

  • CRM'e yaz

    Müşteri adaylarını HubSpot, Google Sheets, Notion veya kendi sisteminize aktarır; ör. nitelikli adayları satış ekibinin tablosuna eklemek için.

  • Webhook gönder

    Akıştaki bilgileri başka bir sistemin adresine imzalı olarak gönderir; ör. nitelikli müşteri adaylarını CRM'inize aktarmak için.

Kurulum özeti

  1. Hedef sistemde webhook adresini alın: Zapier'de Webhooks by Zapier → Catch Hook (imza doğrulayacaksanız Catch Raw Hook), Make'te Custom webhook, n8n'de Webhook node'unun Production URL'si.

  2. OrqLabs'ta Entegrasyonlar → Custom Webhook → Bağla'ya tıklayın ve Endpoint URL alanına adresi girin.

  3. İsteğe bağlı olarak Signing secret ve JSON biçiminde Extra headers girin.

  4. Bağlantıyı test et adresinize küçük bir deneme isteği gönderir ve dönen durum kodunu gösterir.

  5. İş akışına Webhook gönder kutusunu ekleyin, bağlı hesap olarak bu kaydı seçin; olay adını (varsayılan workflow.output) dilediğiniz gibi değiştirin.

Tam kurulum rehberini okuyun →

Gereksinimler

  • Herkese açık bir HTTPS adresi; iç ağ ve özel IP adresleri güvenlik nedeniyle reddedilir.
  • Adresin isteği 10 saniye içinde 2xx ile yanıtlaması; uzun işleri kuyruğa alıp hemen yanıt verin.
  • İmza kullanacaksanız sizin ürettiğiniz bir gizli anahtar (ör. openssl rand -hex 32).
  • OrqLabs'ta Sahip veya Yönetici rolü.

Bağlanırken istenen bilgiler

  • Endpoint URL *
  • Signing secret (optional)
  • Extra headers (JSON)

Bilmeniz gerekenler

  • Bu entegrasyon yalnızca dışarı gönderir. Dış bir sistemin OrqLabs iş akışını başlatması için Webhook tetikleyicisini kullanın (rehber).
  • Webhook gönder kutusuna adresi doğrudan yazarsanız istek, bu entegrasyondaki imza anahtarı ve ek başlıklar olmadan gider; imzalı gönderim için bağlı Custom Webhook hesabını seçin.
  • Yeniden denemeler nedeniyle aynı veri birden fazla kez ulaşabilir; alıcı tarafta e-posta veya kayıt kimliğiyle tekilleştirme yapın.
  • Zapier ve Make kendi görev ve işlem limitlerini uygular.

Sık sorulan sorular

Kod yazmadan kullanabilir miyim?

Evet. Zapier veya Make'in verdiği adresi Endpoint URL olarak girmeniz yeterlidir; imza isteğe bağlıdır.

HMAC imzasını nasıl doğrularım?

Gelen zaman damgasını ve ham istek gövdesini aralarına nokta koyarak birleştirin, imza anahtarınızla HMAC-SHA256 hesaplayın ve sha256= önekli imza başlığıyla sabit zamanlı karşılaştırın. Gövdeyi yeniden serileştirmeyin; başlık adları ve Node.js örneği yardım rehberindedir.

Gelen webhook ile farkı ne?

Custom Webhook OrqLabs'tan dışarı veri gönderir. Dışarıdan bir iş akışını başlatmak için iş akışına Webhook tetikleyicisini eklersiniz; bu tetikleyici isteğe bağlı olarak X-Webhook-Secret başlığındaki paylaşılan anahtarı doğrular.

Sunucum ne kadar sürede yanıt vermeli?

10 saniye içinde 2xx dönmelidir. Uzun işlemleri kuyruğa alıp hemen 202 yanıtı vermeniz önerilir.

OrqLabs ile başlayın

İlk iş akışınızı bugün kurun

Ücretsiz planla başlayın: hesaplarınızı bağlayın, bir şablon seçin, onay adımlarıyla kontrol sizde kalsın. Kredi kartı gerekmez.