Ghost

Bu rehberde: Ghost sitenizde bir özel entegrasyon (custom integration) oluşturup Admin API anahtarını OrqLabs'a girersiniz. Yapay zekânın yazdığı yazılar Ghost'a taslak, planlı veya yayında olarak düşer; isterseniz bülten olarak e-postayla gönderilir. Yeni yazı yayınlandığında ve yeni üye kaydolduğunda iş akışı başlar; webhook'ları OrqLabs sizin yerinize kurar.

⏱ 10 dakika

Kimlik kartı#

Ne işe yarar?#

Ghost kutusunun işlemleri:

Ayrıntılar:

• İçerik: HTML etiketi yoksa Markdown kabul edilip HTML'e çevrilir; Ghost HTML'i kendi editör kartlarına dönüştürür (?source=html). Bu dönüşümde bazı özel biçimlendirmeler sadeleşebilir.
• Etiketler: adla verilir, olmayanlar oluşturulur; ilk etiket birincil etikettir. Güncellemede verdiğiniz liste mevcut etiketlerin yerini alır.
• Bülten gönderimi yalnızca açıkça istenirse yapılır: Send as newsletter alanına bülten kısa adını (slug, ör. default-newsletter) yazar ve durumu Published veya Scheduled seçerseniz Ghost yazıyı abonelere e-postayla gönderir. Alan boşsa yazı yalnızca sitede yayınlanır. Newsletter recipients ile tüm aboneler, yalnızca ücretsiz veya yalnızca ücretli üyeler seçilir.
• Öne çıkan görsel: adres olduğu gibi kullanılır. Görsel adresi geçici ise (süresi dolan bağlantılar) gelişmiş ayarlardan Upload feature image to Ghost'u açın; görsel Ghost'a kopyalanır.
• Test çalıştırmaları: editördeki test modunda yazı oluşturma, güncelleme ve üye ekleme çalıştırılmaz; okuma işlemleri çalışır.

Ön koşullar#

• Ghost 5.x (Ghost(Pro) veya kendi sunucunuz).
• Ghost'ta Owner veya Administrator rolü (özel entegrasyon yalnızca bu rollerle oluşturulur).
• Bülten göndereceksiniz: Ghost'ta e-posta gönderiminin (Ghost(Pro) veya Mailgun) yapılandırılmış olması.

Adım adım kurulum#

A) Ghost'ta özel entegrasyon#

1. Ghost Admin → Settings (dişli) → Advanced → Integrations.
2. Custom sekmesinde Add custom integration → ad: OrqLabs → Add.
3. Açılan pencereden iki değeri kopyalayın:
   • API URL – ör. https://ornekblog.ghost.io veya https://blog.ornek.com.
   • Admin API key – 6501a2b3…:9f8e7d… biçiminde, iki nokta üst üsteyle ayrılmış iki parça.

Dikkat: Aynı penceredeki Content API key (iki nokta içermez) yalnızca okuma içindir ve çalışmaz.

B) OrqLabs'ta bağlama#

1. Entegrasyonlar → Ghost → Bağla → Proje seçin.
2. Admin API URL: A adımındaki API URL.
3. Admin API key: Admin API anahtarı → Bağla.

OrqLabs site başlığını okuyup anahtarı bir yazı listesiyle doğrular, ardından iki webhook'u (post.published, member.added) bu entegrasyona kendisi ekler. Ghost'taki entegrasyon sayfasında Webhooks bölümünde OrqLabs · post.published ve OrqLabs · member.added görünür. Her teslimat OrqLabs'ın ürettiği gizli anahtarla imzalanır ve imzası doğrulanmayan istekler reddedilir.

Örnek iş akışları#

1) SEO önerisinden Ghost taslağı#

1. Zamanlama – haftada bir.
2. SEO ve Trafik ajanı (rehber) – içerik özetleri (contentBriefs).
3. Metin üret – Bu özete göre Markdown blog yazısı yaz: {{ $json.brief }} → text.
4. Ghost → Create post – Title {{ $json.title }}, Content {{ $json.text }}, Status boş (taslak), Tags SEO.
5. Ekibe bildir – Taslak hazır: {{ $json.editUrl }}.

2) Onaylı yayın + bülten#

… Create post (taslak) → Onay iste → onaylandı → Ghost → Update post (Post ID {{ $json.id }}, Status Published, Send as newsletter default-newsletter).

3) Yeni üyeye hoş geldin akışı#

Entegrasyon olayı (Ghost, GHOST · Member added) → Metin üret (kişiselleştirilmiş hoş geldin mesajı) → e-posta gönderimi veya CRM'e yaz. Çıktıda email, name, status (free / paid), labels, newsletters bulunur.

4) Form kaydını Ghost üyesi yapma#

Entegrasyon olayı (ör. Typeform veya Tally formu) → Ghost → Add member (Email {{ $json.email }}, Name {{ $json.name }}, Labels webinar, Newsletters Haftalık bülten).

Limitler#

Bağlantıyı test etme#

Bağlantıyı test et site başlığını ve Ghost sürümünü gösterir. Webhook'ların kurulup kurulmadığını Ghost'taki entegrasyon sayfasından kontrol edin; kurulamadıysa hata entegrasyon kartında görünür.

Kimlik bilgilerini yenileme#

Ghost'taki entegrasyon sayfasında Regenerate ile yeni Admin API anahtarı üretin (eskisi hemen geçersiz olur) ve OrqLabs'ta Kimlik bilgileri → Güncelle ile girin. Webhook'lar anahtara değil Ghost entegrasyonuna bağlı olduğu için çalışmaya devam eder. Ghost'taki özel entegrasyonu silerseniz webhook'ları da silinir; o zaman OrqLabs'ta bağlantıyı kesip yeniden bağlayın.

Sık karşılaşılan hatalar#

Sık sorulan sorular#

Yanlışlıkla bülten gönderir mi? Hayır. Bülten yalnızca Send as newsletter dolu ve durum Published / Scheduled iken gider. Taslaklarda bu alan yok sayılır.

Ücretli üyeler için yazı yayınlayabilir miyim? Evet; gelişmiş ayarlarda Access → Paid members only.

Mevcut üyenin etiketleri silinir mi? Hayır. Add member mevcut etiket ve bülten aboneliklerine yenilerini ekler, hiçbirini kaldırmaz.

Sonraki adım#

• WordPress
• Webflow
• Entegrasyonlara genel bakış