Birebir (koçluk) görüşmelerinizi Google Meet'te yaptığınızda, tamamlanan kaydı öğrencinize görüşme sayfasında gösterebilirsiniz. Bu rehber, kaydı otomatik eklemeyi anlatır: kurduğunuz tek bir otomasyon (n8n, Zapier, Make), bir Meet kaydı hazır olduğunda onu doğru görüşmeye kendisi ekler ve öğrenciye kaydın hazır olduğunu bildirir. Otomasyonu görüşme başına ayrı ayrı kurmanız gerekmez; kuruluş genelinde tek bir kural yeterlidir.
Nasıl çalışır
Otomasyonunuz, kendi Google hesabınızdan (Takvim/Meet) tamamlanan kaydı ve onun Google Takvim etkinlik kimliğini okur, kaydı Teachfluence'a gönderir. Teachfluence bu kimlikten doğru koçluk görüşmesini bulur, kaydı ekler ve öğrenciye e-posta gönderir. Teachfluence arayüzünden görüşme başına kimlik kopyalamanız gerekmez.
Başlamadan önce
- Kuruluşta sahip veya yönetici yetkiniz olmalı (token yalnızca sahip/yönetici tarafından oluşturulur).
- Otomasyon aracınız (n8n, Zapier, Make) kendi Google hesabınıza bağlı olmalı; tamamlanan kaydı ve onun Takvim/Meet bilgisini bu hesaptan okur.
- Tarayıcıda oynatılabilen bir kayıt bağlantısı (aşağıya bakın).
En kritik nokta: oynatılabilir bağlantı
Teachfluence gönderdiğiniz bağlantıyı öğrencinin tarayıcısında oynatır; videoyu indirmez, dönüştürmez veya yeniden barındırmaz. Google Meet kayıtları genelde Google Drive'a düşer ve bir Drive /view bağlantısı oynatılmaz, izleyene "Erişim iste" ekranı gösterir. Otomasyonunuz kaydı önce listelenmemiş bir YouTube videosuna, Vimeo'ya ya da doğrudan bir .mp4 dosyasına dönüştürmelidir.
1. API token'ı oluşturun
Ayarlar > Entegrasyonlar > Geliştirici bölümüne gidin ve API Token'ları kartındaki Token oluştur düğmesine tıklayın.
Açılan pencerede token'a tanıyabileceğiniz bir ad verin (örn. "Meet kayıt otomasyonu"). İsterseniz bir son kullanma tarihi belirleyin; sürekli çalışan bir otomasyon için boş bırakın. Kapsam otomatik olarak Kayıt aktarımı olur.
Token oluştur'a tıkladığınızda token yalnızca bir kez gösterilir. Kopyalayıp otomasyon aracınızın güvenli alanına (kimlik bilgisi / secret) kaydedin.
Token'ı bir daha göremezsiniz
Pencereyi kapattıktan sonra token değeri tekrar gösterilmez. Kaybederseniz eskisini iptal edip yenisini oluşturun. Bir token, onu oluşturan üye gibi davranır: o üye düzenleme yetkisini kaybeder ya da kuruluştan ayrılırsa istekler 403 döner ve token'ı aktif bir yönetici altında yeniden oluşturmanız gerekir.
2. Org geneli uç noktayı ve kod parçasını kopyalayın
Aynı sayfada, Uç noktalar > Organizasyon geneli kayıt aktarımı (koçluk) kartında uç nokta adresini ve hazır kod parçalarını bulacaksınız. curl ya da n8n HTTP Request düğümü kod parçasından işinize uygun olanı kopyalayın.
Uç nokta adresi:
https://api.teachfluence.com/api/recording-ingest
3. Kaydı oynatılabilir bir bağlantıya dönüştürün
Otomasyonunuz kaydı göndermeden önce onu oynatılabilir bir bağlantıya çevirmelidir. Hangi bağlantıların oynatıldığı:
| Bağlantı türü | Öğrencilere oynatılır mı? |
|---|---|
Doğrudan video dosyası (.mp4) veya HLS (.m3u8), herkese açık | Evet (önerilen) |
| Listelenmemiş veya herkese açık YouTube bağlantısı | Evet |
| Vimeo bağlantısı (herkese açık / listelenmemiş) | Genellikle evet |
Google Drive /view veya "paylaş" bağlantısı | Hayır (görüntüleyici sayfası açar, "Erişim iste" ister) |
| Dropbox / OneDrive önizleme bağlantısı ya da girişe kapalı herhangi bir sayfa | Hayır |
4. Otomasyonu kurun
Otomasyonunuzda üç adım vardır: kaydın hazır olduğunu algılayan bir tetikleyici, kaydı oynatılabilir bağlantıya çeviren bir adım ve uç noktaya POST isteği gönderen bir adım. Kopyaladığınız kod parçasında <YOUR_TOKEN> yerine token'ı, <GOOGLE_CALENDAR_EVENT_ID> yerine ise otomasyonunuzun Google Takvim'den okuduğu etkinlik kimliğini yazın:
curl -X POST 'https://api.teachfluence.com/api/recording-ingest' \
-H 'Authorization: Bearer <YOUR_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{"externalUrl":"https://your-storage.example.com/recording.mp4","googleEventId":"<GOOGLE_CALENDAR_EVENT_ID>"}'
n8n için HTTP Request düğümü alanları:
Method: POST
URL: https://api.teachfluence.com/api/recording-ingest
Authentication: Generic Credential Type -> Header Auth
Header Name: Authorization
Header Value: Bearer <YOUR_TOKEN>
Send Body: On (JSON)
Body:
{
"externalUrl": "https://your-storage.example.com/recording.mp4",
"googleEventId": "<GOOGLE_CALENDAR_EVENT_ID>"
}
Görüşmeyi eşleştirmenin iki yolu vardır (birini gönderin):
| Alan | Ne zaman kullanılır |
|---|---|
googleEventId | Önerilen. Google Takvim etkinlik kimliği. Kesin eşleşme sağlar. |
meetLink + recordedAt | Etkinlik kimliği yerine Meet bağlantısı (https://meet.google.com/abc-defg-hij) gönderirseniz, kaydın başlangıç zamanını da ISO-8601 (saat dilimli, örn. 2026-07-24T10:02:00Z) olarak ekleyin. Aynı bağlantı tekrar kullanıldığında Teachfluence doğru görüşmeyi zamana göre ayırır. |
Kaydı bağlantı yerine kütüphanenizdeki bir videodan eklemek isterseniz externalUrl yerine videoId gönderin (ikisinden yalnızca birini gönderin).
5. Teachfluence ne yapar
Bir istek geldiğinde Teachfluence, kimliği kendi kuruluşunuz içinde arar, doğru koçluk görüşmesini bulur, kaydı ekler ve (görüşmeye ilk kez kayıt ekleniyorsa) öğrenciye kaydın hazır olduğunu bildiren bir e-posta gönderir.
Eşleşti ama eklenmedi (skipped)
Bir istek doğru görüşmeye ulaşıp da eklenmeyebilir; örneğin o görüşmede otomatik yayınlama kapalıysa, aynı kayıt zaten ekliyse ya da görüşme iptal edildiyse. Bu durumda yanıt { "ok": true, "skipped": "..." } olur. Bu normaldir; isteği tekrar göndermeyin.
Yanıt kodları
Uç nokta, "isteğiniz hatalı, tekrar denemeyin" ile "geçici bir aksaklık, tekrar deneyin" durumlarını ayırır. Otomasyonunuzu buna göre kurun:
| Kod | Anlamı | Otomasyon ne yapmalı |
|---|---|---|
| 200 | Kayıt eklendi | Tamam |
200 (skipped) | Görüşme bulundu ama eklenmedi (otomatik yayınlama kapalı, kayıt zaten ekli veya görüşme iptal) | Tamam, tekrar denemeyin |
| 403 | Token geçersiz, süresi dolmuş veya iptal edilmiş; ya da token'ı oluşturan üye yetkiyi kaybetmiş | Token'ı düzeltin veya yeniden oluşturun |
| 404 | Bu kimliğe/bağlantıya uyan görüşme bulunamadı (yanlış kimlik ya da başka kuruluş) | Kimliği veya zamanı kontrol edin |
| 409 / 422 | Belirsiz eşleşme ya da geçersiz girdi (Meet bağlantısında zaman eksik, hem videoId hem externalUrl gönderildi, bozuk gövde) | İsteği düzeltin |
| 429 | Çok fazla istek (hız sınırı) | Bekleyip tekrar deneyin |
| 500 | Geçici sunucu hatası | Güvenle tekrar denenebilir |
Başarılı yanıt:
{ "ok": true }
Alternatif: kaydı elle ekleme
Tek bir kayıt için otomasyona gerek yoktur. Ürünler > 1:1 Görüşmeler altından görüşmeyi açın, Seanslar sekmesinde tamamlanan rezervasyonun detayına gidin ve Kayıt kartındaki Kayıt ekle düğmesiyle ya bir bağlantı yapıştırın ya da kütüphaneden bir video seçin. Kayıt kartı yalnızca tamamlanmış görüşmelerde görünür. Yayında olan bir görüşmeye eklenen ilk kayıt, öğrenciye e-posta gönderir.
Canlı etkinlikler
Canlı etkinlik (webinar, atölye) kayıtları ayrı bir uç noktayla (https://api.teachfluence.com/api/live-event-recording) veya etkinlik sayfasındaki Kayıt kartından, etkinlik başına eklenir. Org geneli koçluk akışı yalnızca koçluk görüşmeleri içindir.
Güvenlik ve bakım
- Token'ı parola gibi saklayın.
lerec_ile başlar ve kuruluşunuzda kayıt ekleme yetkisi verir; otomasyonun secret alanında tutun, düz metin akışlarına yazmayın. - Ekip değişiminde yenileyin. Token, onu oluşturan üye gibi davrandığından o kişinin rolü değişince veya kuruluştan ayrılınca token'ı iptal edip yeniden oluşturun.
- Süre belirleyin. Süreli otomasyonlar için son kullanma tarihi ekleyin; sürekli çalışanlarda boş bırakın.
- İptal edin. Token listesindeki İptal et ile bir token'ı anında geçersiz kılarsınız. İptal edilmiş ve süresi dolmuş token'lar 403 döner.
Sorun giderme
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Öğrenciler "Erişim iste" veya boş oynatıcı görüyor | Google Drive /view bağlantısı gönderildi | Listelenmemiş YouTube/Vimeo ya da doğrudan .mp4 bağlantısı gönderin |
| 404 (görüşme bulunamadı) | Yanlış googleEventId, ya da meetLink için zaman eksik/yanlış | Kimliği kontrol edin; meetLink gönderiyorsanız recordedAt ekleyin |
| Her istek 403 dönüyor | Token iptal edilmiş, süresi dolmuş ya da oluşturan üye yetkiyi kaybetmiş | Aktif bir yönetici altında yeniden oluşturun |
Yanıt skipped dönüyor ama kayıt görünmüyor | Görüşmede otomatik yayınlama kapalı ya da görüşme iptal | Görüşme ayarlarını kontrol edin; gerekirse kaydı elle ekleyin |
| E-posta gitmedi | Görüşmeye daha önce bir kayıt eklenmişti veya görüşme yayında değil | Yalnızca ilk kayıt bildirir |
