WayinVideo ve GPT-4o-mini ile Video Hata Destek Taleplerini Google E-Tablolar'a Otomatik Triage Etme

Genel Bakış

Bu n8n iş akışı, video tabanlı hata destek taleplerini yönetme sürecini devrim niteliğinde basitleştirir. Manuel incelemelerin ve raporlamanın getirdiği zaman kaybını ortadan kaldırarak, WayinVideo'nun yapay zeka destekli video analizi ve GPT-4o-mini'nin doğal dil işleme yeteneklerini bir araya getirir. Amaç, destek ekiplerinin daha hızlı ve daha doğru bir şekilde yanıt vermesini sağlamak, böylece müşteri memnuniyetini artırmak ve operasyonel verimliliği yükseltmektir. Bu otomasyon, özellikle görsel kanıtlara dayalı hata raporlarının sıkça geldiği durumlarda paha biçilmez bir araçtır.

Gereksinimler

Bu iş akışını başarıyla kurmak ve çalıştırmak için aşağıdaki hesaplara ve API anahtarlarına ihtiyacınız olacaktır:

• n8n Hesabı: İş akışını barındırmak ve çalıştırmak için bir n8n Cloud hesabı veya kendi kendine barındırılan bir n8n kurulumu.
• WayinVideo API Anahtarı: WayinVideo platformundan alınacak bir API anahtarı. Videoları analiz etmek için gereklidir. (WayinVideo web sitesinden kayıt olabilirsiniz).
• OpenAI API Anahtarı: GPT-4o-mini modelini kullanmak için bir OpenAI API anahtarı. (OpenAI platformundan edinilebilir).
• Google Hesabı: Google E-Tablolar'a erişim ve veri yazma izni için bir Google hesabı.
• Google E-Tablosu: Destek taleplerinin kaydedileceği, belirli sütun başlıklarına sahip (örn. 'Müşteri Adı', 'Hata Türü', 'Video URL', 'Hata Anı', 'Öncelik', 'Yeniden Oluşturma Adımları', 'Düzeltme Önerisi', 'Tarih') önceden hazırlanmış bir Google E-Tablosu.

Kurulum Adımları

Bu iş akışını n8n ortamınıza kurmak için aşağıdaki adımları izleyin:

1. n8n İş Akışını İçe Aktarın: n8n arayüzünüzde yeni bir iş akışı oluşturun ve bu iş akışının JSON kodunu içe aktarın. İş akışı şablonunu n8n topluluğundan veya bu rehberin sağladığı JSON'dan alabilirsiniz.

2. Form Trigger Düğümünü Yapılandırın:

   • Form Trigger düğümüne tıklayın.
   • Form alanlarını, müşteri adı, hata türü ve ekran kaydı URL'si gibi bilgileri toplayacak şekilde düzenleyin. Örneğin, 'customerName' (Metin), 'bugType' (Metin) ve 'screenRecordingUrl' (URL) alanları ekleyin.
   • Formu kaydedin ve formun herkese açık URL'sini not alın. Bu URL, destek taleplerini göndermek için kullanılacaktır.

3. HTTP Request (WayinVideo) Düğümünü Yapılandırın:

   • HTTP Request düğümüne tıklayın. Bu düğüm, WayinVideo API'sine video URL'sini gönderecektir.
   • Metot: POST olarak ayarlayın.
   • URL: https://api.wayin.ai/v1/analyze olarak ayarlayın.
   • Başlıklar (Headers): Authorization başlığını ekleyin ve değer olarak Bearer SİZİN_WAYINVIDEO_API_ANAHTARINIZ (SİZİN_WAYINVIDEO_API_ANAHTARINIZ yerine kendi WayinVideo API anahtarınızı girin) şeklinde ayarlayın.
   • Gövde (Body): JSON seçeneğini seçin ve aşağıdaki JSON yapısını kullanın:

     {
       "video_url": "{{ $json.screenRecordingUrl }}"
     }
     

     Bu, Form Trigger düğümünden gelen screenRecordingUrl değerini WayinVideo'ya gönderir.

4. Wait Düğümünü Yapılandırın:

   • Wait düğümüne tıklayın. WayinVideo analizinin tamamlanması için bir bekleme süresi sağlar.
   • Süre: WayinVideo'nun video uzunluğuna bağlı olarak analiz süresini tahmin ederek, örneğin 60 saniye veya 120 saniye gibi bir değer ayarlayın.

5. If Düğümünü Yapılandırın:

   • If düğümüne tıklayın. Bu düğüm, WayinVideo analizinin başarılı olup olmadığını kontrol eder.
   • Koşul: WayinVideo'dan gelen yanıtın başarılı olduğunu gösteren bir koşul ekleyin. Örneğin, {{ $json.status === 'completed' }} veya {{ $json.error === undefined }} gibi bir ifade kullanabilirsiniz (WayinVideo API yanıtına göre ayarlayın).

