🌐 Webhook Tetikleyici

Webhook Tetikleyici, dış sistemlerin SmartFlow içinde iş akışlarını başlatmasını sağlamak için API istekleri aracılığıyla veri göndermesine olanak tanır. Bu tetikleyici, SmartFlow'u üçüncü taraf uygulamalarla entegre etmek için idealdir ve görevlerin dinamik ve kesintisiz otomasyonunu sağlar.

---

📝 Tetikleyici Detayları

Ad: Webhook
Kategori: Tetikleyiciler

---

🔧 Parametreler

1. Webhook URL

• Tür: string
• Açıklama: Webhook'un gelen istekleri almak için kullanılan uç nokta URL'si. Bu, bu tetikleyiciyi kullanan her iş akışı için otomatik olarak oluşturulur.
• Gerekli: Evet
• Örnek:

  https://api.smartflow.com/webhooks/{workflowId}

2. Payload

• Tür: object
• Açıklama: Dış sistem tarafından istek gövdesinde gönderilen veridir. Bu payload, entegrasyona bağlı olarak özel alanlar içerebilir.
• Gerekli: Evet
• Örnek:

  {
    "event": "order_created",
    "orderId": "12345",
    "customer": {
      "name": "John Doe",
      "email": "john@example.com"
    }
  }

3. Başlıklar

• Tür: object
• Açıklama: Dış sistemin kimlik doğrulama veya meta veri amaçları için dahil edebileceği isteğe bağlı başlıklardır.
• Gerekli: Hayır
• Örnek:

  {
    "Authorization": "Bearer your-api-key",
    "Content-Type": "application/json"
  }

---

🚀 Nasıl Çalışır

1. Webhook URL Yapılandırması:

   • Webhook Tetikleyici ile bir iş akışı oluşturulduğunda, SmartFlow webhook için benzersiz bir URL oluşturur.
   • Bu URL'yi dış sistemle paylaşarak entegrasyonlarını yapılandırmalarını sağlayın.

2. API Anahtarı Alma:

   • ChatModel Ayarları'na gidin.
   • Entegrasyon → Web bölümüne gidin.
   • Gerekli kimlik doğrulama jetonunu almak için API Anahtarını Kopyala'ya tıklayın.

3. Payload Yapısı:

   • Dış sistemler, HTTP POST isteği kullanarak webhook URL'sine veri (payload) gönderir.
   • Payload, iş akışının gerektirdiği yapıya uymalıdır.

4. Tetikleyici İcrası:

   • Webhook geçerli bir istek aldığında, ilişkili iş akışı otomatik olarak tetiklenir.
   • SmartFlow, payload'ı işler, tanımlı eylemleri gerçekleştirir ve gerekirse bir yanıt döner.

---

💡 Kullanım Senaryoları

1. CRM Entegrasyonu:

   • Senaryo: Bir müşteri CRM sisteminizde yeni bir hesap oluşturur.
   • Webhook: CRM, müşteri bilgileri ile birlikte SmartFlow'a bir POST isteği gönderir.
   • İş Akışı: Hoş geldin e-postası gönderir ve müşteriyi pazarlama listenize ekler.

2. Sipariş Yönetimi:

   • Senaryo: Bir e-ticaret platformu yeni bir siparişi işler.
   • Webhook: Platform, sipariş detaylarını SmartFlow'a gönderir.
   • İş Akışı: Stok güncellemeleri yapar, sipariş onay e-postası gönderir ve depoyu bilgilendirir.

3. Olay İzleme:

   • Senaryo: Bir izleme sistemi kritik bir hata tespit eder.
   • Webhook: Sistem, SmartFlow'a bir uyarı gönderir.
   • İş Akışı: Bir olay raporu oluşturur ve mühendislik ekibini bilgilendirir.

---

🔍 Örnek Konfigürasyon

Gelen Webhook İsteği

URL:

https://api.smartflow.com/webhooks/abc123

Yük:

{
  "event": "user_registered",
  "userId": "67890",
  "name": "Jane Doe",
  "email": "jane@example.com"
}

Başlıklar:

{
  "Authorization": "Bearer 123456789",
  "Content-Type": "application/json"
}

---

🛠️ En İyi Uygulamalar

1. Doğrulama:

   • Gelen istekleri doğrulayarak veri bütünlüğünü sağlamak ve kötüye kullanımı önlemek.
   • Kimlik doğrulama için güvenli başlıklar veya token'lar kullanın.

2. API Anahtarı Güvenliği:

   • ChatModel Ayarları → Entegrasyon → Web bölümünden alınan API anahtarının güvenli bir şekilde saklandığından ve kamuya açık olarak ifşa edilmediğinden emin olun.

3. Veri Eşleme:

   • Gelen alanları iş akışı değişkenlerine net bir şekilde eşleyerek sorunsuz bir işlem sağlamak.

4. Test Etme:

   • Uyum ve güvenilirliği sağlamak için örnek yüklerle webhook'u test edin.

5. Hata Yönetimi:

   • Eksik veya hatalı verileri nazikçe ele almak için iş akışlarını yapılandırın.

---

📊 İzleme ve Hata Ayıklama

• Etkinlik Günlükleri:
  SmartFlow'un kontrol panelinde gelen webhook isteklerini ve işleme durumlarını takip edin.

• Hata Raporlama:
  Başarısız istekleri tanımlayın ve sorun giderme için hata detaylarını görüntüleyin.

---

Bu bölüm, Webhook Tetikleyicisi için ayrıntılı bir rehber sunarak kullanıcıların bunu iş akışlarına sorunsuz bir şekilde entegre etmelerini sağlar. Herhangi bir düzeltme ihtiyacınız olursa bana bildirin!