تخطي إلى المحتوى الرئيسي

Zapier

تتيح تطبيق B1.church الرسمي على Zapier لأي Zap أن يتفاعل مع أحداث كنيستك (شخص جديد، تبرع جديد، عضو جديد في مجموعة، …) وأن يكتب السجلات مرة أخرى إلى B1. لا حاجة إلى برمجة ولا إلى بنية تحتية، فأنت تُعدّ كل شيء في محرر Zapier بالسحب والإفلات، وتلصق مفتاح API، ثم تُشغّل الـ Zap.

في انتظار موافقة Zapier

تطبيق B1.church مبني ويعمل، لكنه ما زال في انتظار مراجعة Zapier قبل أن يظهر علنًا في دليل التطبيقات داخل محرر Zap. وحتى تتم الموافقة عليه، لا يمكن استخدامه إلا للحسابات المدعوة. يصف ما يلي كيف سيعمل بعد الموافقة.

قبل أن تبدأ

  • حساب Zapier (الخطة المجانية تكفي لعدد قليل من الـ Zaps)
  • مسؤول كنيسة لديه صلاحية Edit Settings في B1Admin (ستُنشئ مفتاح API)
  • فكرة عما تريد تحقيقه، مثلاً "عندما يُضاف شخص في B1، أضفه إلى قائمة Mailchimp الخاصة بي"

المشغّلات والإجراءات​

النوعالوصفحدث B1 / نقطة النهاية
المشغّلشخص جديدperson.created
المشغّلشخص محدَّثperson.updated
المشغّلتبرع جديدdonation.created
المشغّلعضو جديد في مجموعةgroup.member.added
المشغّلإرسال نموذج جديدform.submission.created
الإجراءإنشاء شخصيضيف شخصًا جديدًا
الإجراءإضافة تبرعيسجّل تبرعًا
الإجراءإضافة عضو إلى مجموعةيضيف شخصًا إلى مجموعة
الإجراءالبحث عن شخصيبحث عن شخص بالمعرّف أو البريد الإلكتروني أو الاسم، ويُفشل المهمة إذا لم يُطابق أحد

يمكنك دمج هذه مع أي تطبيق من أكثر من 7,000 تطبيق مدعوم في Zapier بحرية.

الإعداد​

1. إنشاء مفتاح API في B1​

  1. في B1Admin، انتقل إلى Settings ← Developer ← API Keys.
  2. انقر على New API Key، وأعطه اسمًا مثل "Zapier"، ثم اختر النطاقات (scopes) التي يحتاجها الـ Zap.
  3. مهم: تُسجّل مشغّلات Zapier خطافويب (webhook) نيابةً عنك عند تشغيل الـ Zap، وهذا يتطلب النطاق settings:write. أدرج دائمًا settings:write إذا كان أيٌّ من الـ Zaps يستخدم مشغّل B1.
  4. امنح أيضًا النطاقات التي تحتاجها الإجراءات، فمثلاً إجراء "إضافة تبرع" يحتاج إلى donations:write، وإجراء "إنشاء شخص" يحتاج إلى people:write.
  5. احفظ. يُعرض مفتاح cak_… الكامل مرة واحدة فقط، فانسخه.

2. ربط Zapier بـ B1​

  1. في Zapier، أنشئ Zap جديدًا.
  2. عندما تختار مشغّلًا أو إجراءً من B1 لأول مرة، سيطلب منك Zapier Sign in to B1.church.
  3. الصق مفتاح API من الخطوة 1 وانقر على Yes, Continue. يتحقق Zapier من المفتاح مع كنيستك.

يُحفظ الاتصال في Zapier ويُعاد استخدامه من قِبل كل Zap في حسابك.

3. بناء الـ Zap​

اختر مشغّلًا، ثم أضف خطوة إجراء واحدة أو أكثر. الأمثلة موضحة أدناه.

وصفات شائعة​

إضافة أشخاص B1 الجدد إلى Mailchimp​

  • المشغّل — B1: New Person
  • الإجراء — Mailchimp: Add/Update Subscriber. اربط الحقول name__first وname__last وcontactInfo__email في B1 بحقول First Name وLast Name وEmail في Mailchimp.

