Webhook, Teachfluence'ta bir olay gerçekleştiğinde seçtiğiniz bir adrese otomatik veri gönderen bir istektir. Kursa kayıt, ödeme veya form gönderimi gibi olayları kendi CRM'inize, otomasyon aracınıza ya da özel bir servise bu yolla iletebilirsiniz.
Teachfluence'ta webhook'u otomasyon eylemi olarak kurarsınız: bir tetikleyici seçer, eylem listesinden Webhook Gönder'i eklersiniz ve isteğin gideceği uç noktayı tanımlarsınız. Bu sayfa bir webhook otomasyonunu baştan sona kurar, ardından iki örnek senaryoya (kursa kayıt ve ödeme) bakar.
Başlamadan önce
- Organizasyonda yönetici erişiminiz olmalı.
- POST isteklerini kabul eden bir uç nokta (endpoint) URL'si hazır olmalı. Bu kendi sunucunuz, bir CRM ya da no-code otomasyon aracı olabilir.
Adım adım: webhook otomasyonu oluşturma
Aşağıdaki adımlar Pazarlama → Otomasyonlar bölümünde ilerler. Örnek olarak "kursa kayıt" olayı kullanılıyor; ödeme örneği sayfanın sonunda.
1. Otomasyonlar sayfasını açın
Yönetici panelinde Pazarlama → Otomasyonlar bölümüne gidin ve sağ üstteki Sıfırdan Başla düğmesine tıklayın.
2. Bir tetikleyici seçin
Açılan Otomasyon Oluştur sihirbazında ilk adım tetikleyicidir. Tetikleyici Türü listesini açın ve webhook'u tetikleyecek olayı seçin. Tetikleyiciler gruplar halinde listelenir:
| Grup | Örnek olaylar |
|---|---|
| Öğrenci | Öğrenci Kaydoldu, Kursa Kaydoldu, Kursa Başladı |
| Sipariş | Ödeme Tamamlandı, Sipariş Oluşturuldu, Kurs Satın Alındı |
| Kurs İlerlemesi | Kursu Tamamladı, Sertifika Verildi |
| Koçluk | Koçluk Seansı Rezerve Edildi, Tamamlandı |
| Abonelik | Abonelik Oluşturuldu, Deneme Süresi Başladı |
| Diğer | Form Gönderildi, Etiket Eklendi |
3. Tetikleyiciyi yapılandırın
Seçtiğiniz olaya göre ek alanlar görünebilir. Örneğin Kursa Kaydoldu olayında hangi kurs için çalışacağını seçersiniz. Alanları doldurduktan sonra İleri düğmesi etkinleşir.
4. Koşulları atlayın (isteğe bağlı)
Koşullar adımı otomasyonu yalnızca belirli kullanıcılara uygulamak için kullanılır. Webhook için bu adım zorunlu değildir. Doğrudan İleri ile geçebilirsiniz.
5. Webhook eylemini ekleyin
Eylemler adımında Eylem Ekle'ye tıklayın, Eylem Türü listesini açın ve Entegrasyon grubundaki Webhook Gönder'i seçin.
6. Webhook'u yapılandırın
Webhook'un alanlarını doldurun:
| Alan | Açıklama |
|---|---|
| Webhook URL | İsteğin gönderileceği uç nokta. HTTPS kullanmanızı öneririz. |
| HTTP Metodu | İstek metodu. Varsayılan POST'tur. |
| HTTP Başlıkları | İsteğe eklenecek özel başlıklar (örn. Authorization). İsteğe bağlı. |
| Yükte Gönderilecek Bilgiler | Gövdeye eklenecek bilgi grupları. Hangi grupların sunulduğu tetikleyiciye göre değişir. |
| İstekleri imzala (HMAC) | Her isteği gizli bir anahtarla imzalar; alıcı isteğin Teachfluence'tan geldiğini doğrulayabilir. |
| Gecikme Türü | Eylemin hemen mi yoksa belirli bir gecikmeyle mi çalışacağı. Varsayılan Hemen'dir. |
Güvenlik
Webhook verinizi üçüncü bir tarafa gönderir. Gizli anahtarları URL'nin içine koymayın; bunun yerine bir HTTP başlığı (örn. Authorization) kullanın veya İstekleri imzala (HMAC) seçeneğini açın. Yalnızca güvendiğiniz uç noktalara webhook gönderin.
İmzalama anahtarını kaydedin
İmzalamayı açtığınızda üretilen anahtar yalnızca bir kez görünür. Pencereyi kapatmadan önce güvenli bir yere kaydedin. Anahtarı kaybederseniz Anahtarı yeniden oluştur ile yenisini üretebilirsiniz; bu durumda alıcı tarafta da yeni anahtarla güncelleme yapmanız gerekir.
İmzalama açıkken Teachfluence her istekte X-Teachfluence-Signature ve X-Teachfluence-Timestamp başlıklarını ekler:
X-Teachfluence-Signature: sha256=<imza>
X-Teachfluence-Timestamp: <unix saniye>
İmza, HMAC-SHA256 ile {zaman damgası}.{ham gövde} dizesi üzerinden hesaplanır ve sha256= öneki ile gönderilir. Alıcı tarafta aynı hesaplamayı yapıp karşılaştırarak isteğin Teachfluence'tan geldiğini doğrulayın.
7. Gözden geçirin ve kaydedin
Son adımda otomasyon akışını (tetikleyici → eylem) görür, otomasyona bir isim verir ve Durum'u seçersiniz. Aktif otomasyonlar olay gerçekleştiğinde hemen çalışır. Hazır olduğunuzda Otomasyon Oluştur'a tıklayın.
Önce test edin
Canlıya almadan önce durumu Pasif olarak kaydedin. Sonraki adımda webhook'u test edip uç noktanızın isteği doğru aldığını gördükten sonra otomasyonu Aktif'e çevirin.
8. Webhook'u test edin
Otomasyon oluşturulduktan sonra detay sayfasında akıştaki Webhook Gönder öğesine tıklayın. Açılan pencerede Test webhook'u gönder düğmesine basın. Teachfluence uç noktanıza örnek bir olay gönderir ve dönen HTTP durum kodunu gösterir. Başarılı bir istekte Durum 200 ve yanıt gövdesini görürsünüz.
Teachfluence isteği application/json gövdesiyle ve Teachfluence-Webhooks/1.0 kullanıcı aracısıyla (User-Agent) gönderir. Her isteğe, olayı tekilleştirebilmeniz için bir X-Teachfluence-Event-Id başlığı eklenir. Gövde şu zarf yapısındadır:
{
"event": "test.webhook",
"eventId": "6cf686f4-3b1f-4132-9905-dcea408d934f",
"occurredAt": "2026-06-17T15:47:40.507Z",
"organizationId": "org_...",
"automationId": "automation_...",
"data": {},
"test": true
}
Gerçek olaylarda data alanı aşağıdaki yük gruplarıyla dolar; test isteklerinde test değeri true olur.
İki örnek senaryo
Aynı adımlar tüm tetikleyiciler için geçerlidir. Tek fark seçtiğiniz olay ve o olayın sunduğu yük bilgileridir.
Örnek 1: Yeni kayıt (kursa kaydolma)
Yukarıdaki adımlarda kurulan örnek budur: tetikleyici olarak Kursa Kaydoldu seçilir. Bu olay bir öğrenci seçtiğiniz kursa kaydolduğunda webhook'u tetikler; örneğin yeni öğrenciyi CRM'inize eklemek için kullanabilirsiniz.
Bu tetikleyicide ek bir yük grubu sunulmaz; webhook yukarıdaki zarf yapısını gönderir. Öğrenciye özel ayrıntılara ihtiyacınız varsa kendi tarafınızda eventId ile eşleştirme yapın.
Örnek 2: Ödeme tamamlandı
Bir ödeme alındığında bilgi göndermek için 2. adımda Sipariş grubundaki Ödeme Tamamlandı olayını seçin.
Bu tetikleyicide webhook yapılandırmasına Yükte Gönderilecek Bilgiler bölümü eklenir. Gövdeye hangi bilgi gruplarının ekleneceğini buradan seçersiniz; yalnızca işaretlediğiniz gruplar gönderilir.
| Yük grubu | İçerik |
|---|---|
| Sipariş | Sipariş ID, ödenen toplam tutar, para birimi, durum ve oluşturulma tarihi |
| Müşteri | Müşteri e-postası, ad/soyad ve dil |
| Fatura adresi | Fatura adı, telefon numarası, adres ve ülke |
Yalnızca gerekeni gönderin
Yalnızca uç noktanızın ihtiyaç duyduğu grupları seçin. Örneğin muhasebe entegrasyonu için Sipariş ve Fatura adresi yeterliyken bir hoş geldin akışı için Müşteri grubu yeterli olabilir.
Sık karşılaşılan durumlar
- Test isteği başarısız oluyor (200 dışında bir kod): Uç noktanızın POST isteklerini kabul ettiğini ve URL'nin doğru olduğunu kontrol edin. Yanıt gövdesindeki hata mesajı yön gösterir.
- İstek gidiyor ama doğrulayamıyorsunuz: İstekleri imzala (HMAC) seçeneğini açın ve alıcı tarafta imzayı doğrulayın; ya da özel bir
Authorizationbaşlığı ekleyin. - Otomasyon çalışmıyor: Otomasyonun durumunun Aktif olduğundan emin olun. Pasif otomasyonlar olay gerçekleşse de çalışmaz.
İlgili
- Otomasyonlar
- Otomasyon e-postaları
- Abonelik paketleri
- Henüz bir Teachfluence organizasyonunuz yoksa: ücretsiz kaydolun
