Webhook, Teachfluence'ta bir olay gerçekleştiğinde seçtiğiniz bir adrese otomatik olarak veri gönderen bir bildirimdir. Böylece kursa kayıt, ödeme veya form gönderimi gibi olayları kendi CRM'inize, otomasyon aracınıza ya da özel bir servise gerçek zamanlı iletebilirsiniz.
Teachfluence'ta webhook ayrı bir menü değildir: bir otomasyon eylemidir. Bir tetikleyici (olay) seçer, eylem olarak Webhook Gönder'i eklersiniz ve isteğin gideceği uç noktayı tanımlarsınız. Bu rehberde bir webhook otomasyonunu baştan sona kuracak, ardından iki örnek senaryoya (kursa kayıt ve ödeme) bakacağız.
Başlamadan önce
Bu işlem için şunlara ihtiyacınız var:
- Organizasyonda yönetici erişimi.
- POST isteklerini kabul eden bir uç nokta (endpoint) URL'si. 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ını kullanıyoruz; ödeme örneği için sayfanın sonundaki bölüme bakın.
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 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.
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 kaydetmenizi öneririz. Bir 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ı, bir sonraki bölümde anlatılan 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 kurduğumuz örnek budur: tetikleyici olarak Kursa Kaydoldu'yu seçtik. 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 yapabilirsiniz.
Ö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ıyorum: İ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.
