Slack و Discord
أرسل إشعارات واضحة من B1 مباشرةً إلى قناة Slack أو Discord، مثل الأشخاص الجدد والتبرعات والتسجيلات في المجموعات وإرسالات النماذج وأحداث التقويم وغيرها. لا حاجة إلى حساب طرف ثالث ولا إلى Zap تحتاج إلى صيانته: يعيد B1 تنسيق الأحداث إلى رسائل دردشة ويرسلها بنفسه بطريقة POST إلى عنوان Webhook الخاص بالقناة.
قبل أن تبدأ
- تحتاج إلى صلاحية تعديل الإعدادات (Edit Settings) في B1Admin
- مسؤول في مساحة عمل Slack أو خادم Discord لإنشاء Incoming Webhook للقناة
- حدّد القناة التي تريد استقبال الإشعارات فيها (يمكنك استخدام القناة نفسها لعدة أنواع من الأحداث، أو توزيعها على قنوات متعددة)
كيف يعمل
يحتوي B1 على نوع موصل (Connector Type) مدمج لمنصات الدردشة. عند إنشاء Webhook بنوع Slack أو Discord، يواصل محرك Webhook عمله المعتاد من تسليم وإعادة محاولة وترويسات موقّعة، لكنه يعيد تشكيل محتوى الرسالة من الغلاف المعتاد في B1 {event,churchId,data} إلى رسالة قصيرة من النوع {text} في Slack أو {content} في Discord، وهو الشكل الذي تتوقعه هاتان الخدمتان.
لا تتصل خوادم B1 بـ Slack لكل كنيسة على حدة، بخلاف تدفق Webhook الصادر الموجود أصلاً، فلا يوجد شيء جديد لاستضافته ولا تكلفة إضافية.
Slack: خطوة بخطوة
1. احصل على عنوان Slack Incoming Webhook URL
- افتح api.slack.com/apps في مساحة عمل Slack التي تريد استقبال الإشعارات فيها.
- انقر Create New App → From scratch، وسمِّه مثلاً "B1 Notifications"، ثم اختر مساحة العمل.
- من القائمة الجانبية اختر Incoming Webhooks وفعّل Activate Incoming Webhooks إلى On.
- انقر Add New Webhook to Workspace، واختر القناة (مثلاً
#donations)، ثم انقر Allow. - ستعيدك Slack إلى الصفحة مع Webhook URL جديد يبدو هكذا:
https://hooks.slack.com/services/T0XXXXXXX/B0YYYYYYY/zzz…. انسخه، فهذه هي المعلومة الوحيدة التي يحتاجها B1.
تعامل مع عنوان Slack Webhook كأنه كلمة سر، فأي شخص يملكه يستطيع نشر رسائل في القناة. إذا كشفته عن طريق الخطأ، فأعد توليده من صفحة تطبيق Slack (إعادة التوليد تغيّر العنوان فقط، لذا حدّث B1 ليطابقه).
2. اربطه في B1Admin
- في B1Admin انتقل إلى الإعدادات → المطوّر → Webhooks.
- انقر New Webhook.
- املأ الحقول:
- Name: اسم واضح مثل "التبرعات → #donations". لا يراه سوى فريقك.
- Connector Type: اختر Slack.
- Payload URL: الصق عنوان Slack من الخطوة 1.
- Events: حدد الأحداث التي تريد إرسالها كرسائل. لقناة التبرعات اختر
donation.createdفقط. لقناة #people جرّبperson.createdوgroup.member.added.
- انقر Save. تظهر نافذة "Signing Secret"، ويمكنك تجاهلها مع Slack لأن Slack لا يتحقق من توقيعات B1، ثم أغلقها.
3. اختبره
أعد فتح الـ webhook من القائمة وانقر Send Test Event. خلال ثانية أو ثانيتين ستظهر رسالة مثل:
💝 New donation: $50.00
في قناة Slack الخاصة بك، وسيظهر صف جديد في جدول Recent Deliveries في الشاشة نفسها بالحالة succeeded. وبذلك تكون قد انتهيت.
Discord: خطوة بخطوة
1. احصل على عنوان Discord Webhook
- في خادم Discord الخاص بك، مرّر المؤشر فوق القناة التي تريد الإشعارات فيها وانقر أيقونة ⚙ الترس (Edit Channel).
- افتح Integrations → Webhooks → New Webhook.
- أعطه اسماً وصورة رمزية (اختيارياً)، ثم انقر Copy Webhook URL. العنوان يبدو هكذا:
https://discord.com/api/webhooks/123…/abc….
2. اربطه في B1Admin
مطابق لتدفق Slack أعلاه، باستثناء أن تضبط Connector Type على Discord. ألصق عنوان Discord في Payload URL واحفظ.
لا تحتاج إلى إضافة /slack في نهاية عنوان Discord، فـ B1 يرسل حمولات {content} الأصلية في Discord، وليست حمولات متوافقة مع Slack. ألصق العنوان الذي قدّمه لك Discord كما هو.
3. اختبره
استخدم زر Send Test Event نفسه. سيعرض Discord الرسالة في القناة المختارة، وينتقل سجل الإرسال إلى succeeded.
كيف تبدو الرسائل
| الحدث | مثال على الرسالة |
|---|---|
person.created | 👤 تمت إضافة شخص جديد: جوردان ريفيرا |
person.updated | 👤 تم تحديث الشخص: جوردان ريفيرا |
group.created | 👥 تم إنشاء مجموعة جديدة: دراسة الكتاب المقدس يوم الثلاثاء |
group.member.added | ➕ تمت إضافة شخص إلى مجموعة |
donation.created | 💝 تبرع جديد: $50.00 |
donation.updated | 💝 تم تحديث التبرع: $75.00 |
attendance.recorded | ✅ تم تسجيل الحضور |
form.submission.created | 📝 تم استلام إرسال نموذج جديد |
event.created | 📅 حدث جديد: خدمة عيد الفصح |
الكتالوج الكامل موجود في كتالوج أحداث الـ Webhook، ويمكن توجيه أي حدث منه إلى Slack أو Discord.
قناة واحدة لكل موضوع
لست مضطراً إلى وضع كل الأحداث في مكان واحد. تُعدّ معظم الكنائس عدداً قليلاً من الـ webhooks:
- قناة #donations تستقبل
donation.createdفقط - قناة #new-people لـ
person.createdوgroup.member.added - قناة #admin-alerts للأحداث قليلة الحجم مثل
form.submission.created
لا يوجد حد لعدد الـ webhooks لكل كنيسة. كل واحد منها مستقل، فحذف أحدها أو تعطيله لا يؤثر في الباقي.
فحص عمليات الإرسال
يعرض جدول Recent Deliveries في محرر الـ webhook آخر 50 محاولة. انقر على أي صف لترى الحمولة الدقيقة التي أُرسلت والاستجابة التي عادت. بالنسبة لموصل Slack تكون الحمولة {"text":"💝 New donation: $50.00"}، وليس الغلاف الخام {event,churchId,...}، لأن B1 يعيد تشكيلها قبل الإرسال.
إذا فشلت محاولة (شارة حمراء failed أو exhausted)، تعرض النافذة رمز حالة HTTP ونص الاستجابة لترى بدقة ما لم يعجب Slack أو Discord، وغالباً ما يكون ذلك خطأ في نسخ العنوان ولصقه.
استكشاف الأخطاء وإصلاحها
- لا تظهر رسالة والحالة
400: غالباً يكون نوع الموصل مضبوطاً على Standard بينما العنوان عنوان Slack أو Discord. يرفض Slack وDiscord الغلاف الخام. بدّل القائمة إلى Slack أو Discord وأعد إرسال الاختبار. - تم تعطيل الـ webhook تلقائياً: بعد 3 عمليات إرسال فاشلة متتالية يوقفه B1. أصلح العنوان (أو أعد توليده في Slack أو Discord) وفعّل Active مرة أخرى.
- وصلت الرسالة لكنها تفتقد التفاصيل: كل منصة دردشة تحدّ من حجم الرسالة. رسائل B1 قصيرة عن قصد، وللإشعارات الأغنى استخدم Zapier أو Make لإنشاء رسالة Slack أكمل عبر إجراءات Slack الخاصة بهما.
تغيير أنواع الموصلات لاحقاً
يمكنك تغيير نوع الموصل في webhook موجود، ويسري التغيير مع الإرسال التالي. إذا انتقلت من Slack إلى Standard، فوجّه العنوان إلى نقطة نهاية HTTPS الخاصة بك، وسيبدأ مفتاح التوقيع نفسه (الذي صدر عند إنشاء الـ webhook) قابلاً للتحقق بوصفه الغلاف الخام.
انظر أيضاً
- Zapier: لسير عمل متعدد الخطوات يُطلق بأحداث B1
- Make: منشئ السيناريوهات المرئي
- Webhooks (المرجع للمطورين): تنسيق الحمولة الكامل والتوقيع، إذا أردت يوماً توجيه webhook إلى خادمك الخاص