Stüdyo, pazarlama takvimi ve PDF rapor şablonları

Bu rehberde: Beş hazır şablonun ne yaptığını, nasıl kurulduğunu ve hangi adımların ücret oluşturduğunu öğrenirsiniz. Ayrıca yeni kutuları tanırsınız: Pazarlama takvimi, Sesi yazıya dök, İçerik paketi üret ve Rapor oluştur'daki PDF seçeneği.

⏱ 15 dakika

Şablonları Şablonlar sayfasında bulursunuz. Şablonu kullan dediğinizde iş akışının bir kopyası Taslak olarak oluşur. Önce Deneme ile çalıştırın: deneme çalıştırması ücretli çağrı yapmaz, örnek içerik döndürür, onayları kendiliğinden geçer ve hiçbir şey yayımlamaz.

Geliştirici notu: Slug'lar tr-marketing-calendar-monthly-plan, episode-to-blog-and-posts, youtube-to-shorts-scripts, branded-monthly-client-report-pdf, brand-deal-ad-label-check. Tanımlar packages/shared/src/templates-studio.ts dosyasındadır; kutu kimlikleri (n1, n2…) sabittir. Takvim verisi packages/shared/src/tr-marketing-calendar.ts dosyasındadır.

Yeni kutular#

Pazarlama takvimi (data.marketingCalendar)#

Önümüzdeki günlerdeki Türkiye özel günlerini, bayramları ve indirim dönemlerini verir; her gün ayrı bir öğedir. Dinî günler Diyanet takvimine göre girilmiştir (kandil = o günün akşamı). Kutu internete bağlanmaz ve ücret oluşturmaz.

Her öğede şu alanlar vardır: date, endDate (çok günlü bayram ve sezonlarda), weekday, daysUntil, name, nameEn, type, promoAllowed, campaignHint, note, approximate, sectors.

• promoAllowed: false olan günlerde yalnızca sade bir kutlama veya anma mesajı paylaşın; indirim, ürün tanıtımı ya da satış çağrısı yapmayın.
• approximate: true olan günlerin kesin tarihi henüz doğrulanmamıştır (ör. okula dönüş, 2027 Regaib Kandili). date ile endDate arası beklenen aralıktır; note alanını okuyun ve planı onaylamadan önce resmî takvimden kontrol edin.
• Takvim 2026 sonbaharından 1 Ocak 2028'e kadar veri içerir. Daha ileri bir pencere isterseniz çalıştırma günlüğünde uyarı görürsünüz.

Kampanya Planlayıcı ajanı aynı takvimi Türkiye pazarlama takvimi aracıyla (get_marketing_calendar) kendisi de okuyabilir; ayrıca web araması yapmasına gerek kalmaz. Bkz. Kampanya Planlayıcı.

Sesi yazıya dök (ai.transcribe)#

Bir podcast veya video dosyasındaki konuşmayı zaman damgalı metne çevirir.

• Medya bağlantısı: Herkese açık, doğrudan indirilebilen bir dosya olmalı: mp3, m4a, wav, mp4, mov, webm veya mkv, en fazla 500 MB. Dosya yalnızca herkese açık internet adreslerinden indirilir.
• YouTube linki: Bağlı YouTube kanalınızdaki bir videonun altyazısı kullanılır; ses dökümü ücreti yoktur. YouTube bağlantısının altyazı izniyle verilmiş olması gerekir.
• Çıktı: text (düz metin), timedText ([0:12] metin satırları), segments (saniye cinsinden başlangıç / bitiş), language, durationSeconds, transcriptSource (audio, youtube_captions veya denemede sample) ve ücretli dökümlerde transcriptionJobId.
• Aylık hak: Ücretli her ses dökümü Stüdyo'da "Ses dökümü (iş akışı)" satırı olarak kaydedilir ve aylık içerik paketi hakkınızdan düşer; hata veren dökümler de sayılır. YouTube altyazısı ücretsizdir ve sayılmaz.
• İptal: Çalıştırmayı iptal ederseniz veya adım zaman aşımına uğrarsa indirme hemen durur ve döküm başlamaz.

İçerik paketi üret (content.repurpose)#

