الوثائق

Slack

أرسِل واستقبِل رسائل Slack من داخل pipeline (Events API + chat.postMessage)، بنمط BYO.

Slack

يربط تكامل Slack مساحة عملك بالـ pipelines الخاصة بك، في الاتجاهين: استقبال الرسائل (رسالة Slack تُطلِق pipeline) وإرسال الردود (وكيل agent أو node ينشر في قناة أو في سلسلة thread).

ما الذي يمكنك فعله به

  • استقبال الرسائل من قناة عبر Events API وإطلاق pipeline عليها.
  • نشر رسالة في قناة أو كردّ في سلسلة thread.
  • سرد القنوات / المستخدمين، وقراءة الرسائل الأخيرة لإعطاء سياق لوكيل agent.

الأدوات والـ nodes

  • أدوات القراءة: slack.list_channels و slack.list_users و slack.read_messages.
  • أداة الكتابة (مع تأكيد): slack.post_message.
  • node بـ slack_outbound — إرسال عبر chat.postMessage، والردّ في سلسلة thread، بضمان exactly-once.
  • مستقبِل slack_inbound — نقطة دخول Events API، مع تحقّق أصيل من التوقيع على الجسم الخام، ونافذة مضادّة لإعادة التشغيل anti-replay، ومنع الحلقات (رسالة من الروبوت bot لا تُعيد إطلاق نفسها)، وإزالة تكرار الأحداث.

الربط (BYO)

  1. الإدارة ← التكاملات ← Slack.
  2. أدخل رمز الروبوت bot token (xoxb-…) و السرّ الموقِّع (signing secret) الخاص بتطبيق Slack.
  3. وجّه عنوان URL الخاص بـ Events API في تطبيقك إلى مستقبِل slack_inbound الخاص بالـ pipeline.
  4. يُشفَّر الرمز token والسرّ في حالة السكون ولا يُكشَفان مجدّداً أبداً.

Slack موصِّل BYO صارم: تستخدم تطبيق Slack الخاص بك، بلا احتساب استهلاك وبلا هامش من betool. تُتحقَّق توقيعات الأحداث على الجسم الخام — والرسالة المزوَّرة تُرفَض.

حالات الاستخدام

  • مساعد الفريق — وكيل agent يجيب على الأسئلة المنشورة في قناة باستخدام قاعدة معرفتك.
  • إشعارات قابلة للتنفيذ — pipeline ينشر تنبيهاً في سلسلة thread ويستقبل ردّ المشغّل operator لمتابعة المعالجة.