Webhook, Teachfluence'ta bir olay olduğunda seçtiğiniz bir adrese veri gönderir. Örneğin her satışı ya da her form yanıtını muhasebe programınıza, CRM'inize, Zapier veya Make'e ya da kendi sunucunuza iletebilirsiniz. Bu sayfada veriyi alan bu sisteme kısaca alıcı denir.
Alıcıyı kuracak geliştiricinizin ihtiyaç duyduğu ayrıntılar sayfanın sonunda, Geliştiriciler için bölümündedir.
Hangi planlarda var?
Webhook gönder eylemi Scale planında kullanılabilir. Diğer planlarda Eylem Türü listesinde kilitli görünür. Planları karşılaştırın
Başlamadan önce
Otomasyonları yönetme yetkiniz ve veriyi alacak sistemin size verdiği, https:// ile başlayan bir adresiniz olmalı.
Adım adım: her satışı webhook ile gönderme
-
Pazarlama → Otomasyonlar bölümüne gidin ve sağ üstteki Sıfırdan Başla'ya tıklayın.
-
Tetikleyici adımında Tetikleyici Türü listesini açın, Sipariş grubundan Ödeme Tamamlandı'yı seçin ve İleri'ye tıklayın. Koşullar adımında koşul eklemeden yine İleri'ye tıklayın; otomasyon her başarılı ödemede çalışır. Form yanıtlarını göndermek için aşağıdaki Form yanıtlarını gönderme bölümüne, diğer tetikleyiciler için Otomasyonlar sayfasına bakın.
-
Eylemler adımında Eylem ekle'ye tıklayın. Eylem Türü listesinden Entegrasyon grubundaki Webhook gönder'i seçin.
-
Webhook URL alanına alıcının adresini yazın. Adres
https://ile başlamalıdır;http://adresler kaydedilmez. HTTP Metodu alanını POST olarak bırakın. Alıcı bir anahtar istiyorsa anahtarı adrese eklemeyin, HTTP Başlıkları alanına yazın (örneğinAuthorization). -
Yükte Gönderilecek Bilgiler listesinde alıcının ihtiyaç duyduğu grupları işaretleyin. Yalnızca işaretlediğiniz gruplar gönderilir. Muhasebe için Sipariş, Ürünler ve Fatura adresi genellikle yeter. Alıcı, isteğin Teachfluence'tan geldiğini imzayla doğrulayacaksa İstekleri imzala (HMAC) seçeneğini açın.
-
İleri'ye tıklayın. Gözden Geçir adımında otomasyona bir isim verin, Durum olarak Pasif'i seçin ve Otomasyon oluştur'a tıklayın. Pasif otomasyon siz başlatana kadar çalışmaz; böylece önce test edebilirsiniz.
İmzalamayı açtıysanız İmzalama anahtar(lar)ınızı kaydedin penceresi açılır. Anahtarın yanındaki kopyalama simgesine tıklayın, anahtarı alıcıyı kuran kişiye iletin ya da bir parola kasasına kaydedin, sonra Anahtarı kaydettim'e tıklayın.
Anahtar bir kez görünür
Anahtarı kaybederseniz webhook eylemini açıp Anahtarı yeniden oluştur'a, ardından Otomasyonu güncelle'ye tıklayın. Eski anahtar o anda çalışmayı durdurur; yeni anahtarı alıcıyı kuran kişiye iletin.
-
Otomasyonun detay sayfasında Otomasyon Akışı içindeki Webhook gönder'e tıklayın. Açılan pencerede Test webhook'u gönder'e basın. Teachfluence alıcıya örnek verilerle bir istek gönderir. Başarılı bir testte İletildi · Durum 200 ve alıcının yanıtını görürsünüz; imzalama açıksa İmzalandı da yazar.
-
Test başarılıysa pencereyi kapatın ve sağ üstteki Başlat'a tıklayın. Durum Aktif olur ve webhook bundan sonraki her ödemede gönderilir.
İadeleri de aynı adrese gönderme
Aynı otomasyon iadeyi de gönderebilir. Detay sayfasında Düzenle'ye tıklayın, Tetikleyici ekle ile Sipariş İade Edildi'yi seçin ve Otomasyonu güncelle'ye tıklayın. Bu tetikleyici yalnızca siparişin tamamı iade edildiğinde çalışır.
Form yanıtlarını gönderme
Bir form her gönderildiğinde cevapları alıcıya iletmek için yukarıdaki adımları şu farklarla izleyin:
-
- adımda Tetikleyici Türü listesinin Diğer grubundan Form Gönderildi'yi seçin ve Form Seçin alanında formunuzu seçin.
-
- adımda Yükte Gönderilecek Bilgiler listesi formun gruplarını gösterir. Alıcının ihtiyaç duyduğunu işaretleyin:
| Grup | Ne gönderilir |
|---|---|
| Yanıt | Yanıtın kimliği, form, durum, başlangıç ve bitiş zamanı, yanıtın yönetici panelindeki bağlantısı, form bir dersten doldurulduysa o ders, UTM parametreleri ve yönlendiren |
| Yanıtlayan | Öğrenci kimliği, e-posta, ad, soyad, telefon numarası ve dil |
| Cevaplar | Formdaki her soru ve metin olarak cevabı; cevaplanmamış soru boş gelir |
| Puanlar | Formdaki her hesaplama, sonucu, alınabilecek en yüksek puan ve yüzdesi |
Bir yanıtı tabloya satır olarak eklemek için Yanıtlayan ve Cevaplar çoğu zaman yeter. Test webhook'u gönder alıcıya örnek değerlerle hazırlanmış bir form yanıtı gönderir.
Formun kendi sayfasından
Aynı otomasyonu formun sayfasında Ayarlar sekmesinin Otomasyonlar bölümünden Otomasyon oluştur'a tıklayarak da kurabilirsiniz. Tetikleyici bu forma ayarlı gelir.
Başarısız gönderimler ve yeniden gönderme
Alıcı geçici bir hata verirse Teachfluence gönderimi yaklaşık 4 saat boyunca kendisi yeniden dener. Denemeler sonuç vermezse ya da alıcı isteği reddederse gönderim, otomasyonun detay sayfasındaki Çalıştırma Geçmişi tablosunda Başarısız etiketiyle görünür. Hatanın nedeni etiketin altında yazar.
Sorunu giderdikten sonra satırdaki Yeniden gönder'e tıklayın. Satır İşleniyor olur ve sonuç birkaç saniye içinde tabloda görünür.
Sık karşılaşılan durumlar
- Test sonucunda Webhook URL'sine ulaşılamadı yazıyor: Adresi kontrol edin. Yanında bir durum kodu varsa alıcı isteği almış ama reddetmiştir. Adresi düzelttikten sonra önce Otomasyonu güncelle'ye tıklayın, sonra testi yeniden gönderin; test kayıtlı ayarları kullanır.
- Durum 401 ya da 403 görünüyor: Alıcı bir anahtar istiyor. Alıcının verdiği başlığı HTTP Başlıkları alanına ekleyip Otomasyonu güncelle'ye tıklayın. Sonra testi yeniden gönderin ya da başarısız satırda Yeniden gönder'e tıklayın.
- Hata, alıcının başka bir adrese yönlendirdiğini söylüyor: Yönlendirmeler izlenmez. Webhook URL alanına yönlendirilen son adresi yazıp Otomasyonu güncelle'ye tıklayın.
- Satışta webhook gelmiyor: Detay sayfasında durumun Aktif olduğunu kontrol edin; Pasif otomasyon çalışmaz.
Geliştiriciler için
Teachfluence isteği application/json gövdesiyle POST eder ve şu başlıkları ekler:
| Başlık | Değer |
|---|---|
X-Teachfluence-Event-Id | Gönderimin kimliği, gövdedeki eventId ile aynı |
X-Teachfluence-Signature | İmzalama açıksa sha256= ile başlayan imza |
X-Teachfluence-Timestamp | İmzalama açıksa Unix zaman damgası (saniye) |
Gövde aşağıdaki yapıdadır. data içinde yalnızca işaretlenen gruplar bulunur; örnekte yalnızca Sipariş ve Müşteri işaretlidir ve alanlar kısaltılmıştır. Tutarlar metin olarak gelir.
{
"event": "PAYMENT_COMPLETED",
"eventId": "348e3849-3b6d-4b01-9d1b-8994d8e3862c",
"occurredAt": "2026-11-14T19:10:57.078Z",
"organizationId": "clx0000000000000000000000",
"automationId": "clx1111111111111111111111",
"data": {
"order": { "orderNumber": 1001, "total": "1499.9", "currency": "TRY", "status": "COMPLETED" },
"customer": { "email": "ogrenci@ornek.com", "givenName": "Ayşe", "lastName": "Yılmaz", "locale": "tr" }
}
}
Sipariş tetikleyicilerinde şu gruplar işaretlenebilir:
| Grup | Gövdedeki alan | İçerik |
|---|---|---|
| Sipariş | order | Kimlik, orderNumber, e-posta, toplam, para birimi, durum, oluşturulma ve ödeme tarihi, iade tarihi ve tutarı |
| Müşteri | customer | E-posta, ad, soyad, dil. Telefon içermez. |
| Müşteri telefonu | customerPhone | Uluslararası biçimde telefon, yoksa boş |
| Fatura adresi | billingAddress | Ad, telefon, adres, şehir, il, ülke, posta kodu |
| Ürünler | items | Ürün türü ve kimliği, ad, adet, ödenen tutar, hediyeyse hediye edilen kişinin adı ve e-postası |
| İndirimler | discounts | Kampanya adı, kupon kodu, indirim türü ve değeri, düşülen tutar |
| Ödeme sayfası cevapları | checkoutFields | Eklediğiniz soruların etiketi, türü ve cevabı |
| Kaynak | attribution | İlk ve son ziyaretin kanalı ve UTM'leri, reklam tıklama kimliği (örneğin fbclid, gclid), Google Analytics istemci kimliği, Meta ve TikTok reklam kimlikleri |
Kaynak grubu çerez iznine bağlıdır. UTM'ler ve Google Analytics kimliği için müşterinin performans çerezlerine, reklam tıklama kimlikleri ile Meta ve TikTok kimlikleri için pazarlama çerezlerine de izin vermesi gerekir. İzin yoksa alanlar boş gelir. Reklam kimlikleri 180 gün saklanır, sonra silinir.
Form Gönderildi tetikleyicisinde event değeri FORM_SUBMITTED olur ve şu gruplar işaretlenebilir:
| Grup | Gövdedeki alan | İçerik |
|---|---|---|
| Yanıt | formSubmission | id, formId, formTitle, status, startedAt, finishedAt, responseUrl, source (kurs, dönem ve ders adı; form bir dersten doldurulmadıysa null), utm (source, medium, campaign), referrer |
| Yanıtlayan | respondent | studentId, email, emailVerified, givenName, lastName, phone, locale |
| Cevaplar | formAnswers | Her soru için questionId, question, type ve metin olarak value; gizli sorular gönderilmez |
| Puanlar | formScores | Her hesaplama için calculationId, name, value, maxPossibleScore, percentage |
emailVerified yalnızca yanıt bir öğrenci hesabına bağlıysa ve e-posta o öğrencinin adresiyse true olur.
Diğer tetikleyicilerde, tetikleyiciye göre Öğrenci (student: kimlik, e-posta, ad, soyad, dil) ve Tetikleyici bilgileri (event: tetikleyicinin konusu, örneğin kurs, etiket veya seans) grupları sunulur. Grup sunmayan bir tetikleyicide liste yerine "Bu tetikleyici için kullanılabilir bilgi grubu yok." yazar.
İmza doğrulama:
X-Teachfluence-Timestampdeğeri, bir nokta ve isteğin ham gövdesini birleştirin.- Bu metnin HMAC-SHA256 değerini, imzalama anahtarını metin olarak kullanarak hesaplayın ve hex yazın.
- Başına
sha256=ekleyipX-Teachfluence-Signatureile karşılaştırın. Gövdeyi ayrıştırıp yeniden yazmayın, imza tutmaz.
eventId otomatik denemelerde ve elle yeniden göndermede aynı kalır; tekrarı bu değerle eleyin. Yeniden gönderilen isteğin gövdesi gönderim anında yeniden oluşturulur.
Otomatik denemeler: Zaman aşımı, bağlantı hatası, 5xx ve 429 yanıtlarında en fazla 8 deneme yapılır. Diğer 4xx yanıtlarında, yönlendirmede ve özel ya da yerel ağ adreslerinde deneme yapılmaz, gönderim hemen başarısız olur.
Test isteklerinde gövdeye "test": true eklenir ve event değeri test.webhook olur. data içinde örnek değerler bulunur.
Satış ve iade: event satışta PAYMENT_COMPLETED, iadede ORDER_REFUNDED olur. İkisi de aynı orderNumber'ı taşır.