Stüdyo'daki içerik paketini iş akışı adımı olarak üretir: blog taslağı, platform başına gönderiler (LinkedIn, Instagram, TikTok), X dizisi, bülten, YouTube başlık / açıklama önerileri ve zaman damgalı Shorts / Reels klip fikirleri. Hangi parçaların üretileceğini Outputs alanından seçersiniz.

• Transkript en az 200 karakter olmalı. Varsayılan değer bir önceki Sesi yazıya dök adımının çıktısıdır ({{ $json.timedText || $json.text }}). Klip önerileri için zaman damgalı transkript gerekir.
• Transkript yoksa bağlı kanalınızdaki bir YouTube videosunun linkini YouTube link alanına yazabilirsiniz.
• Her çalıştırma Stüdyo'da bir içerik paketi olarak görünür (link alanı: /studio?job=…) ve planınızın aylık içerik paketi hakkından düşer. Aynı çalıştırmada önce Sesi yazıya dök çalıştıysa paket, dökümün satırına eklenir; bölüm başına hak bir kez düşer.

Rapor oluştur: PDF seçeneği (utility.report)#

Also create a branded PDF açıkken rapor, satış belgeleriyle aynı PDF motoruyla A4 olarak da hazırlanır: projenin marka adı, ana rengi ve web sitesi kullanılır. Planınızda beyaz etiket açıksa ajans markanız kullanılır ve "OrqLabs ile hazırlandı" yazısı gizlenir. PDF prepared for alanına yazdığınız ad, başlıkta "… için hazırlandı" olarak görünür.

Kutu sonraki adımlara pdfUrl, pdfFileName ve pdfExpiresAt alanlarını verir. E-posta gönder kutusunda gövdeye <a href="{{ $json.pdfUrl }}">Raporu açın</a> yazarak bağlantıyı gönderirsiniz.

• Gizli saklama: PDF, herkese açık dosya klasöründe değil, gizli bir klasörde tutulur. Doğrudan dosya adresi yoktur.
• İmzalı bağlantı: pdfUrl imzalı bir bağlantıdır ve PDF link valid for alanındaki gün sayısı kadar geçerlidir (varsayılan 30, en fazla 90). Süre dolunca bağlantı "süresi doldu" yanıtı verir. Bağlantıdaki herhangi bir karakter değişirse açılmaz.
• İptal: Raporu Raporlar sayfasından silerseniz PDF de silinir ve gönderilmiş bütün bağlantılar hemen çalışmaz hâle gelir.
• Ekip içi indirme: Organizasyon üyeleri PDF'i süre sınırı olmadan rapor sayfasından indirebilir.
• Saklama süresi: PDF dosyaları 180 gün sonra otomatik silinir; rapor metni kalır.
• Deneme: Deneme çalıştırmasında PDF oluşturulmaz ve bağlantı verilmez.

Uyarı: Bağlantıyı alan herkes, süre bitene kadar PDF'i açabilir. Gizli bilgi içeren raporları yalnızca ilgili kişiye gönderin ve süreyi kısa tutun.

Maliyet ve sınırlar#

Maliyet sınırına ulaşıldığında (COST_CAP_REACHED) akış hemen durur ve otomatik olarak yeniden denenmez; hata çıkışı bağlı olsa bile bu hata oraya gönderilmez. Bkz. Hata yönetimi, yeniden deneme ve bütçeler.

1. Türkiye pazarlama takvimiyle aylık plan#

Ne yapar: Her ayın 1'inde takvimden önümüzdeki 45 günün özel günlerini alır. Kampanya Planlayıcı bunlara göre kanal kanal bir aylık plan ve içerik takvimi hazırlar. Plan onayınıza gelir; onaylayınca ekibe bildirim gider ve plan Raporlar sayfasında kalır.

n1 Her ayın 1'i 09:00                Zamanlama (0 9 1 * *)
n2 Önümüzdeki 45 günün özel günleri  Pazarlama takvimi (45 gün)
n3 Aylık kampanya planı              Kampanya Planlayıcı (6 hafta)
n4 Aylık planı onayla                Onay
n5 Ekibe bildir                      Bildirim (uygulama içi + e-posta)

Kurulum:

