Patreon

Bu rehberde: Patreon kampanyanızı (içerik üreticisi sayfanızı) Creator's Access Token ile bağlarsınız. Yeni bir üye katıldığında, bir üye destek miktarını değiştirdiğinde veya üyelik silindiğinde iş akışı başlar; akış içinden kampanya bilgisini ve üye listesini okuyabilirsiniz.

⏱ 10 dakika

Kimlik kartı#

Ne işe yarar?#

Tetikleyiciler:

Akış şu alanlarla başlar: memberId, userId, customerName, customerEmail, subscriptionStatus (active_patron, declined_patron, former_patron), total (şu an hak edilen aylık destek, sent → ana birim), tierNames (katman adları), productName (ilk katman), pledgeStartedAt, lastChargeDate, lastChargeStatus (Paid, Declined …), lifetimeSupport (toplam destek), note ve kısaltılmış raw.

Patreon kutusunun işlemleri:

Ön koşullar#

• Yayında bir Patreon içerik üreticisi sayfası (kampanya). Erişim anahtarı kampanya sahibinin hesabından alınmalıdır.
• Patreon geliştirici portalında bir istemci (client) – aşağıda.

Adım adım kurulum#

A) Patreon'da Creator's Access Token#

1. Kampanya sahibi hesabıyla patreon.com/portal → My Clients → Create Client.
2. Formu doldurun: uygulama adı OrqLabs, açıklama, Redirect URIs alanına https://orqlabs.com yazabilirsiniz (bu yöntemde kullanılmaz). Client API Version olarak 2 seçin.
3. Create Client → istemcinin ayrıntılarını açın ve Creator's Access Token değerini kopyalayın.

B) OrqLabs'ta bağlama#

1. Entegrasyonlar → Patreon → Bağla → Proje seçin.
2. Creator's access token alanına anahtarı yapıştırın → Bağla.

Bağlantı kurulunca OrqLabs kampanyanız için üç tetikleyiciyi dinleyen bir webhook'u Patreon API'siyle otomatik oluşturur. Patreon bu webhook için kendi gizli anahtarını üretir; OrqLabs onu saklar ve her teslimatın imzasını onunla doğrular. Webhook'u portalda My Webhooks altında görebilirsiniz.

Örnek iş akışları#

1) Yeni üyeye hoş geldin mesajı#

Entegrasyon olayı (PATREON · New member) → Eğer ({{ $json.subscriptionStatus }} eşittir active_patron) → Metin üret ({{ $json.tierNames }} katmanına katılan {{ $json.customerName }} için samimi bir hoş geldin mesajı yaz; katmanın avantajlarını hatırlat.) → E-posta gönder ({{ $node["Entegrasyon olayı"].json.customerEmail }}).

2) Destek artışına teşekkür#

Entegrasyon olayı (PATREON · Pledge updated) → Ekibe bildir ({{ $json.customerName }} desteğini {{ $json.total }} olarak güncelledi ({{ $json.productName }})) → Metin üret + E-posta gönder ile kişisel teşekkür.

3) Aylık destekçi listesi#

Zamanlama (her ayın 1'i) → Patreon → List members (Patron status Active patrons, Max members 1000) → Rapor oluştur (katmanlara göre üye sayısı) veya CRM'e yaz.

Tetikleyiciler nasıl çalışır?#

• Patreon her teslimatı webhook'un gizli anahtarıyla imzalar: X-Patreon-Signature = gövdenin HMAC-MD5 özeti (hex). OrqLabs imzayı ham gövde üzerinden doğrular; imzasız veya hatalı teslimatları reddeder. Olay türü X-Patreon-Event başlığından okunur.
• New member ve Member removed aynı üye için ikinci kez akış başlatmaz; Pledge updated her farklı değişiklik için bir kez başlar.
• Ücretsiz üyelik (takipçi) de New member olayı üretebilir; ücretli destekçiler için subscriptionStatus alanını süzün.
• Teslimatlar art arda başarısız olursa Patreon webhook'u duraklatabilir; portalda My Webhooks altında durumunu kontrol edin.

Limitler#

Bağlantıyı test etme#

Bağlantıyı test et hesap adını, kampanya adını ve üye sayısını gösterir. Tetikleyiciyi denemek için portalda My Webhooks altındaki webhook'tan test teslimatı gönderin veya ikinci bir hesapla ücretsiz katmana katılın.

Kimlik bilgilerini yenileme#

Creator's Access Token'ın süresi dolabilir; Patreon portalında istemcinin sayfasından anahtarı yenileyin (Refresh Token) ve OrqLabs'ta ayrıntı panelinden Kimlik bilgileri → Güncelle ile girin. Süresi dolan anahtar AUTH hatası verir ve entegrasyon Süresi doldu durumuna geçer. Webhook ayrı bir gizli anahtar kullandığı için anahtar yenilemesinden etkilenmez.

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

Sık sorulan sorular#

Bu bağlantı Patreon'a giriş yapmamı (OAuth) gerektirir mi? Hayır. Kendi istemcinizin Creator's Access Token'ı yeterlidir; OrqLabs yalnızca sizin kampanyanızın verilerine erişir.

Tutarlar hangi para biriminde? Patreon tutarları kampanyanızın para biriminde, sent cinsinden verir; OrqLabs ana birime çevirir (500 → 5).

Birden fazla kampanyam var; hangisi kullanılır? Patreon'da bir hesabın tek içerik üreticisi kampanyası vardır; OrqLabs anahtarın ait olduğu kampanyayı kullanır.

Sonraki adım#

• Gumroad
• Lemon Squeezy
• Entegrasyonlara genel bakış