6. HTTP Request (WayinVideo Sonuçları) Düğümünü Yapılandırın (If - True dalı):

   • If düğümünün 'True' dalındaki HTTP Request düğümüne tıklayın. Bu düğüm, WayinVideo analiz sonuçlarını çeker.
   • Metot: GET olarak ayarlayın.
   • URL: https://api.wayin.ai/v1/analysis/{{ $json.analysis_id }} olarak ayarlayın. (analysis_id değeri, ilk WayinVideo HTTP Request düğümünden gelmelidir).
   • Başlıklar (Headers): Authorization başlığını ekleyin ve değer olarak Bearer SİZİN_WAYINVIDEO_API_ANAHTARINIZ şeklinde ayarlayın.

7. LM Chat OpenAI Düğümünü Yapılandırın:

   • LM Chat OpenAI düğümüne tıklayın.
   • Kimlik Bilgileri: Daha önce oluşturduğunuz OpenAI API anahtarını kullanarak bir kimlik bilgisi oluşturun veya mevcut bir kimlik bilgisini seçin.
   • Model: gpt-4o-mini olarak ayarlayın.
   • Sistem Mesajı (System Message): Destek talebi oluşturmak için GPT'ye talimat veren bir sistem mesajı girin. Örneğin:

     Sen bir yazılım destek uzmanısın. Kullanıcının sağladığı video analizi sonuçlarını ve hata bilgilerini kullanarak, aşağıdaki formatta detaylı bir destek talebi oluştur. Öncelik, yeniden oluşturma adımları ve olası bir düzeltme önerisi içermelidir.
     
     Format:
     Öncelik: [Yüksek/Orta/Düşük]
     Yeniden Oluşturma Adımları:
     1. [Adım 1]
     2. [Adım 2]
     3. [Adım 3]
     Hata Anı: [Video zaman damgası (örn. 00:15)]
     Düzeltme Önerisi: [Olası düzeltme veya geçici çözüm]
     

   • Kullanıcı Mesajı (User Message): WayinVideo analiz sonuçlarını ve formdan gelen bilgileri birleştirerek GPT'ye gönderilecek mesajı oluşturun. Örneğin:

     Müşteri Adı: {{ $json.customerName }}
     Hata Türü: {{ $json.bugType }}
     Video URL: {{ $json.screenRecordingUrl }}
     WayinVideo Analiz Sonuçları: {{ JSON.stringify($json.wayinVideoResults) }}
     

     (wayinVideoResults yerine WayinVideo'dan gelen gerçek analiz sonucunu içeren değişkeni kullanın).

8. Google Sheets Düğümünü Yapılandırın:

   • Google Sheets düğümüne tıklayın.
   • Kimlik Bilgileri: Google hesabınızı kullanarak bir kimlik bilgisi oluşturun veya mevcut bir kimlik bilgisini seçin.
   • İşlem: Append Row (Satır Ekle) olarak ayarlayın.
   • E-Tablo Kimliği: Destek taleplerini kaydedeceğiniz Google E-Tablosunun kimliğini girin (URL'den bulunabilir).
   • Sayfa Adı: Verilerin ekleneceği sayfanın adını girin (örn. Sheet1).
   • Değerler: Google E-Tablonuzdaki sütun başlıklarıyla eşleşecek şekilde değerleri eşleştirin. Örneğin:
     • Müşteri Adı: {{ $json.customerName }}
     • Hata Türü: {{ $json.bugType }}
     • Video URL: {{ $json.screenRecordingUrl }}
     • Hata Anı: {{ $json.wayinVideoResults.bugTimestamp }} (WayinVideo'dan gelen zaman damgası)
     • Öncelik: {{ $json.gptResponse.priority }} (GPT yanıtından ayrıştırın)
     • Yeniden Oluşturma Adımları: {{ $json.gptResponse.reproductionSteps }}
     • Düzeltme Önerisi: {{ $json.gptResponse.fixSuggestion }}
     • Tarih: {{ new Date().toISOString().split('T')[0] }}

9. İş Akışını Etkinleştirin: Tüm düğümleri doğru şekilde yapılandırdıktan sonra, iş akışını etkinleştirin (toggle switch'i açın).

Gerçek Dünya Kullanım Senaryoları

• Yazılım Geliştirme Şirketleri: QA ekipleri, bulunan hataların video kayıtlarını otomatik olarak analiz edip, detaylı hata raporlarını anında oluşturarak geliştiricilere iletebilir. Bu, hata ayıklama sürecini hızlandırır.
• Ürün Destek Ekipleri: Müşterilerden gelen 'nasıl yapılır' veya 'hata' videolarını otomatik olarak işleyerek, sorunun kök nedenini belirleyebilir ve standartlaştırılmış yanıtlar veya çözümler üretebilir.
• Eğitim ve Öğrenim Platformları: Öğrencilerin veya kullanıcıların karşılaştığı teknik sorunları gösteren video kayıtlarını analiz ederek, kişiselleştirilmiş destek veya çözüm önerileri sunabilir.
• Oyun Geliştiricileri: Oyuncuların karşılaştığı oyun içi hataları gösteren video klipleri otomatik olarak inceleyip, hatanın tam olarak ne zaman ve nasıl meydana geldiğini tespit ederek geliştirme ekibine raporlayabilir.
• Donanım Destek Servisleri: Kullanıcıların donanım arızalarını gösteren videolarını analiz ederek, sorunun kaynağını belirleyebilir ve teknik destek personelinin daha hızlı müdahale etmesini sağlayabilir.

İpuçları ve En İyi Uygulamalar

• WayinVideo API Yanıtını Doğrulayın: WayinVideo'dan gelen yanıtın yapısını dikkatlice inceleyin ve If düğümündeki koşulları ve sonraki düğümlerdeki veri eşleştirmelerini buna göre ayarlayın. API dokümantasyonunu kontrol etmek faydalı olacaktır.
• GPT Prompt Optimizasyonu: GPT-4o-mini'ye verdiğiniz sistem ve kullanıcı mesajlarını (prompt) mümkün olduğunca net ve spesifik tutun. İstediğiniz çıktı formatını açıkça belirtmek, daha tutarlı ve kullanışlı destek talepleri almanızı sağlar.
• Hata Yönetimi: İş akışına hata yakalama ve bildirim mekanizmaları ekleyin. Örneğin, WayinVideo veya OpenAI API'lerinden bir hata gelirse, bir e-posta veya Slack bildirimi gönderilebilir.
• Veri Güvenliği: Hassas müşteri bilgilerini işlerken, n8n'in güvenli kimlik bilgisi yönetimini kullandığınızdan ve veri gizliliği düzenlemelerine (GDPR, KVKK vb.) uyduğunuzdan emin olun.
• Google E-Tablosu Yapısı: Google E-Tablonuzdaki sütun başlıklarının, GPT'den beklediğiniz çıktı alanlarıyla ve n8n'deki eşleştirmelerle tam olarak uyumlu olduğundan emin olun. Tutarsızlıklar veri yazma hatalarına yol açabilir.
• Performans İzleme: İş akışının performansını düzenli olarak izleyin. Özellikle Wait düğümünün süresini, WayinVideo'nun tipik analiz sürelerine göre optimize edin.
• Test ve Yineleme: İş akışını farklı senaryolarla kapsamlı bir şekilde test edin. Gerekirse, GPT prompt'unu veya veri eşleştirmelerini iyileştirmek için yinelemeler yapın.

Sık Sorulan Sorular

• S: WayinVideo API anahtarımı nereden alabilirim? C: WayinVideo web sitesine kaydolduktan sonra, genellikle 'API Anahtarları' veya 'Geliştirici Ayarları' bölümünden API anahtarınızı oluşturabilir ve yönetebilirsiniz.

• S: GPT-4o-mini yerine başka bir dil modelini kullanabilir miyim? C: Evet, n8n'in Langchain entegrasyonu sayesinde farklı OpenAI modellerini veya diğer LLM sağlayıcılarını (örneğin, Anthropic Claude, Google Gemini) kullanabilirsiniz. Ancak, prompt'ları ve beklenen çıktı formatını yeni modele göre ayarlamanız gerekebilir.

• S: Google E-Tablosu'nda hangi sütun başlıklarını kullanmalıyım? C: Önerilen sütun başlıkları şunlardır: 'Müşteri Adı', 'Hata Türü', 'Video URL', 'Hata Anı', 'Öncelik', 'Yeniden Oluşturma Adımları', 'Düzeltme Önerisi', 'Tarih'. Ancak, ihtiyaçlarınıza göre bu başlıkları özelleştirebilirsiniz, yeter ki n8n'deki eşleştirmelerle uyumlu olsun.

• S: İş akışı bir hata verirse ne yapmalıyım? C: n8n'in yürütme geçmişini kontrol edin. Hatanın hangi düğümde meydana geldiğini belirleyin ve ilgili düğümün yapılandırmasını, API yanıtlarını veya kimlik bilgilerini kontrol edin. Genellikle API anahtarı yanlışlıkları, yanlış URL'ler veya hatalı veri eşleştirmeleri yaygın sorunlardır.

Bu rehber Otomasyonevi.com tarafından hazırlanmıştır.