> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wittify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# التَكاملات والأدوات

> اربط وكيلك بالخدمات الخارجية. تَصفَّح سوق أكثر من 21 تطبيقاً، أَضِف موصِّلات MCP، فَعِّل أدوات الوكيل المُدمَجة (التَحويل لموظف، حجز المواعيد، تتبُّع الطلبات، تحصيل المدفوعات)، ابنِ أدوات REST API مخصَّصة، ووَجِّه أحداث webhook فورية.

<div dir="rtl" lang="ar" style={{ direction: "rtl" }}>
  {/* wittify-rtl-wrapper */}

  <Note>
    التَكاملات والأدوات هي **الخطوة 6 (الهجين)** أو **الخطوة 5 (نصي / صوتي)**. الصفحة فيها أربعة أقسام: **سوق التَكاملات**، **أدوات الوكيل**، **أدوات API مخصَّصة**، **Webhooks والأحداث**. كل قسم مستقل، تَستطيع تَرك أي منها فارغاً إن لم تَحتجه. الخطوة اختيارية، تَستطيع التَقدُّم بدون اتصال أي شيء.
  </Note>

  ## ماذا تفعل هذه الخطوة

  هنا تُعطي الوكيل قدرات تَتجاوَز مجرَّد الإجابة على الأسئلة: إرسال رابط استرداد، البحث عن طلب، تَحويل المحادثة لموظف بشري، نَشر إشعار في Slack لحظة التقاط عميل محتمل. توجد أربع طرق لتَوصيل تلك القدرات، مرَتَّبة حسب مقدار الإعداد المطلوب:

  1. **السوق**، نقرة واحدة على OAuth أو مفتاح API، بدون كود.
  2. **أدوات الوكيل**، أربع أدوات مُدمَجة (التَحويل لموظف، حجز المواعيد، تتبُّع الطلبات، تحصيل المدفوعات) تَضبطها عبر نموذج.
  3. **أدوات API مخصَّصة**، نقاط REST API يُعرِّفها المستخدم. الوكيل يَقرر متى يَستدعيها.
  4. **Webhooks والأحداث**، الوكيل يُرسِل إشعارات HTTP POST إلى خادمك عند حدوث الأحداث.

  ## القسم 1: سوق التَكاملات

  كاتالوج تَطبيقات يَعتمد على الخادم، مُجمَّع حسب الفئة. كل بطاقة تَعرض شعار التطبيق، الاسم، وصفاً من سطر واحد، حبَّة حالة الاتصال، ووَسم لون لطريقة المصادقة (**OAuth** بنفسجي، **مفتاح API** أزرق).

  ### شريط الإحصاءات والفلاتر

  في أعلى بطاقة السوق، صف فيه ثلاث حبَّات إحصائية ومربع بحث:

  | ما تَعدّه                              | الحبَّة        |
  | -------------------------------------- | -------------- |
  | إجمالي التَكاملات في الكاتالوج         | **متاح**       |
  | كم اتصلت منها                          | **مفعَّل**     |
  | كم موصِّل Model Context Protocol أضفته | **موصلات MCP** |

  مربع البحث يَقرأ **بحث في التكاملات...** ويُصفِّي بالاسم أو الوصف. حد إدخال البحث 120 حرفاً.

  شريط فلاتر تحت الإحصاءات:

  * **الكل**، كل تَكامل في الكاتالوج (الافتراضي)
  * **المفعَّلة**، فقط ما اتصلت به
  * **Native**، تَكاملات بَناها Wittify (بدون جسر مصادقة)
  * **MCP**، فقط موصِّلاتك من نوع MCP

  عندما لا يُعطي الفلتر أي نَتائج، تَظهر حالة فارغة تَقرأ **لا توجد تكاملات تطابق هذا الفلتر** بالتَلميح *جرب بحثاً أو فلتراً آخر.*

  ### الاتصال عبر OAuth

  اضغط أي بطاقة بوَسم **OAuth**. يَقرأ الزر **إعداد**:

  1. اضغط البطاقة. تَفتح نافذة منبثقة (تُفتَح بشكل مُتزامن مع النَقرة، فلا يَحجبها المتصفح).
  2. تأَذَّن على موقع المَزوِّد (Google، Slack، Calendly، إلخ).
  3. يُعيد المَزوِّد تَوجيهك إلى المعالج برَمز تأكيد في الرابط.
  4. يَتم تأكيد الاتصال على الخادم، يُنظَّف الرابط، ويُعاد تَحميل الكاتالوج بحبَّة خضراء **مفعَّل** على البطاقة.

  إذا حَجب متصفِّحك النَوافذ المنبثقة، تَرى إشعاراً: *تم حجب النافذة المنبثقة. اسمح بالنوافذ المنبثقة وحاول مرة أخرى.* عند فشل آخر: *تعذر ربط التكامل.*

  ### الاتصال عبر مفتاح API

  اضغط أي بطاقة بوَسم **مفتاح API**. تَفتح نافذة بعنوان **ربط `{اسم التطبيق}`** والوصف *أدخل بيانات الاعتماد لربط هذا التكامل.*

  | ملاحظات                                                                                                                                   | الحقل                                  |
  | ----------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
  | حقل كلمة سر مَخفي. النص النائب: *الصق مفتاح API الخاص بك.* الإكمال التلقائي معطَّل.                                                       | **مفتاح API**                          |
  | يَظهر فقط حين يَحوي اسم التطبيق "Shopify". التَلميح: *النطاق الفرعي لمتجر Shopify (الجزء قبل .myshopify.com).* النص النائب: **my-store**. | **النطاق الفرعي للمتجر** (Shopify فقط) |

  أسفل النموذج، ملاحظة أمنية: *يتم إرسال بيانات الاعتماد مباشرة إلى Composio عبر HTTPS وتخزينها في الخادم، وليس في متصفحك.* زر الاتصال مُعطَّل حتى تَملأ كلا الحقلَين.

  زر الإرسال يَقرأ **ربط**. يَتغيَّر إلى **جارٍ الاتصال...** مع دوَّامة أثناء التَنفيذ. عند النجاح، يَقرأ الإشعار *تم ربط التكامل* وتُغلَق النافذة. عند الفشل: *تعذر ربط التكامل*، تَبقى النافذة مفتوحة لتَستطيع تَصحيح بيانات الاعتماد.

  ### قطع الاتصال

  اضغط زر **إعداد** على بطاقة مُتَّصِلة لفتح لوحة الإعداد. تَعرض اللوحة **متصل**، **آخر مزامنة منذ دقيقتين**، ومُلخَّص **الوصول المصرَّح به**، بالإضافة إلى مُنتقي مُشغِّل:

  | متى يُنفَّذ التَكامل                  | المُشغِّل                       |
  | ------------------------------------- | ------------------------------- |
  | بعد أن يَختم الوكيل المحادثة          | **انتهاء المحادثة** (الافتراضي) |
  | لحظة إنهاء الوكيل لنموذج جمع البيانات | **التقاط عميل محتمل**           |
  | كلما حَوَّل الوكيل لموظف بشري         | **طلب تحويل لموظف**             |

  زرَّان في الأسفل: **حفظ الإعدادات** (أساسي) و **قطع الاتصال** (حدّ أحمر).

  الضغط على قطع الاتصال يَفتح تأكيداً: *هل أنت متأكد من قطع الاتصال بـ `{الاسم}`؟ لن يتمكن وكيلك من استخدام هذا التكامل بعد الآن.* اضغط إلغاء للإبقاء، أو زر **قطع الاتصال** الأحمر للإزالة. يَقرأ إشعار النجاح *تم فصل التكامل.*

  ### بطاقة إضافة MCP

  أسفل شبكة السوق، بطاقة "إضافة موصِّل MCP" بحدود متَقطِّعة تَدعك تُوصِل أي خدمة تَتحدَّث **Model Context Protocol** (طريقة قياسية تَكشف من خلالها الأدوات نفسها لوكلاء الذكاء الاصطناعي). اضغط البطاقة لفتح نافذة **إضافة موصل MCP**، بالوصف *اتصل بأي نظام خارجي عبر بروتوكول سياق النموذج*:

  | ملاحظات                                                                                                   | الحقل              |
  | --------------------------------------------------------------------------------------------------------- | ------------------ |
  | حد أقصى 100 حرف، يَظهر على البطاقة                                                                        | **الاسم** (مطلوب)  |
  | يَجب أن يَكون HTTPS. رسالة الخطأ: *Must be a valid HTTPS URL.*                                            | **الرابط** (مطلوب) |
  | عَدد بالميلي ثانية. التَلميح: *بالملي ثانية. اترك فارغاً للافتراضي (30,000 ملي ثانية).*                   | **المهلة**         |
  | أزواج مفتاح/قيمة، حد أقصى 20. اضغط **زوج مفتاح-قيمة جديد** لإضافة صف. اضغط أيقونة سلَّة المهملات للإزالة. | **الترويسات**      |
  | نفس شكل الترويسات.                                                                                        | **الاستعلام**      |

  الحقول المطلوبة موسومة بنجمة حمراء. زر الإرسال يَقرأ **إنشاء MCP** للموصِّلات الجديدة، **حفظ التغييرات** عند التَعديل.

  بعد الإنشاء، يَظهر الموصِّل كبطاقة في شبكة السوق إلى جانب التَكاملات الأخرى، بِلَون **MCP** (أزرق). كل بطاقة MCP تَحوي زرَّي أيقونة في الزاوية: **تعديل** (قلم) يُعيد فتح النافذة في وضع التَعديل، **حذف** (سلَّة) يَفتح تأكيداً: *هل أنت متأكد من حذف "`{الاسم}`"؟ لا يمكن التراجع عن هذا الإجراء.*

  الإشعارات: *تم إنشاء موصل MCP*، *تم تحديث موصل MCP*، *تم حذف موصل MCP* عند النجاح. الفشل يُظهِر *تعذر حفظ موصل MCP*، *تعذر تحديث موصل MCP*، *تعذر حذف موصل MCP*.

  ### عندما لا يَستطيع السوق التَحميل

  إذا فَشِل تَحميل الكاتالوج، يَعرض القسم خطأً مُدمَجاً: **تعذر تحميل التكاملات** بالتَلميح *رفض الخادم الطلب. تحقق من اتصالك وحاول مرة أخرى*، بالإضافة إلى زر **إعادة المحاولة**.

  ## القسم 2: أدوات الوكيل

  أربع أدوات مُدمَجة يَستطيع وكيلك استدعاءها أثناء المحادثة. عنوان البطاقة يَقرأ **أدوات الوكيل** بالوصف *قدرات مدمجة يمكن لوكيلك استخدامها أثناء المحادثات.*

  كل أداة تَظهر كصف فيه أيقونة، اسم، وصف، ومفتاح على النهاية. المفتاح متوقف (الافتراضي للأربعة): الصف خافت. المفتاح مفعَّل: يأخذ الصف خلفية أساسية خفيفة ويَنفتح نموذج تَحته بإعدادات تلك الأداة.

  ### التَحويل لموظف

  الوصف: *تحويل المحادثات إلى موظف دعم مباشر عند الحاجة.*

  | الخيارات                                                                                                                                                                                                                                         | الإعداد                 |
  | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------- |
  | **بطلب العميل**، **بقرار الوكيل**، **كلاهما** (مجموعة حبَّات)                                                                                                                                                                                    | **مُشغِّل التَحويل**    |
  | **إشعار بريد إلكتروني**، **Webhook**، **رابط محادثة مباشرة**                                                                                                                                                                                     | **قناة التَوجيه**       |
  | يَتغيَّر اسمه حسب القناة: **بريد الإشعارات** (مثل `support@company.com`)، **رابط Webhook** (مثل `https://your-server.com/handoff`)، أو **رابط المحادثة المباشرة** (مثل `https://livechat.company.com`). يَنطبق التَحقُّق من HTTPS على الأخيرَين. | حقل الهدف               |
  | نص متَعدِّد الأسطر. حد أقصى 500 حرف. النص النائب الافتراضي: *فريقنا غير متاح حالياً. سنعود إليك في أقرب وقت ممكن.*                                                                                                                               | **رسالة عدم التَوفُّر** |

  ### حجز المواعيد

  الوصف: *جدولة الاجتماعات والمواعيد للعملاء.*

  | ملاحظات                                                                                                                         | الإعداد             |
  | ------------------------------------------------------------------------------------------------------------------------------- | ------------------- |
  | HTTPS مطلوب. التَلميح: *رابط صفحة جدولة المواعيد (Calendly أو Cal.com أو مخصص).* النص النائب: `https://calendly.com/your-name`. | **رابط صفحة الحجز** |
  | ثلاث مربعات اختيار: **15 دقيقة**، **30 دقيقة**، **60 دقيقة**. اختَر ما يَجب أن يَعرضه الوكيل.                                   | **مُدد الاجتماعات** |

  ### تتبُّع الطلبات

  الوصف: *البحث عن حالة الطلبات ومشاركتها مع العملاء.*

  | ملاحظات                                                                                                                                       | الإعداد                  |
  | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
  | HTTPS مطلوب. التَلميح: *نقطة وصول REST API للاستعلام عن حالة الطلبات.* النص النائب: `https://api.yourstore.com/v1/orders`. مَعروض بخط أُحادي. | **نقطة وصول API للبحث**  |
  | قائمة منسدلة بـ**GET** أو **POST**.                                                                                                           | **طريقة HTTP**           |
  | حقل كلمة سر مَخفي. النص النائب: `Bearer your-api-key`. الإكمال التلقائي معطَّل.                                                               | **قيمة ترويسة المصادقة** |
  | ثلاث مربعات اختيار: **رقم الطلب**، **البريد الإلكتروني**، **الهاتف**. سيَطلب الوكيل من العميل ما تُؤشِّر عليه.                                | **حقول البحث عن العميل** |

  ### تحصيل المدفوعات

  الوصف: *إرسال روابط الدفع ومعالجة المعاملات.*

  | ملاحظات                                                                                                            | الإعداد               |
  | ------------------------------------------------------------------------------------------------------------------ | --------------------- |
  | HTTPS مطلوب. التَلميح: *الرابط الأساسي لصفحة الدفع أو الخروج.* النص النائب: `https://checkout.stripe.com/pay/...`. | **رابط صفحة الدفع**   |
  | قائمة منسدلة للعملات بصيغة `USD - US Dollar` و `EUR - Euro` إلخ.                                                   | **العملة الافتراضية** |

  ## القسم 3: أدوات API مخصَّصة

  عَرِّف نقاط REST الخاصة بك التي يَستطيع الوكيل استدعاءها أثناء المحادثة. عنوان البطاقة يَقرأ **أدوات API مخصصة** بالوصف *عرّف نقاط REST API مخصصة يمكن لوكيلك استدعاؤها أثناء المحادثات.*

  عندما تَكون القائمة فارغة، تَرى أيقونة كود في المنتصف وسطراً **لم يتم إضافة أدوات مخصصة بعد.** أسفله، زر **+ إضافة أداة** بحدود متَقطِّعة.

  ### نموذج إضافة الأداة

  اضغط **+ إضافة أداة** لفتح النموذج المُدمَج:

  | ملاحظات                                                                                                                | الحقل                    |
  | ---------------------------------------------------------------------------------------------------------------------- | ------------------------ |
  | حد أقصى 50 حرفاً. النص النائب: `e.g. Check inventory`.                                                                 | **اسم الأداة**           |
  | قائمة منسدلة بـ**GET** و**POST** و**PUT** و**PATCH** و**DELETE**.                                                      | **الطريقة**              |
  | HTTPS مطلوب. النص النائب: `https://api.example.com/v1/resource`. رسالة الخطأ عند البطلان: *Must be a valid HTTPS URL.* | **رابط النقطة النهائية** |
  | حد أقصى 200 حرف. النص النائب: *Describe what this tool does...*                                                        | **الوصف**                |

  زرَّان في الأسفل: **إلغاء** (يَمسح النموذج) و **إضافة أداة** (الزر الأساسي، مُعطَّل حتى تَملأ الاسم ورابطاً HTTPS صالحاً).

  ### قائمة الأدوات

  كل أداة محفوظة تَظهر كصف فيه طريقة HTTP في حبَّة أُحادية صغيرة، اسم الأداة بخط عريض، الرابط أسفله، ووصف اختياري أسفل ذلك. أيقونة سلَّة على النهاية تُزيلها بعد تأكيد: **حذف الأداة المخصصة**، *هل أنت متأكد من إزالة "`{الاسم}`"؟ لا يمكن التراجع عن هذا الإجراء.*

  | القيمة          | الحد                          |
  | --------------- | ----------------------------- |
  | **10** لكل وكيل | الحد الأقصى للأدوات المخصَّصة |

  عند الوصول إلى 10 أدوات، يُستبدَل زر **+ إضافة أداة** بسطر *الحد الأقصى 10 أدوات مخصصة.*

  ## القسم 4: Webhooks والأحداث

  إشعارات الوكيل الصادرة. عنوان البطاقة يَقرأ **Webhooks والأحداث** بالوصف *إرسال إشعارات HTTP POST لحظية عند وقوع الأحداث في وكيلك.*

  خمسة صفوف أحداث، كل صف بأيقونته وتَسميته ومفتاحه:

  | متى يَنطلق                      | الأيقونة          | الحدث                 |
  | ------------------------------- | ----------------- | --------------------- |
  | يُرسِل العميل أول رسالة         | فقاعة كلام        | **بدء المحادثة**      |
  | يَنهي الوكيل أو العميل المحادثة | علامة صح في دائرة | **انتهاء المحادثة**   |
  | تَنطلق أداة التَحويل لموظف      | أسهم يَسار/يَمين  | **طلب تحويل لموظف**   |
  | يَنهي الوكيل نموذج جمع بيانات   | علامة + مع مستخدم | **التقاط عميل محتمل** |
  | يَفتح الوكيل تذكرة دعم          | مستند             | **إنشاء تذكرة**       |

  عند تَفعيل المفتاح، يَظهر إدخال **رابط Webhook** أسفله. النص النائب: `https://your-server.com/webhook`. HTTPS مطلوب. رسالة الخطأ عند البطلان: *Must be a valid HTTPS URL.*

  الأحداث مستقلة، فَعِّل ما تَحتاجه.

  ## كيف يَعمل الحفظ في هذه الخطوة

  | متى يَتم الحفظ                                      | نوع الإعداد              |
  | --------------------------------------------------- | ------------------------ |
  | فوراً عند العودة / الإرسال                          | سوق OAuth / مفتاح API    |
  | فوراً عند تأكيد الحوار                              | فصل تَكامل من السوق      |
  | فوراً، مع إشعار عند النجاح أو الفشل                 | إنشاء / تَعديل / حذف MCP |
  | عند الضغط على **حفظ مسوَّدة** أو **الخطوة التالية** | حقول أدوات الوكيل        |
  | نفس أدوات الوكيل                                    | أدوات API مخصَّصة        |
  | نفس أدوات الوكيل                                    | Webhooks والأحداث        |

  إذا كان رابط Webhook أو رابط أداة وكيل غير صالح (يَجب أن يَبدأ بـ`https://`)، يُسمَح بالحفظ لكن الوكيل لن يَستطيع تَنفيذ ذلك الـwebhook حتى تُصلِحه. النص الأحمر للخطأ تحت الحقل هو تَلميحك.

  ## أسئلة شائعة

  <AccordionGroup>
    <Accordion title="السوق فارغ عند فتحي للمعالج لوكيل جديد.">
      يَظهر السوق الكامل بعد حفظ المعالج لأول مرة. اضغط **حفظ مسوَّدة** على أول خطوة معالج (أو اضغط **التالي**) لفتحه.
    </Accordion>

    <Accordion title="OAuth فَتَحَ نافذة منبثقة، ثم أُغلِقَت بدون اتصال.">
      سببان شائعان: (1) النافذة المنبثقة مَحجوبة، اِبحَث عن إشعار أو راجع إعدادات النوافذ المنبثقة في متصفِّحك. (2) رَفَضت صفحة تَفويض المَزوِّد الطلب، حاول مرة أخرى من بطاقة السوق.
    </Accordion>

    <Accordion title="زر إضافة أداة API مخصَّصة باهت.">
      يَبقى الزر معطَّلاً حتى يَكون لديك **اسم أداة** غير فارغ ورابط **رابط النقطة النهائية** HTTPS صالح. الوصف والطريقة اختياريان ولهما قيم افتراضية.
    </Accordion>

    <Accordion title="أضفت webhook لكن خادمي لا يَستلِم شيئاً.">
      ثلاثة فحوصات: (1) مفتاح الحدث **مفعَّل**، (2) الرابط يَنجح في تَحقُّق HTTPS (لا نص خطأ أحمر)، (3) خادمك يَقبل فعلاً طلبات POST على ذلك المسار. Wittify يُعيد المحاولة عند فشل التَوصيل، لكن يَجب أن يَكون الرابط قابلاً للوصول أولاً. اختبره بـ`curl -X POST https://your-server.com/webhook` من الطرفية.
    </Accordion>

    <Accordion title="ما الفرق بين موصِّل MCP وأداة API مخصَّصة؟">
      MCP بروتوكول أغنى، يَكشف الموصِّل قائمة الأدوات المتاحة ويُقرِّر الوكيل أيها يَستدعي بناءً على سياق المحادثة. أدوات API المخصَّصة أبسط، تُعرِّف كل نقطة وصول بمفردها وتَكتب وصفاً يَخبر الوكيل متى يَستخدمها. استخدم MCP للأنظمة التي تَكشف قدرات متَعدِّدة (مثل CRM فيه قراءة/كتابة/بحث)، استخدم أدوات API المخصَّصة لنقاط وصول مفردة.
    </Accordion>

    <Accordion title="هل أستطيع حذف أداة وكيل مُدمَجة، مثل التَحويل لموظف؟">
      لا تَستطيع حذفها، لكن تَستطيع تَوقيفها. يَبقى النموذج تحت الصف متاحاً، لكن الوكيل لن يَستدعي الأداة أثناء تَوقيف المفتاح.
    </Accordion>

    <Accordion title="لماذا يَطلب الوكيل من العميل رقم طلب رغم أنني فَعَّلت البريد الإلكتروني تحت حقول البحث عن العميل؟">
      يَستخدم الوكيل أيا من الحقول المُؤشَّر عليها. عندما يَكون أكثر من حقل مفعَّلاً، يَختار بناءً على سياق المحادثة (مثلاً إذا قال العميل لا يَتذكر رقم الطلب، يَنتقل إلى البريد الإلكتروني). إذا كنت تُريد حقل بحث محدَّداً يُستخدَم دائماً، اِترك ذلك فقط مفعَّلاً.
    </Accordion>
  </AccordionGroup>

  ## التالي

  <Card title="الخطوة 7: النَشر" icon="rocket" href="/ar/Systems/AI-Agents/Wizard/Deployment">
    ضَمِّن وكيلك على موقعك، اربط القنوات الاجتماعية، أَوصِل خدمات الاتصال الهاتفي، اضبط النطاقات المسموح بها، فَعِّل وكيلك.
  </Card>
</div>