نشر التبرعات في قناة Slack ببطاقة أغنى من الموصل المدمج​

  • المشغّل — B1: New Donation
  • الإجراء — Slack: Send Channel Message. صمّم أي تخطيط تريده، من أزرار ومرفقات وغيرها، مما لا يستطيع موصل Slack المدمج تقديمه.

إضافة أعضاء المجموعات الجدد إلى Google Group​

  • المشغّل — B1: New Group Member (مُصفّى على groupId محدد)
  • الإجراء — Filter by Zapier: تابع فقط إذا كانت مجموعة B1 هي المجموعة التي تهمك
  • الإجراء — B1: Find Person (استخدم personId من المشغّل لجلب البريد الإلكتروني)
  • الإجراء — Google Groups: Add Member

إرسال نماذج الاستمارات إلى متتبّع المشاريع​

  • المشغّل — B1: New Form Submission
  • الإجراء — Notion / Linear / Asana / Trello: Create page / issue / task

كيف تعمل المشغّلات من الداخل​

المشغّلات هي REST hooks، وليست استعلامًا دوريًا، فـ Zapier لا يسأل B1 كل 15 دقيقة. عند تشغيل الـ Zap، يطلب Zapier من B1 تسجيل خطاف ويب يشير إلى عنوان Zapier خاص؛ وعندما يقع الحدث، يرسل B1 البيانات إلى Zapier فيبدأ الـ Zap خلال ثوانٍ. وعند إيقاف الـ Zap، يطلب Zapier من B1 حذف خطاف الويب، فلا تبقى اشتراكات يتيمة.

وهذا يعني أن المشغّل يعمل فقط للأحداث التي تقع بعد تشغيل الـ Zap. لا توجد إعادة تعبئة للبيانات السابقة، فتشغيل الـ Zap لا يُعيد تشغيل تبرعات الأمس.

الحدود والملاحظات​

  • عدة Zaps بالمشغّل نفسه يُسجّل كل منها خطاف ويب خاصًا به في B1، ولا يوجد تعارض، لكن من المفيد معرفة ذلك إذا كنت تفحص Settings ← Developer ← Webhooks وتتساءل لماذا توجد ثلاثة صفوف متطابقة باسم Zapier — donation.created.
  • بيانات الاختبار في إعداد الـ Zap: عند بناء الـ Zap، يطلب Zapier بيانات نموذجية لربط الحقول. سيجلب أحدث حدث مطابق من B1 إن وجد، وإلا يستخدم عينة اصطناعية من تعريف التطبيق.
  • تظهر أخطاء الإجراءات كأخطاء في الـ Zap ضمن سجل المهام في Zapier. السبب الشائع هو مفتاح API بدون النطاق الصحيح (مثلاً إجراء "إضافة تبرع" يحتاج إلى donations:write). أعد إنشاء المفتاح بالنطاقات الصحيحة وأعد الاتصال في Zapier.
  • حصص استدعاءات API الصادرة: كل استدعاء API من B1 ينفذه إجراء يُحتسب ضمن حصة المهام في Zapier، ولا يُحتسب أي شيء على جانب B1.

استكشاف الأخطاء وإصلاحها​

  • "Authentication failed" عند الاتصال: مفتاح API خاطئ أو ملغى أو يفتقر إلى النطاقات التي يحتاجها الـ Zap. أعد إنشاءه في B1Admin بنطاق settings:write على الأقل مع أي نطاقات للموارد يلمسها الـ Zap، ثم حدّث الاتصال.
  • المشغّل لا يعمل أبدًا: تأكد من تسجيل خطاف الويب فعلًا، ففي B1Admin يجب أن تظهر الآن Settings ← Developer ← Webhooks صفًا باسم "Zapier — <event>". إذا لم يكن موجودًا، فغالبًا لم يكن لمفتاح API نطاق settings:write وقت تشغيل الـ Zap. أصلح المفتاح، ثم أوقف الـ Zap وأعد تشغيله.
  • المشغّل يعمل مرتين: يُعيد Zapier الإرسال أحيانًا إذا فُقد إقراره. استخدم خطوة "Filter by Zapier" على معرّف فريد (مثل id الشخص) إذا احتجت إلى إزالة التكرار بدقة.

انظر أيضًا​