---
title: تكامل Slack
description: "التواصل الجماعي والتعاون مع تكامل Slack لـ CrewAI."
icon: "slack"
mode: "wide"
---

## نظرة عامة

مكّن وكلاءك من إدارة التواصل الجماعي عبر Slack. أرسل الرسائل، وابحث في المحادثات، وأدر القنوات، ونسّق أنشطة الفريق لتبسيط سير عمل التعاون باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.

## المتطلبات الأساسية

قبل استخدام تكامل Slack، تأكد من توفر ما يلي:

- حساب [CrewAI AMP](https://app.crewai.com) مع اشتراك فعّال
- مساحة عمل Slack بالصلاحيات المناسبة
- ربط مساحة عمل Slack الخاصة بك عبر [صفحة التكاملات](https://app.crewai.com/integrations)

## إعداد تكامل Slack

### 1. ربط مساحة عمل Slack الخاصة بك

1. انتقل إلى [تكاملات CrewAI AMP](https://app.crewai.com/crewai_plus/connectors)
2. ابحث عن **Slack** في قسم تكاملات المصادقة
3. انقر على **Connect** وأكمل عملية OAuth
4. امنح الصلاحيات اللازمة للتواصل الجماعي
5. انسخ رمز المؤسسة من [إعدادات التكامل](https://app.crewai.com/crewai_plus/settings/integrations)

### 2. تثبيت الحزمة المطلوبة

```bash
uv add crewai-tools
```

### 3. إعداد متغير البيئة

<Note>
  لاستخدام التكاملات مع `Agent(apps=[])`, يجب تعيين متغير البيئة
  `CREWAI_PLATFORM_INTEGRATION_TOKEN` برمز المؤسسة الخاص بك.
</Note>

```bash
export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"
```

أو أضفه إلى ملف `.env`:

```
CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
```

## الأدوات المتاحة

### **إدارة المستخدمين**

<AccordionGroup>
  <Accordion title="slack/list_members">
    **الوصف:** عرض جميع الأعضاء في قناة Slack.

    **المعاملات:**
    - لا توجد معاملات مطلوبة

  </Accordion>

  <Accordion title="slack/get_user_by_email">
    **الوصف:** البحث عن مستخدم في مساحة عمل Slack بواسطة عنوان بريده الإلكتروني.

    **المعاملات:**
    - `email` (string, مطلوب): عنوان البريد الإلكتروني للمستخدم في مساحة العمل

  </Accordion>

  <Accordion title="slack/get_users_by_name">
    **الوصف:** البحث عن المستخدمين بواسطة اسمهم أو اسم العرض.

    **المعاملات:**
    - `name` (string, مطلوب): الاسم الحقيقي للمستخدم للبحث عنه
    - `displayName` (string, مطلوب): اسم عرض المستخدم للبحث عنه

  </Accordion>
</AccordionGroup>

### **إدارة القنوات**

<AccordionGroup>
  <Accordion title="slack/list_channels">
    **الوصف:** عرض جميع القنوات في مساحة عمل Slack.

    **المعاملات:**
    - لا توجد معاملات مطلوبة

  </Accordion>
</AccordionGroup>

### **المراسلة**

<AccordionGroup>
  <Accordion title="slack/send_message">
    **الوصف:** إرسال رسالة إلى قناة Slack.

    **المعاملات:**
    - `channel` (string, مطلوب): اسم القناة أو معرّفها
    - `message` (string, مطلوب): نص الرسالة المراد إرسالها
    - `botName` (string, مطلوب): اسم البوت الذي يرسل هذه الرسالة
    - `botIcon` (string, مطلوب): أيقونة البوت - يمكن أن تكون عنوان URL لصورة أو رمز تعبيري

  </Accordion>

  <Accordion title="slack/send_direct_message">
    **الوصف:** إرسال رسالة مباشرة إلى مستخدم محدد في Slack.

    **المعاملات:**
    - `memberId` (string, مطلوب): معرّف المستخدم المستلم
    - `message` (string, مطلوب): نص الرسالة المراد إرسالها
    - `botName` (string, مطلوب): اسم البوت الذي يرسل هذه الرسالة
    - `botIcon` (string, مطلوب): أيقونة البوت

  </Accordion>
</AccordionGroup>

### **البحث والاكتشاف**

<AccordionGroup>
  <Accordion title="slack/search_messages">
    **الوصف:** البحث عن الرسائل عبر مساحة عمل Slack.

    **المعاملات:**
    - `query` (string, مطلوب): استعلام بحث باستخدام صيغة بحث Slack للعثور على الرسائل المطابقة

  </Accordion>
</AccordionGroup>

## أمثلة الاستخدام

### إعداد Agent أساسي لـ Slack

```python
from crewai import Agent, Task, Crew

# Create an agent with Slack capabilities
slack_agent = Agent(
    role="Team Communication Manager",
    goal="Facilitate team communication and coordinate collaboration efficiently",
    backstory="An AI assistant specialized in team communication and workspace coordination.",
    apps=['slack']  # All Slack actions will be available
)

# Task to send project updates
update_task = Task(
    description="Send a project status update to the #general channel with current progress",
    agent=slack_agent,
    expected_output="Project update message sent successfully to team channel"
)

# Run the task
crew = Crew(
    agents=[slack_agent],
    tasks=[update_task]
)

crew.kickoff()
```

## التواصل مع الدعم

<Card title="تحتاج مساعدة؟" icon="headset" href="mailto:support@crewai.com">
  تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل Slack أو
  استكشاف الأخطاء وإصلاحها.
</Card>
