İçeriğe geç
Bu sayfada

Otomasyonlar

Otomasyonlarla webhook nasıl oluşturulur?

Webhook gönder eylemiyle her satışı ya da form yanıtını CRM'inize, muhasebe programınıza, Zapier veya Make'e ya da kendi sunucunuza gönderin; kurulum, test, başlatma ve yeniden gönderme.

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.

Adım adım: her satışı webhook ile gönderme

  1. Pazarlama → Otomasyonlar bölümüne gidin ve sağ üstteki Sıfırdan Başla'ya tıklayın.

  2. 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.

  3. Eylemler adımında Eylem ekle'ye tıklayın. Eylem Türü listesinden Entegrasyon grubundaki Webhook gönder'i seçin.

  4. 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ğin Authorization).

  5. 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.

  6. İ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.

  7. 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.

  8. 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:

    1. adımda Tetikleyici Türü listesinin Diğer grubundan Form Gönderildi'yi seçin ve Form Seçin alanında formunuzu seçin.
    1. adımda Yükte Gönderilecek Bilgiler listesi formun gruplarını gösterir. Alıcının ihtiyaç duyduğunu işaretleyin:
GrupNe gönderilir
YanıtYanı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
CevaplarFormdaki her soru ve metin olarak cevabı; cevaplanmamış soru boş gelir
PuanlarFormdaki 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.

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ıkDeğer
X-Teachfluence-Event-IdGö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:

GrupGövdedeki alanİçerik
SiparişorderKimlik, orderNumber, e-posta, toplam, para birimi, durum, oluşturulma ve ödeme tarihi, iade tarihi ve tutarı
MüştericustomerE-posta, ad, soyad, dil. Telefon içermez.
Müşteri telefonucustomerPhoneUluslararası biçimde telefon, yoksa boş
Fatura adresibillingAddressAd, telefon, adres, şehir, il, ülke, posta kodu
ÜrünleritemsÜrün türü ve kimliği, ad, adet, ödenen tutar, hediyeyse hediye edilen kişinin adı ve e-postası
İndirimlerdiscountsKampanya adı, kupon kodu, indirim türü ve değeri, düşülen tutar
Ödeme sayfası cevaplarıcheckoutFieldsEklediğiniz soruların etiketi, türü ve cevabı
Kaynakattributionİ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:

GrupGövdedeki alanİçerik
YanıtformSubmissionid, 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ıtlayanrespondentstudentId, email, emailVerified, givenName, lastName, phone, locale
CevaplarformAnswersHer soru için questionId, question, type ve metin olarak value; gizli sorular gönderilmez
PuanlarformScoresHer 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:

  1. X-Teachfluence-Timestamp değeri, bir nokta ve isteğin ham gövdesini birleştirin.
  2. Bu metnin HMAC-SHA256 değerini, imzalama anahtarını metin olarak kullanarak hesaplayın ve hex yazın.
  3. Başına sha256= ekleyip X-Teachfluence-Signature ile 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.

İlgili