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

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

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

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

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

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

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

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

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

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

اضغط أي بطاقة بوَسم مفتاح API. تَفتح نافذة بعنوان ربط {اسم التطبيق} والوصف أدخل بيانات الاعتماد لربط هذا التكامل.أسفل النموذج، ملاحظة أمنية: يتم إرسال بيانات الاعتماد مباشرة إلى Composio عبر HTTPS وتخزينها في الخادم، وليس في متصفحك. زر الاتصال مُعطَّل حتى تَملأ كلا الحقلَين.زر الإرسال يَقرأ ربط. يَتغيَّر إلى جارٍ الاتصال… مع دوَّامة أثناء التَنفيذ. عند النجاح، يَقرأ الإشعار تم ربط التكامل وتُغلَق النافذة. عند الفشل: تعذر ربط التكامل، تَبقى النافذة مفتوحة لتَستطيع تَصحيح بيانات الاعتماد.

​
قطع الاتصال

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

إشعارات الوكيل الصادرة. عنوان البطاقة يَقرأ Webhooks والأحداث بالوصف إرسال إشعارات HTTP POST لحظية عند وقوع الأحداث في وكيلك.خمسة صفوف أحداث، كل صف بأيقونته وتَسميته ومفتاحه:عند تَفعيل المفتاح، يَظهر إدخال رابط Webhook أسفله. النص النائب: https://your-server.com/webhook. HTTPS مطلوب. رسالة الخطأ عند البطلان: Must be a valid HTTPS URL.الأحداث مستقلة، فَعِّل ما تَحتاجه.

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

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

​
أسئلة شائعة

يَظهر السوق الكامل بعد حفظ المعالج لأول مرة. اضغط حفظ مسوَّدة على أول خطوة معالج (أو اضغط التالي) لفتحه.
سببان شائعان: (1) النافذة المنبثقة مَحجوبة، اِبحَث عن إشعار أو راجع إعدادات النوافذ المنبثقة في متصفِّحك. (2) رَفَضت صفحة تَفويض المَزوِّد الطلب، حاول مرة أخرى من بطاقة السوق.
يَبقى الزر معطَّلاً حتى يَكون لديك اسم أداة غير فارغ ورابط رابط النقطة النهائية HTTPS صالح. الوصف والطريقة اختياريان ولهما قيم افتراضية.
ثلاثة فحوصات: (1) مفتاح الحدث مفعَّل، (2) الرابط يَنجح في تَحقُّق HTTPS (لا نص خطأ أحمر)، (3) خادمك يَقبل فعلاً طلبات POST على ذلك المسار. Wittify يُعيد المحاولة عند فشل التَوصيل، لكن يَجب أن يَكون الرابط قابلاً للوصول أولاً. اختبره بـcurl -X POST https://your-server.com/webhook من الطرفية.
MCP بروتوكول أغنى، يَكشف الموصِّل قائمة الأدوات المتاحة ويُقرِّر الوكيل أيها يَستدعي بناءً على سياق المحادثة. أدوات API المخصَّصة أبسط، تُعرِّف كل نقطة وصول بمفردها وتَكتب وصفاً يَخبر الوكيل متى يَستخدمها. استخدم MCP للأنظمة التي تَكشف قدرات متَعدِّدة (مثل CRM فيه قراءة/كتابة/بحث)، استخدم أدوات API المخصَّصة لنقاط وصول مفردة.
لا تَستطيع حذفها، لكن تَستطيع تَوقيفها. يَبقى النموذج تحت الصف متاحاً، لكن الوكيل لن يَستدعي الأداة أثناء تَوقيف المفتاح.
يَستخدم الوكيل أيا من الحقول المُؤشَّر عليها. عندما يَكون أكثر من حقل مفعَّلاً، يَختار بناءً على سياق المحادثة (مثلاً إذا قال العميل لا يَتذكر رقم الطلب، يَنتقل إلى البريد الإلكتروني). إذا كنت تُريد حقل بحث محدَّداً يُستخدَم دائماً، اِترك ذلك فقط مفعَّلاً.

​
التالي

الخطوة 7: النَشر

ضَمِّن وكيلك على موقعك، اربط القنوات الاجتماعية، أَوصِل خدمات الاتصال الهاتفي، اضبط النطاقات المسموح بها، فَعِّل وكيلك.