Fireflies Node
Fireflies node'u, SkyStudio workflow'larında Fireflies.ai toplantı kayıt ve transkript platformuyla entegrasyon sağlar. Toplantı transkriptlerini okuyabilir, özetlere ve aksiyon maddelerine erişebilir, transkriptlerde arama yapabilir ve ses dosyaları yükleyebilirsiniz. Bağlantı için Fireflies API Key kullanılır.
Bağlantı Kurulumu ve Yönetimi
Fireflies node'unu kullanabilmek için Fireflies hesabınızdan bir API Key almanız ve SkyStudio'ya eklemeniz gerekir.
🎬 Videoyu izlemek için tıklayın →
Fireflies API Key Alma
- fireflies.ai adresine giriş yapın.
- Sol alt köşedeki profil menüsünden veya üst menüden Settings (Ayarlar) bölümüne gidin.
- Sol menüden Fireflies API seçeneğine tıklayın.
- Get API Key butonuna tıklayın.
- Oluşturulan API Key'i kopyalayın.
Not: API Key'i güvenli bir yerde saklayın. Fireflies API sayfasına her zaman geri dönerek key'inizi görüntüleyebilirsiniz.
SkyStudio'ya Bağlantı Ekleme
- SkyStudio'nun sol menüsünden Uygulama Bağlantıları bölümüne gidin.
- Yeni Bağlantı Ekle butonuna tıklayın.
- Sağlayıcı olarak Fireflies seçin.
- Aşağıdaki alanları doldurun:
| Alan | Açıklama |
|---|---|
| Bağlantı Adı | Tanımlayıcı bir isim (örn. Şirket Fireflies) |
| API Key | Fireflies dashboard → API sayfasından aldığınız key |
- Kaydet butonuna tıklayın.
Bağlantıyı Node'a Atama
Fireflies node'unu canvas'a ekledikten sonra sağ paneldeki Uygulama Bağlantıları açılır menüsünden kaydettiğiniz bağlantıyı seçin.
Operasyonlar
Fireflies node'u 9 operasyon sunmaktadır:
| Operasyon | Kategori | Açıklama |
|---|---|---|
| Transkriptleri Listele | Öne Çıkan | Hesaptaki toplantı transkriptlerini tarih filtresiyle listeler |
| Transkript Detayı | Öne Çıkan | Belirli bir transkriptin tam içeriğini getirir |
| Toplantı Özeti | Öne Çıkan | Bir toplantının AI tarafından oluşturulan özetini getirir |
| Action Item'ları Getir | Öne Çıkan | Bir toplantıdan çıkarılan aksiyon maddelerini listeler |
| Transkriptlerde Ara | Öne Çıkan | Tüm transkriptlerde anahtar kelimeyle arama yapar |
| Fireflies AI Asistan | Öne Çıkan | Doğal dil sorgusuyla Fireflies verilerini sorgular |
| Kullanıcı Bilgisi | Standart | Bağlı hesabın kullanıcı bilgilerini getirir |
| Katılımcıları Getir | Standart | Bir toplantının katılımcı listesini getirir |
| Ses Dosyası Yükle | Standart | Harici bir ses dosyasını Fireflies'a yükleyerek transkript oluşturur |
Transkriptleri Listele
Hesaptaki toplantı transkriptlerini tarih aralığı ve sayfalama seçenekleriyle listeler.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Fireflies bağlantısı |
| Limit | Hayır | Döndürülecek maksimum transkript sayısı |
| Skip | Hayır | Atlanacak kayıt sayısı (sayfalama için, örn. 10) |
| From Date | Hayır | Başlangıç tarihi (örn. 2024-06-01) |
| To Date | Hayır | Bitiş tarihi (örn. 2024-06-30) |
Örnek Çıktı
{
"transcripts": [
{
"id": "abc123",
"title": "Sprint Review Toplantısı",
"date": "2024-06-15T10:00:00Z",
"duration": 3600,
"participants": ["ahmet@sirket.com", "ayse@sirket.com"]
}
]
}
Transkript Detayı
Belirli bir toplantı transkriptinin tam içeriğini (konuşmacı bazlı diyalog metni) getirir.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Fireflies bağlantısı |
| Transcript ID | Evet | Detayı getirilecek transkriptin ID'si |
Transcript ID Nasıl Bulunur?
Transkriptleri Listele operasyonunun çıktısındaki id alanını kullanın. Fireflies web arayüzünde bir transkripti açtığınızda URL'de de görünür.
Toplantı Özeti
Fireflies'ın AI ile otomatik oluşturduğu toplantı özetini getirir. Uzun toplantıları hızlıca özetlemek için kullanılır.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Fireflies bağlantısı |
| Transcript ID | Evet | Özeti getirilecek transkriptin ID'si |
Örnek Çıktı
{
"summary": {
"overview": "Sprint 23 retrospektif toplantısında takım hızı ve teknik borç konuları ele alındı...",
"action_items": ["Teknik borç planı hazırlanacak", "Performans testleri çalıştırılacak"],
"keywords": ["sprint", "retrospektif", "teknik borç"]
}
}
Action Item'ları Getir
Bir toplantı transkriptinden Fireflies'ın otomatik olarak çıkardığı aksiyon maddelerini listeler.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Fireflies bağlantısı |
| Transcript ID | Evet | Aksiyon maddeleri getirilecek transkriptin ID'si |
Örnek Çıktı
{
"action_items": [
{
"text": "Ahmet, tasarım dokümantasyonunu hazırlayacak",
"assignee": "ahmet@sirket.com",
"due_date": null
}
]
}
Transkriptlerde Ara
Tüm transkriptlerde anahtar kelimeyle arama yapar. Belirli bir konuşmanın hangi toplantıda geçtiğini bulmak için kullanılır.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Fireflies bağlantısı |
| Search Query | Evet | Aranacak anahtar kelime veya ifade |
| Limit | Hayır | Döndürülecek maksimum sonuç sayısı |
Fireflies AI Asistan
Doğal dil sorgusuyla Fireflies verilerini sorgular. Videoda gösterildiği gibi "son toplantı başlığını getir" gibi serbest metin sorguları yazabilirsiniz.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Fireflies bağlantısı |
| Query | Evet | Doğal dilde Fireflies sorgusu |
| System Prompt | Hayır | AI asistanının davranışını özelleştiren sistem talimatı |
Kullanım Örneği
Query: "Son toplantımın başlığını getir"
System Prompt: "Yalnızca son 7 gündeki toplantıları dikkate al. Türkçe yanıt ver."
Kullanıcı Bilgisi
Bağlı Fireflies hesabının kullanıcı profil bilgilerini döndürür.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Fireflies bağlantısı |
Katılımcıları Getir
Belirli bir toplantının katılımcı listesini (isim ve e-posta) döndürür.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Fireflies bağlantısı |
| Transcript ID | Evet | Katılımcıları getirilecek transkriptin ID'si |
Ses Dosyası Yükle
Harici bir ses veya video dosyasının URL'sini Fireflies'a göndererek otomatik transkript oluşturulmasını başlatır.
Parametreler
| Parametre | Zorunlu | Açıklama |
|---|---|---|
| Connection | Evet | Kullanılacak Fireflies bağlantısı |
| Audio URL | Evet | Ses dosyasının erişilebilir public URL'si (mp3, mp4, m4a, wav vb.) |
| Meeting Title | Evet | Oluşturulacak transkriptin başlığı |
| Meeting Link (opsiyonel) | Hayır | İlgili toplantı bağlantısı (Zoom, Teams, Meet URL'si) |
Not: Ses dosyasının URL'si Fireflies sunucuları tarafından erişilebilir olmalıdır. Private veya kimlik doğrulama gerektiren URL'ler çalışmaz.
Hızlı Başlangıç Örnekleri
Örnek 1: Haftalık Toplantı Özet Raporu
Son haftanın toplantı özetlerini Slack'e gönderen workflow:
Schedule (Her Pazartesi) → Transkriptleri Listele → Toplantı Özeti → LLM (birleştir) → Kanala Mesaj Gönder (Slack)
Transkriptleri Listele ayarları:
- From Date:
{{gecen_hafta_baslangic}} - To Date:
{{gecen_hafta_bitis}} - Limit:
10
Örnek 2: Aksiyon Maddesi Takibi
Toplantıdan çıkan aksiyon maddelerini otomatik Jira issue'suna dönüştüren workflow:
Transkriptleri Listele → Action Item'ları Getir → Issue Oluştur (Jira)
Action Item'ları Getir ayarları:
- Transcript ID:
{{transcripts.results[0].id}}
Issue Oluştur ayarları:
- Summary:
[Toplantı] {{action_item.text}} - Assignee:
{{action_item.assignee}}
Örnek 3: Fireflies AI Chatbot
Kullanıcının toplantı içeriklerini doğal dilde sorgulamasını sağlayan chatbot:
Metin Girişi → Fireflies AI Asistan → Metin Çıktısı
Fireflies AI Asistan ayarları:
- Query:
{{input.text}} - System Prompt:
"Sen şirketin toplantı asistanısın. Fireflies transkriptlerini kullanarak Türkçe, kısa yanıtlar ver."
Örnek 4: Ses Kaydı Transkript Otomasyonu
Bir depolama alanına yüklenen ses dosyalarını otomatik transkribe eden workflow:
Webhook (dosya yüklendi) → Ses Dosyası Yükle → Slack Bildirimi
Ses Dosyası Yükle ayarları:
- Audio URL:
{{webhook.file_url}} - Meeting Title:
{{webhook.file_name}}
Sık Karşılaşılan Hatalar
| Hata | Olası Neden | Çözüm |
|---|---|---|
401 Unauthorized | API Key geçersiz | Fireflies dashboard → API sayfasından API Key'i kontrol edin |
404 Not Found | Geçersiz Transcript ID | "Transkriptleri Listele" operasyonuyla doğru ID'yi bulun |
| Boş transkript listesi | Belirtilen tarih aralığında kayıt yok | From Date / To Date aralığını genişletin |
| Ses yükleme başarısız | URL erişilemiyor | Ses dosyasının public erişime açık olduğunu kontrol edin |
| Özet boş geliyor | Toplantı henüz işlenmemiş | Fireflies'ın transkript oluşturması birkaç dakika sürebilir; workflow'u gecikmeyle çalıştırın |
Notlar
- Fireflies API, toplantı kayıtlarına erişmek için GraphQL API kullanır. Transcript ID'leri Transkriptleri Listele operasyonundan alınabilir.
- Toplantı özetleri ve aksiyon maddeleri Fireflies'ın yapay zekası tarafından otomatik oluşturulur; sonuçlar toplantı içeriğine göre değişir.
- Ses Dosyası Yükle operasyonuyla yüklenen dosyaların transkript haline gelmesi birkaç dakika sürebilir. Transkriptin hazır olduğunu kontrol etmek için iş akışına bir gecikme ekleyin.
- Fireflies ücretsiz planında API erişimi sınırlı olabilir. Yoğun kullanım için Pro veya Business planına geçmeniz gerekebilir.
- API Key'in yenilenmesi gerektiğinde SkyStudio'daki bağlantıyı da güncellemeyi unutmayın.