التَكاملات والأدوات هي الخطوة 6 (الهجين) أو الخطوة 5 (نصي / صوتي). الصفحة فيها أربعة أقسام: سوق التَكاملات، أدوات الوكيل، أدوات API مخصَّصة، Webhooks والأحداث. كل قسم مستقل، تَستطيع تَرك أي منها فارغاً إن لم تَحتجه. الخطوة اختيارية، تَستطيع التَقدُّم بدون اتصال أي شيء.
ماذا تفعل هذه الخطوة
هنا تُعطي الوكيل قدرات تَتجاوَز مجرَّد الإجابة على الأسئلة: إرسال رابط استرداد، البحث عن طلب، تَحويل المحادثة لموظف بشري، نَشر إشعار في Slack لحظة التقاط عميل محتمل. توجد أربع طرق لتَوصيل تلك القدرات، مرَتَّبة حسب مقدار الإعداد المطلوب:- السوق، نقرة واحدة على OAuth أو مفتاح API، بدون كود.
- أدوات الوكيل، أربع أدوات مُدمَجة (التَحويل لموظف، حجز المواعيد، تتبُّع الطلبات، تحصيل المدفوعات) تَضبطها عبر نموذج.
- أدوات API مخصَّصة، نقاط REST API يُعرِّفها المستخدم. الوكيل يَقرر متى يَستدعيها.
- Webhooks والأحداث، الوكيل يُرسِل إشعارات HTTP POST إلى خادمك عند حدوث الأحداث.
القسم 1: سوق التَكاملات
كاتالوج تَطبيقات يَعتمد على الخادم، مُجمَّع حسب الفئة. كل بطاقة تَعرض شعار التطبيق، الاسم، وصفاً من سطر واحد، حبَّة حالة الاتصال، ووَسم لون لطريقة المصادقة (OAuth بنفسجي، مفتاح API أزرق).شريط الإحصاءات والفلاتر
في أعلى بطاقة السوق، صف فيه ثلاث حبَّات إحصائية ومربع بحث:| ما تَعدّه | الحبَّة |
|---|---|
| إجمالي التَكاملات في الكاتالوج | متاح |
| كم اتصلت منها | مفعَّل |
| كم موصِّل Model Context Protocol أضفته | موصلات MCP |
- الكل، كل تَكامل في الكاتالوج (الافتراضي)
- المفعَّلة، فقط ما اتصلت به
- Native، تَكاملات بَناها Wittify (بدون جسر مصادقة)
- MCP، فقط موصِّلاتك من نوع MCP
الاتصال عبر OAuth
اضغط أي بطاقة بوَسم OAuth. يَقرأ الزر إعداد:- اضغط البطاقة. تَفتح نافذة منبثقة (تُفتَح بشكل مُتزامن مع النَقرة، فلا يَحجبها المتصفح).
- تأَذَّن على موقع المَزوِّد (Google، Slack، Calendly، إلخ).
- يُعيد المَزوِّد تَوجيهك إلى المعالج برَمز تأكيد في الرابط.
- يَتم تأكيد الاتصال على الخادم، يُنظَّف الرابط، ويُعاد تَحميل الكاتالوج بحبَّة خضراء مفعَّل على البطاقة.
الاتصال عبر مفتاح API
اضغط أي بطاقة بوَسم مفتاح API. تَفتح نافذة بعنوان ربط{اسم التطبيق} والوصف أدخل بيانات الاعتماد لربط هذا التكامل.| ملاحظات | الحقل |
|---|---|
| حقل كلمة سر مَخفي. النص النائب: الصق مفتاح API الخاص بك. الإكمال التلقائي معطَّل. | مفتاح API |
| يَظهر فقط حين يَحوي اسم التطبيق “Shopify”. التَلميح: النطاق الفرعي لمتجر Shopify (الجزء قبل .myshopify.com). النص النائب: my-store. | النطاق الفرعي للمتجر (Shopify فقط) |
قطع الاتصال
اضغط زر إعداد على بطاقة مُتَّصِلة لفتح لوحة الإعداد. تَعرض اللوحة متصل، آخر مزامنة منذ دقيقتين، ومُلخَّص الوصول المصرَّح به، بالإضافة إلى مُنتقي مُشغِّل:| متى يُنفَّذ التَكامل | المُشغِّل |
|---|---|
| بعد أن يَختم الوكيل المحادثة | انتهاء المحادثة (الافتراضي) |
| لحظة إنهاء الوكيل لنموذج جمع البيانات | التقاط عميل محتمل |
| كلما حَوَّل الوكيل لموظف بشري | طلب تحويل لموظف |
{الاسم}؟ لن يتمكن وكيلك من استخدام هذا التكامل بعد الآن. اضغط إلغاء للإبقاء، أو زر قطع الاتصال الأحمر للإزالة. يَقرأ إشعار النجاح تم فصل التكامل.بطاقة إضافة MCP
أسفل شبكة السوق، بطاقة “إضافة موصِّل MCP” بحدود متَقطِّعة تَدعك تُوصِل أي خدمة تَتحدَّث Model Context Protocol (طريقة قياسية تَكشف من خلالها الأدوات نفسها لوكلاء الذكاء الاصطناعي). اضغط البطاقة لفتح نافذة إضافة موصل MCP، بالوصف اتصل بأي نظام خارجي عبر بروتوكول سياق النموذج:| ملاحظات | الحقل |
|---|---|
| حد أقصى 100 حرف، يَظهر على البطاقة | الاسم (مطلوب) |
| يَجب أن يَكون HTTPS. رسالة الخطأ: Must be a valid HTTPS URL. | الرابط (مطلوب) |
| عَدد بالميلي ثانية. التَلميح: بالملي ثانية. اترك فارغاً للافتراضي (30,000 ملي ثانية). | المهلة |
| أزواج مفتاح/قيمة، حد أقصى 20. اضغط زوج مفتاح-قيمة جديد لإضافة صف. اضغط أيقونة سلَّة المهملات للإزالة. | الترويسات |
| نفس شكل الترويسات. | الاستعلام |
{الاسم}”؟ لا يمكن التراجع عن هذا الإجراء.الإشعارات: تم إنشاء موصل MCP، تم تحديث موصل MCP، تم حذف موصل MCP عند النجاح. الفشل يُظهِر تعذر حفظ موصل MCP، تعذر تحديث موصل MCP، تعذر حذف موصل MCP.عندما لا يَستطيع السوق التَحميل
إذا فَشِل تَحميل الكاتالوج، يَعرض القسم خطأً مُدمَجاً: تعذر تحميل التكاملات بالتَلميح رفض الخادم الطلب. تحقق من اتصالك وحاول مرة أخرى، بالإضافة إلى زر إعادة المحاولة.القسم 2: أدوات الوكيل
أربع أدوات مُدمَجة يَستطيع وكيلك استدعاءها أثناء المحادثة. عنوان البطاقة يَقرأ أدوات الوكيل بالوصف قدرات مدمجة يمكن لوكيلك استخدامها أثناء المحادثات.كل أداة تَظهر كصف فيه أيقونة، اسم، وصف، ومفتاح على النهاية. المفتاح متوقف (الافتراضي للأربعة): الصف خافت. المفتاح مفعَّل: يأخذ الصف خلفية أساسية خفيفة ويَنفتح نموذج تَحته بإعدادات تلك الأداة.التَحويل لموظف
الوصف: تحويل المحادثات إلى موظف دعم مباشر عند الحاجة.| الخيارات | الإعداد |
|---|---|
| بطلب العميل، بقرار الوكيل، كلاهما (مجموعة حبَّات) | مُشغِّل التَحويل |
| إشعار بريد إلكتروني، Webhook، رابط محادثة مباشرة | قناة التَوجيه |
يَتغيَّر اسمه حسب القناة: بريد الإشعارات (مثل [email protected])، رابط 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… | الوصف |
قائمة الأدوات
كل أداة محفوظة تَظهر كصف فيه طريقة HTTP في حبَّة أُحادية صغيرة، اسم الأداة بخط عريض، الرابط أسفله، ووصف اختياري أسفل ذلك. أيقونة سلَّة على النهاية تُزيلها بعد تأكيد: حذف الأداة المخصصة، هل أنت متأكد من إزالة “{الاسم}”؟ لا يمكن التراجع عن هذا الإجراء.| القيمة | الحد |
|---|---|
| 10 لكل وكيل | الحد الأقصى للأدوات المخصَّصة |
القسم 4: Webhooks والأحداث
إشعارات الوكيل الصادرة. عنوان البطاقة يَقرأ Webhooks والأحداث بالوصف إرسال إشعارات HTTP POST لحظية عند وقوع الأحداث في وكيلك.خمسة صفوف أحداث، كل صف بأيقونته وتَسميته ومفتاحه:| متى يَنطلق | الأيقونة | الحدث |
|---|---|---|
| يُرسِل العميل أول رسالة | فقاعة كلام | بدء المحادثة |
| يَنهي الوكيل أو العميل المحادثة | علامة صح في دائرة | انتهاء المحادثة |
| تَنطلق أداة التَحويل لموظف | أسهم يَسار/يَمين | طلب تحويل لموظف |
| يَنهي الوكيل نموذج جمع بيانات | علامة + مع مستخدم | التقاط عميل محتمل |
| يَفتح الوكيل تذكرة دعم | مستند | إنشاء تذكرة |
https://your-server.com/webhook. HTTPS مطلوب. رسالة الخطأ عند البطلان: Must be a valid HTTPS URL.الأحداث مستقلة، فَعِّل ما تَحتاجه.كيف يَعمل الحفظ في هذه الخطوة
| متى يَتم الحفظ | نوع الإعداد |
|---|---|
| فوراً عند العودة / الإرسال | سوق OAuth / مفتاح API |
| فوراً عند تأكيد الحوار | فصل تَكامل من السوق |
| فوراً، مع إشعار عند النجاح أو الفشل | إنشاء / تَعديل / حذف MCP |
| عند الضغط على حفظ مسوَّدة أو الخطوة التالية | حقول أدوات الوكيل |
| نفس أدوات الوكيل | أدوات API مخصَّصة |
| نفس أدوات الوكيل | Webhooks والأحداث |
https://)، يُسمَح بالحفظ لكن الوكيل لن يَستطيع تَنفيذ ذلك الـwebhook حتى تُصلِحه. النص الأحمر للخطأ تحت الحقل هو تَلميحك.أسئلة شائعة
السوق فارغ عند فتحي للمعالج لوكيل جديد.
السوق فارغ عند فتحي للمعالج لوكيل جديد.
يَظهر السوق الكامل بعد حفظ المعالج لأول مرة. اضغط حفظ مسوَّدة على أول خطوة معالج (أو اضغط التالي) لفتحه.
OAuth فَتَحَ نافذة منبثقة، ثم أُغلِقَت بدون اتصال.
OAuth فَتَحَ نافذة منبثقة، ثم أُغلِقَت بدون اتصال.
سببان شائعان: (1) النافذة المنبثقة مَحجوبة، اِبحَث عن إشعار أو راجع إعدادات النوافذ المنبثقة في متصفِّحك. (2) رَفَضت صفحة تَفويض المَزوِّد الطلب، حاول مرة أخرى من بطاقة السوق.
زر إضافة أداة API مخصَّصة باهت.
زر إضافة أداة API مخصَّصة باهت.
يَبقى الزر معطَّلاً حتى يَكون لديك اسم أداة غير فارغ ورابط رابط النقطة النهائية HTTPS صالح. الوصف والطريقة اختياريان ولهما قيم افتراضية.
أضفت webhook لكن خادمي لا يَستلِم شيئاً.
أضفت webhook لكن خادمي لا يَستلِم شيئاً.
ثلاثة فحوصات: (1) مفتاح الحدث مفعَّل، (2) الرابط يَنجح في تَحقُّق HTTPS (لا نص خطأ أحمر)، (3) خادمك يَقبل فعلاً طلبات POST على ذلك المسار. Wittify يُعيد المحاولة عند فشل التَوصيل، لكن يَجب أن يَكون الرابط قابلاً للوصول أولاً. اختبره بـ
curl -X POST https://your-server.com/webhook من الطرفية.ما الفرق بين موصِّل MCP وأداة API مخصَّصة؟
ما الفرق بين موصِّل MCP وأداة API مخصَّصة؟
MCP بروتوكول أغنى، يَكشف الموصِّل قائمة الأدوات المتاحة ويُقرِّر الوكيل أيها يَستدعي بناءً على سياق المحادثة. أدوات API المخصَّصة أبسط، تُعرِّف كل نقطة وصول بمفردها وتَكتب وصفاً يَخبر الوكيل متى يَستخدمها. استخدم MCP للأنظمة التي تَكشف قدرات متَعدِّدة (مثل CRM فيه قراءة/كتابة/بحث)، استخدم أدوات API المخصَّصة لنقاط وصول مفردة.
هل أستطيع حذف أداة وكيل مُدمَجة، مثل التَحويل لموظف؟
هل أستطيع حذف أداة وكيل مُدمَجة، مثل التَحويل لموظف؟
لا تَستطيع حذفها، لكن تَستطيع تَوقيفها. يَبقى النموذج تحت الصف متاحاً، لكن الوكيل لن يَستدعي الأداة أثناء تَوقيف المفتاح.
لماذا يَطلب الوكيل من العميل رقم طلب رغم أنني فَعَّلت البريد الإلكتروني تحت حقول البحث عن العميل؟
لماذا يَطلب الوكيل من العميل رقم طلب رغم أنني فَعَّلت البريد الإلكتروني تحت حقول البحث عن العميل؟
يَستخدم الوكيل أيا من الحقول المُؤشَّر عليها. عندما يَكون أكثر من حقل مفعَّلاً، يَختار بناءً على سياق المحادثة (مثلاً إذا قال العميل لا يَتذكر رقم الطلب، يَنتقل إلى البريد الإلكتروني). إذا كنت تُريد حقل بحث محدَّداً يُستخدَم دائماً، اِترك ذلك فقط مفعَّلاً.
التالي
الخطوة 7: النَشر
ضَمِّن وكيلك على موقعك، اربط القنوات الاجتماعية، أَوصِل خدمات الاتصال الهاتفي، اضبط النطاقات المسموح بها، فَعِّل وكيلك.