1. Şablonu kullanın ve projeyi seçin.
2. İsterseniz n3'teki kanalları ve hedefi işinize göre değiştirin. Hedefte sektörünüzü belirtmek önerilerin isabetini artırır.
3. Yalnızca satış yapılabilecek günleri istiyorsanız n2'de Only days that allow promotion seçeneğini açın.
4. Deneme ile çalıştırın ve takvim çıktısını kontrol edin. Ardından iş akışını Etkin yapın.

Aynı kutuyu kullanan eski şablon Özel gün ve bayram kampanya planlayıcı da artık takvimi okuyor: her ayın 10'unda önümüzdeki 42 günü alır.

2. Podcast / YouTube bölümünden blog ve gönderi#

Ne yapar: Bölüm bağlantısını girersiniz. Konuşma yazıya dökülür ve içerik paketi hazırlanır: blog taslağı, LinkedIn ve Instagram gönderileri. Onayınızdan sonra blog WordPress'e taslak olarak eklenir. Instagram gönderisine görsel üretilir. Gönderiler kaydedilir ve Sosyal Yayıncı onları en iyi saatlere planlar.

n1 Bölüm bağlantısı     Manuel başlatma (url, title)
n2 Yazıya dök           Sesi yazıya dök
n3 İçerik paketi        İçerik paketi üret (blog, linkedin, instagram)
n4 Paketi onayla        Onay (düzenlenebilir)
n5 WordPress taslağı    WordPress · Create post (Draft)
n6 Gönderileri ayır     Kod: her gönderi ayrı öğe + Instagram için görsel tarifi
n7 Instagram görseli    Görsel üret (tarif boşsa atlanır)
n8 Gönderi kaydı        Gönderi planla (onaylı kayıt)
n9 Sosyal Yayıncı       En iyi saate planlar

Kurulum:

1. WordPress (uygulama parolası, en az Yazar rolü), LinkedIn ve Instagram hesaplarınızı bağlayın. YouTube linki kullanacaksanız YouTube kanalınızı altyazı izniyle bağlayın.
2. Şablonu kullanın; n5'te WordPress sitenizi seçin.
3. YouTube'da "yeni video" tetikleyicisi yoktur. Akışı Çalıştır ile başlatın ve url ile title alanlarını girin.
4. Onay ekranında blog başlığını ve gönderileri kontrol edin. Gerekirse metni düzenleyip onaylayın.

İpucu: X dizisi de istiyorsanız n3'ün çıktılarına x_thread ekleyin. Dizi xThread alanında gelir; yayımlamak için ayrı bir adım kurun.

3. YouTube videosundan Shorts / Reels / TikTok#

Ne yapar: Bağlı kanalınızdaki bir videonun altyazısından zaman damgalı kısa video önerileri hazırlar. Her öneride başlangıç–bitiş zamanı, açılış cümlesi, açıklama ve hashtag'ler bulunur. TikTok ve Instagram açıklamaları da yazılır. Onayınızdan sonra ekibe bildirim gider; bildirimdeki bağlantı Stüdyo'daki paketi açar.

n1 Video linki               Manuel başlatma (url)
n2 Altyazıyı al              Sesi yazıya dök (YouTube altyazısı)
n3 Kısa video önerileri      İçerik paketi üret (clips, tiktok, instagram)
n4 Senaryo listesi           Kod: önerileri okunur listeye çevirir
n5 Klip önerilerini onayla   Onay
n6 Klipleri kes              Bildirim (Stüdyo bağlantısı)

Neden klipleri akış kesmiyor? YouTube API'si video dosyasını vermez. Gerçek klip (mp4) üretimi bu yüzden Stüdyo'da yapılır: paketi açın, videoyu yükleyin ve önerilen klipleri dikey formatta kestirin. Klip kesimi planınızın aylık klip hakkından düşer.

4. Markalı aylık müşteri raporu (PDF)#

Ne yapar: Her ayın 1'inde geçen ayın GA4 verisini, son 28 günün Search Console sorgularını ve son 30 günün Instagram metriklerini toplar. Rapor Yazarı müşterinizin okuyacağı sade bir rapor yazar. Rapor marka renklerinizle PDF'e dönüştürülür. Onayınızdan sonra PDF bağlantısı kendi e-posta hesabınızdan müşterinize gönderilir.

