تطبيق سلاك

يمكن للوكيل الإجابة عن فريقك في سلاك، سواء كان مساعدًا للموارد البشرية أو مكتبًا لدعم تقنية المعلومات أو مساعدًا للعمليات، في المكان الذي يتواصل فيه الموظفون أصلًا. يكفي أن يُشار إلى التطبيق في قناة أو تُرسل إليه رسالة مباشرة، فيرد الوكيل ضمن سلسلة الرسالة.

ربط تطبيق

1. في backcrew، افتح صفحة الوكيل، ثم التضمين، ثم تطبيق سلاك. ستظهر بيانات تعريف التطبيق (manifest) المُعدّة لهذا الوكيل.
2. انقر إنشاء تطبيق سلاك، أو انتقل إلى api.slack.com/apps ثم Create New App ثم From a manifest، واختر مساحة عملك في سلاك والصق بيانات التعريف. تتضمن هذه البيانات كل ما يحتاجه التطبيق: صلاحية قراءة الإشارات والرسائل المباشرة والرد عليها، والعنوان الذي يرسل إليه سلاك رسائل هذا الوكيل.
3. في إعدادات التطبيق، افتح Install App ثم Install to Workspace، ووافق على التثبيت.
4. انسخ Bot User OAuth Token (ضمن OAuth & Permissions، ويبدأ بـ xoxb-) وSigning Secret (ضمن Basic Information ثم App Credentials).
5. عُد إلى backcrew، والصق القيمتين وانقر ربط التطبيق.

تتحقق backcrew من الرمز لدى سلاك، وتحفظ الرمز والسر في مخزن أسرار (وليس في قاعدة بياناتها)، ولا تعرضهما مجددًا. تعرض البطاقة بعد ذلك مساحة عملك في سلاك.

لاستخدام التطبيق في قناة، أضفه إليها أولًا: أشِر إليه (@your-app) وسيعرض سلاك إضافته، أو استخدم Integrations ثم Add apps في إعدادات القناة.

سلوك التطبيق

• يجيب عندما يُشار إليه في قناة أُضيف إليها، وعن الرسائل المباشرة (افتحه من قسم Apps في الشريط الجانبي لسلاك).
• يرد ضمن سلسلة الرسالة. تمثل كل سلسلة محادثة واحدة: تستكمل الردود اللاحقة في السلسلة نفسها المحادثة، وتبدأ كل رسالة جديدة محادثة جديدة.
• لكل شخص ذاكرته الخاصة إن كان الوكيل يستخدم الذاكرة.
• تحصل الإشارة التي لا تتضمن سؤالًا على ترحيب قصير، وتحصل الملفات والصور على رد مهذب بأنه لا يقرأ سوى الرسائل النصية، ولا يكلف أي منهما شيئًا.
• يتجاهل برامج البوت الأخرى، والرسائل في القنوات التي لا تُشير إليه.
• تُقسَّم الردود الطويلة لتتوافق مع حجم رسائل سلاك.
• عند نفاد أرصدة مساحة العمل أو بلوغها حدها الشهري، يرد التطبيق بأنه لا يستطيع الإجابة حاليًا وأن المسؤول عنه يمكنه معالجة ذلك. لا يرى الأشخاص رصيدك ولا الأخطاء الداخلية.

الأمان

• كل رسالة من سلاك موقّعة بالسر الخاص بتطبيقك. ترفض backcrew أي رسالة غير موقّعة، أو موقّعة بسر آخر، أو مضى عليها أكثر من خمس دقائق، فلا يستطيع أي طرف آخر دفع الوكيل إلى الإجابة أو إعادة إرسال رسالة قديمة.
• لا يجيب عن الرسالة إلا الوكيل الذي أُرسلت إلى تطبيقه.
• يعيد سلاك إرسال الرسائل التي يظن أنها لم تصل، وتجيب backcrew عن كل رسالة (وتحتسب تكلفتها) مرة واحدة فقط.

الإيقاف أو الفصل

• الإيقاف يُبقي التطبيق مربوطًا لكنه يرد بأنه متوقف، دون أي تكلفة.
• فصل التطبيق يوقف إجاباته فورًا ويحذف الرمز والسر من backcrew. يبقى التطبيق في مساحة عملك في سلاك: احذفه منها إن لم تعد بحاجة إليه، أو اربطه مجددًا من هنا.

يجيب كل تطبيق عن 30 رسالة في الدقيقة كحد أقصى لجميع من يتحدثون معه.

حل المشكلات

• تعرض البطاقة “لا رسائل بعد” رغم الإشارة إلى التطبيق. تحقق من السر (Signing Secret): تُرفض الرسائل الموقّعة بسر مختلف. افصل التطبيق ثم اربطه مجددًا بالسر الصحيح.
• يفيد سلاك بأن عنوان الطلبات (Request URL) لم يُتحقق منه. في Event Subscriptions ضمن إعدادات التطبيق، انقر Retry. يجب أن يكون العنوان هو نفسه الوارد في بيانات التعريف.
• لا يحدث شيء في القناة. تأكد من إضافة التطبيق إلى القناة ومن الإشارة إليه.