Make
Make (eski adıyla Integromat), görsel bir iş akışı otomasyon platformudur. Ruhen Zapier'a benzer, ancak daha esnek mantık sunar ve büyük ölçekte daha uygun maliyetlidir. Resmi B1.church Make uygulaması, B1 olaylarına anında tepki veren ve B1'e kayıt yazan "senaryolar" oluşturmanıza olanak tanır.
Başlamadan Önce
- Bir Make hesabı (ücretsiz katman küçük iş akışlarını karşılar)
- B1Admin'de Ayarları Düzenle iznine sahip bir kilise yöneticisi
- Oluşturmak istediğiniz senaryo hakkında kabaca bir fikir
Modüller
| Tür | Açıklama | B1 olayı / uç nokta |
|---|---|---|
| Anlık Tetikleyici | Olayları İzle | abone olunan herhangi bir B1 olayı (person.created, donation.created, …) |
| Eylem | Kişi Oluştur | yeni bir kişi ekler |
| Eylem | Bağış Ekle | bir bağışı kaydeder |
| Eylem | Gruba Üye Ekle | bir kişiyi bir gruba ekler |
| Arama | Kişi Ara | ada veya e-postaya göre kişi bulur |
Anlık tetikleyici, dinlenecek olayı seçmenize olanak tanır. Senaryo başına bir tetikleyici modülü kullanılır ve her olay için ayrı ayrı yapılandırılır.
Kurulum
1. B1 API anahtarı oluşturun
- B1Admin'de Ayarlar → Geliştirici → API Anahtarları bölümüne gidin.
- Yeni API Anahtarı'na tıklayın, anahtara "Make" adını verin ve ihtiyacınız olan kapsamları (scope) seçin.
- Senaryolarınızdan herhangi biri anlık tetikleyiciyi kullanıyorsa
settings:writekapsamını ekleyin. Senaryo açıldığında Make, sizin adınıza bir webhook kaydeder. - Ayrıca eylem modüllerinin ihtiyaç duyduğu kapsamları da verin (ör. Bağış Ekle modülü için
donations:write). - Kaydedin ve
cak_…ile başlayan anahtarı kopyalayın.
2. Bağlantıyı kurun
- Make'te yeni bir senaryo oluşturun ve B1.church tetikleyici modülünü tuvale sürükleyin.
- İstendiğinde Bağlantı oluştur'a tıklayın. API anahtarını API Key alanına yapıştırın. API Base URL alanını, hazırlık ortamında test yapmıyorsanız,
https://api.churchapps.orgolarak bırakın. - Kaydet'e tıklayın. Make, kilise profilinizi okuyarak anahtarı test eder.
Bağlantı Make hesabınızda saklanır ve senaryolar arasında yeniden kullanılır.
3. Tetikleyiciyi yapılandırın
- Olayları İzle modülünün ayarlarını açın.
- İstediğiniz olayı seçin, ör.
donation.created. - Kaydedin. Make, benzersiz bir webhook URL'si oluşturur ve bunu dahili olarak saklar.
4. Sonraki modülleri ekleyin
Tuvale Make'in yüzlerce uygulama modülünden herhangi birini ekleyebilirsiniz: Mailchimp, Google Sheets, Slack, HubSpot ya da kendi HTTP uç noktanız gibi. Tetikleyicinin çıktısını (event, churchId, data.id, data.amount, …) girdi alanlarına eşleyin. Make'in düzleştirme, yineleyici, yönlendirici ve toplayıcı modülleri, Zapier'da zor olacak dallanmalı ve paralel akışlar oluşturmanıza olanak tanır.
5. Senaryoyu açın
Senaryo başlığındaki Active düğmesini açın. Make, URL'yi kaydetmek için B1'in POST /membership/webhooks uç noktasını çağırır. Bu andan itibaren eşleşen her B1 olayı senaryodan gerçek zamanlı olarak geçer.
Senaryoyu kapattığınızda DELETE /membership/webhooks/{id} çağrısı yapılır, böylece yetim kalan abonelik bırakılmaz.
Yaygın Senaryolar
Finans incelemesi için bağışları bir Google E-Tabloya aktarın
- Tetikleyici — B1: Olayları İzle (
donation.created) - Eylem — Google Sheets: Satır Ekle.
data.donationDate,data.amount,data.personId,data.methodvedata.batchIdalanlarını e-tablonun sütunlarına eşleyin.
Bağış tutarına göre koşullu Slack bildirimi
- Tetikleyici — B1: Olayları İzle (
donation.created) - Yönlendirici:
- A Dalı — Filtre:
data.amount >= 1000→ Slack:#major-giftskanalına gönder - B Dalı — geri kalan her durum → Slack:
#donationskanalına gönder
- A Dalı — Filtre:
Yeni kişi → CRM + hoş geldin e-postası + Slack
- Tetikleyici — B1: Olayları İzle (
person.created) - Eylem — HubSpot: Kişi Oluştur
- Eylem — Mailgun: Hoş Geldin E-postası Gönder
- Eylem — Slack:
#new-peoplekanalını bilgilendir (paralel çalışması için Make'in yönlendiricisini kullanın)
Anlık Tetikleyici Nasıl Çalışır
Anlık tetikleyici sorgulama (polling) yerine webhook ile çalışır. Etkinleştirildiğinde Make, kendi oluşturduğu URL'yi ve seçtiğiniz olayı içeren bir POST /membership/webhooks isteği gönderir. Olay B1'de gerçekleştiğinde B1, zarfı Make'in URL'sine POST eder ve senaryonuz birkaç saniye içinde çalışır. Senaryoyu devre dışı bırakmak webhook'u kaldırır.
Tetikleyici yalnızca senaryo etkinken gerçekleşen olaylarda çalışır. Geçmiş olaylar için geriye dönük çalıştırma yapılmaz.
Sınırlar ve Notlar
- Olayları İzle modülü başına bir olay. Tek bir senaryoda birden fazla olayı dinlemek için tetikleyici modüllerini ayrı senaryolara koyun veya aşağıda açıklanan birleşik olay listesiyle tek bir modül kullanın.
- İmza doğrulaması sunulmaz. Make,
X-B1-Signaturebaşlığını senaryoya iletmez. Güven sınırı, Make'in tahmin edilemez senaryo başına webhook URL'sidir. Bu, Make'in olağan uygulamasıdır. Açık imza kontrolleri gerekiyorsa bunun yerine SDK ile özel bir entegrasyon oluşturun. - İşlem sayısı. Eylem modüllerinden yapılan her API çağrısı, B1 tarafında değil, Make işlem kotanızdan düşer.
Sorun Giderme
- Bağlantı testi başarısız oluyor. En sık neden API anahtarındaki bir yazım hatasıdır. Anahtarı B1Admin'den yeniden kopyalayın. Tam anahtar yalnızca bir kez gösterilir. Kaybettiyseniz yeni bir anahtar oluşturun.
- Tetikleyici modülü etkinleşmiyor. B1Admin'de Ayarlar → Geliştirici → Webhook'lar bölümünü kontrol edin. Senaryoyu etkinleştirdikten sonra "Make — <event>" satırını görmüyorsanız anahtarda
settings:writekapsamı eksiktir. Anahtarı güncelleyin ve senaryoyu yeniden etkinleştirin. - Eylem
403 Forbiddendöndürüyor. API anahtarında bu uç nokta için gerekli kapsam yok. Örneğin Bağış Ekle modülüdonations:writegerektirir. B1Admin'de anahtarı güncelleyin ve yeniden test edin.
Uygulamayı Özelleştirme
B1.church Make uygulaması açık kaynaklıdır. JSON tanımları B1Integrations/Make/ deposunda bulunur. İhtiyacınız olan bir modül yoksa (ör. henüz kapsamadığımız bir uç nokta için yeni bir eylem), bu depoda bir issue veya PR açabilirsiniz.
Ayrıca Bakınız
- Zapier: Aynı model, daha basit bir arayüz ve daha geniş bir uygulama kataloğu
- Slack & Discord: Make kullanmadan yerleşik sohbet bildirimleri
- Webhook'lar (geliştirici başvurusu)