n1  Her ayın 1'i 08:00                 Zamanlama (0 8 1 * *)
n2  GA4 geçen ay                       GA4 raporu (önceki ayın 1'i – son günü)
n3  Search Console 28 gün              Search Console (sorgu, 25 satır)
n4  Instagram 30 gün                   Sosyal metrikler
n5  GA4 + Search Console               Birleştir
n6  Tüm veriler                        Birleştir
n7  Rapor Yazarı                       Aylık rapor
n8  PDF rapor                          Rapor oluştur (PDF açık)
n9  Müşteriye göndermeden önce onayla  Onay
n10 Müşteriye gönder                   E-posta gönder ($vars.clientEmail)

Kurulum:

1. Google Analytics, Search Console, Instagram ve bir e-posta hesabı (Gmail, Outlook, SMTP veya Resend) bağlayın.
2. Şablonu müşterinin projesinde kullanın. Değişkenlere clientEmail (raporun gideceği adres) ve clientName (PDF'teki "… için hazırlandı" satırı) yazın.
3. Proje ayarlarında marka rengini ve web sitesini doldurun; PDF bunları kullanır.
4. Deneme ile çalıştırın. Denemede e-posta gönderilmez ve PDF oluşturulmaz; rapor metni yine kaydedilir.
5. Bağlantının geçerlilik süresini n8'deki PDF link valid for alanından değiştirebilirsiniz (1–90 gün).

Uyarı: Rapor bilgilendirme amaçlıdır. E-postaya kampanya, indirim veya satış teklifi eklemeyin; eklerseniz ileti ticari sayılır ve İYS onayı gerekir.

5. Marka iş birliği takibi ve "Reklam" etiketi kontrolü#

Ne yapar: Bir marka iş birliği gönderisinin metnini girersiniz. Uyum Denetçisi metni sponsorlu içerik olarak inceler: "Reklam" / "İş birliği" etiketi, kanıtlanamayan iddialar, indirim ve link açıklamaları. Sonuç (verdict) pass ise gönderi onayınıza gelir. warn veya block ise sorunlar, gereken etiketler ve önerilen düzeltilmiş metinle onaya düşer. Her iki durumda da onayladığınızda size bildirim gelir.

n1 İş birliği taslağı         Manuel başlatma (brandName, platform, body)
n2 Reklam etiketi kontrolü    Uyum Denetçisi (sosyal medya, sponsorlu)
n3 Sorun yok mu?              Eğer: {{ $json.verdict === 'pass' }}
n4 Gönderiyi onayla           Onay (evet yolu)
n5 Düzeltilmiş metni onayla   Onay (hayır yolu: sorunlar + revisedText)
n6 Yayına hazır               Bildirim
n7 Düzeltme onaylandı         Bildirim

Kurulum:

1. Şablonu kullanın. Sağlık, finans veya alkol içerikli iş birliklerinde n2'deki Sector alanını değiştirin.
2. Akışı Çalıştır ile başlatıp brandName, platform ve body alanlarını girin. Başka bir sistemden göndermek için tetikleyiciyi Webhook ile değiştirebilirsiniz; alan adları aynı kalmalıdır.
3. Anlaşmanın kendisini İş birlikleri sayfasında takip edin.

Uyum Denetçisi yol gösterir; hukuki görüş değildir. Ayrıntılar için bkz. Uyum Denetçisi.

Ortak uyum kuralları#

• Reklam etiketi: Marka iş birliği, sponsorlu içerik ve ortaklık (affiliate) linki içeren her paylaşımda "Reklam" ya da "Tanıtım" etiketi kullanın.
• Dinî ve millî günler: Ramazan, kandiller ve bayramlarda saygılı bir dil kullanın. Atatürk ve bayrak görsellerini ürün satışı için kullanmayın.
• İndirim duyuruları: Üstü çizili önceki fiyat, indirimden önce gerçekten uygulanan fiyat olmalıdır.
• Yapay zekâ içeriği: Taslaklar yapay zekâ ile yazılır. Yayımlamadan önce bilgileri doğrulayın; gerçek insan gibi görünen yapay zekâ görsellerini belirtin.