التكاملات
إرسال تغييرات مراحل الصفقات إلى قناة Slack
بعد هذا الإعداد تنشر نافس CRM رسالة في قناة Slack تختارها كلما انتقلت صفقة إلى مرحلة أخرى، فيها اسم الصفقة والمرحلتان والمبلغ. أغلب مشكلات هذا الربط تأتي من ثلاث نقاط في Slack نفسه، وهذه الخطوات تتجنبها.
قبل البدء
- متجر التطبيقات متاح من باقة البداية (Starter) فأعلى.
- حفظ بيانات الاعتماد وتعديلها لمديري مساحة العمل فقط.
- صلاحية إنشاء تطبيق في مساحة عمل Slack لديكم، أو مساعدة من مسؤول Slack.
الخطوات
أنشئ تطبيق Slack برمز بوت
في لوحة تطبيقات Slack أنشئ تطبيقًا، وأضف للبوت صلاحية chat:write، ثم ثبّته في مساحة عمل Slack. انسخ رمز البوت الذي يبدأ بـ xoxb- وسر التوقيع (Signing Secret).
ادعُ البوت إلى القناة
افتح القناة التي تريد النشر فيها في Slack وأضف التطبيق إليها. البوت الذي ليس عضوًا في القناة لا يستطيع النشر فيها.
افتح إعداد Slack في نافس
من «الأدوات» ← «متجر التطبيقات» ابحث عن Slack، وافتح بطاقته واضغط «إعداد Slack».
أدخل البيانات واحفظ
الصق رمز البوت وسر التوقيع، واكتب القناة الافتراضية، ثم «حفظ». بعد الحفظ لا تعود الأسرار إلى المتصفح؛ تعرض الشاشة «تم الإعداد» و«آخر تحديث» فقط، واترك الحقل فارغًا إن أردت الإبقاء على القيمة الحالية.
اختبر على مرحلتين
اضغط «اختبار الاتصال» للتحقق من الرمز، ثم «إرسال رسالة اختبار» لنشر رسالة حقيقية في القناة. أخيرًا حرّك صفقة تجريبية بين مرحلتين وتأكد أن الإعلان وصل.
تشخيص الأعطال
| ما تراه | السبب المرجح | الحل |
|---|---|---|
| نجح «اختبار الاتصال» وفشلت رسالة الاختبار بخطأ not_in_channel | البوت ليس عضوًا في القناة | أضف التطبيق إلى القناة من Slack |
| خطأ channel_not_found | اسم القناة خاطئ، أو القناة خاصة وكُتب اسمها بدل معرّفها | اكتب معرّف القناة الخاصة كما يظهر في تفاصيلها في Slack |
| فشل «اختبار الاتصال» نفسه | الرمز منسوخ ناقصًا أو أُلغي، أو التطبيق أُزيل من مساحة Slack | أعد نسخ رمز البوت والصقه ثم احفظ |
| رسالة الاختبار تصل والصفقات لا | لم تتغير مرحلة أي صفقة، فهذا الحدث الوحيد الذي يُنشر | حرّك صفقة بين مرحلتين |
| ضاع إعلان أثناء عطل في Slack | لا توجد إعادة محاولة لهذا التكامل | للإرسال الموثوق استخدم Webhook صادرًا |
حدود التكامل
- قناة افتراضية واحدة لكل مساحة عمل، وحدث واحد هو تغيير مرحلة الصفقة.
- باتجاه واحد: لا أوامر مائلة ولا إشارات إلى أشخاص ولا ردود تعود إلى نافس.
- إيقاف التطبيق من تبويب التطبيقات المثبتة لا يوقف الإرسال؛ لإيقافه امسح بيانات الاعتماد من صفحة الإعداد.
لإرسال أحداث أخرى بتوقيع وإعادة محاولة راجع إعداد Webhooks الصادرة، ولتفاصيل التكامل وشكل الرسالة راجع صفحة تكامل Slack.
المصادر
- Slack Developer Docs: chat.postMessage وأخطاؤهاطُّلع عليه في