# ربط التطبيقات الخارجية بوكلائك

Source: https://support.kapsulehost.com/ar-ae/agents-connections

## ما هي الاتصالات

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

هناك شيئان يستحقان الدقة:

- الاتصال يمنح الوصول إلى **هذا التطبيق** فقط، وليس إلى حسابك في KapsuleHost. لا يختلط مجموعا الأذونات أبداً.
- أي شيء **يغير** شيئاً ما في التطبيق المتصل لا يزال يمر عبر بطاقة التأكيد نفسها كما هو الحال مع التغيير على حسابك في KapsuleHost. القراءة فورية؛ الكتابة تطلب موافقة أولاً.

> **Note:** تقع الاتصالات في **Agents**، ثم **Manage Connections**، أو انتقل مباشرة إلى `/agents/connections`. تعرض صفحة Agents الرئيسية أيضاً بطاقة Connections مع بعض التطبيقات المثالية.

## أي خبراء يمكنهم استخدام أي تطبيقات

القائمة متحفظة عن قصد، وكل خبير يرى فقط التطبيقات التي تحتاجها وظيفته. بعضها محصور في أدوات القراءة فقط حتى عندما يمكن للتطبيق نفسه فعل المزيد:

| الخبير | التطبيقات الخارجية التي يمكنه الوصول إليها |
|---|---|
| Mara, Business Advisor | Stripe (قراءة فقط) |
| Thea, Creative Writer | Notion |
| Sef, SEO Consultant | GitHub (قراءة فقط) |
| Mila, Marketing Planner | Gmail, Slack, Notion, Google Calendar |
| Iris, Customer Comms | Gmail, Slack |
| Ash, Sales and Outreach | Gmail, Slack, Stripe (قراءة فقط) |
| Pip, Policy and Docs | بلا |

الاتصال بتطبيق لا يعطيه للفريق بأكمله. يصبح متاحاً فقط للخبراء في الصف أعلاه.

![كتالوج الاتصالات في Kapsule Agents](https://support.kapsulehost.com/help/screenshots/agents-connections.26935fcd.webp)

## الاتصال بتطبيق

1. افتح **Agents**، ثم **Manage Connections**.
2. استعرض الكلمات **الشائعة**، أو انتقل إلى **جميع التطبيقات**، أو اكتب في صندوق البحث. تعرض كل بطاقة اسم التطبيق وعدد الأدوات التي يكشفها.
3. انقر على **Connect** على التطبيق الذي تريده. يتغير الزر إلى **Opening...** بينما يتم تحضير نافذة تسجيل الدخول.
4. قم بتسجيل الدخول إلى التطبيق نفسه وافق على الوصول الذي يطلبه.
5. تعود إلى صفحة الاتصالات برسالة تأكيد **[التطبيق] متصل**.

بمجرد الاتصال، تعرض البطاقة شارة **متصل**، والعنوان الخاص بالحساب الذي قمت بتسجيل الدخول إليه، والوقت الذي تم استخدام الاتصال فيه آخر مرة، أو **لم يتم استخدامه بعد**.

## حالات الاتصال

| الحالة | ما تعنيه | ما يجب القيام به |
|---|---|---|
| متصل | يعمل. يمكن لخبرائك استخدامه. | لا شيء |
| معلق | تم بدء تسجيل الدخول لكن لم يتم إنهاؤه أبداً. | انقر على **Finish Connecting** |
| إعادة الاتصال مطلوبة | انتهت صلاحية الوصول أو تم سحبها من نهاية التطبيق. | انقر على **Reconnect** |

حالة **إعادة الاتصال مطلوبة** طبيعية بمرور الوقت: تنتهي معظم التطبيقات الوصول الذي تمنحه وفقاً لجدول زمني. إعادة الاتصال تعيده دون فقدان أي شيء.

## كيف يبقى آمناً

تذكر صفحة الاتصالات نموذج الأمان في ثلاثة أسطر، وتستحق الفهم بدلاً من المسح السريع:

- **التعامل به من قبل شريك معتمد.** يتم التعامل مع تسجيل الدخول إلى التطبيق من قبل شريك التكامل المعتمد لدينا، الذي يحتفظ بالمنحة. كلمة مرورك في التطبيق لا تلمس KapsuleHost أبداً.
- **تأكيد قبل الإجراء.** يسأل Agents قبل التصرف. أي شيء يغير شيئاً ما يحتاج إلى موافقتك أولاً.
- **إلغاء فوري.** قطع الاتصالات يقطع الوصول فوراً، هنا وفي التطبيق.

> **Warning:** تعامل مع الاتصال مثل المفتاح الذي قطعته لشخص ما. اتصل بالحسابات التي تريد أن يعمل خبراؤك فيها، وليس كل حساب تمتلكه. إذا لم تكن متأكداً مما إذا كان الخبير يحتاج إلى تطبيق للقيام بالعمل الذي تضعه في الاعتبار، فلا تتصل به: اسأل أولاً، ثم اتصل.

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

1. افتح **Agents**، ثم **Manage Connections**.
2. انقر على **Disconnect** على التطبيق المتصل.
3. يظهر تأكيد: *فريقك يفقد الوصول إلى [التطبيق] على الفور. كل شيء استخدمته بالفعل يبقى في محادثاتك السابقة.*
4. انقر على **Disconnect** للتأكيد.

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

## عندما لا تكون الاتصالات متاحة على حسابك

إذا كانت صفحة الاتصالات تعرض بطاقة هادئة واحدة تقرأ **الاتصالات غير متاحة حالياً**، فلم يتم تفعيل الاتصال بالتطبيقات الخارجية على حسابك. البطاقة صريحة في أن لا شيء متصل وليس لأي شيء وصول، وهذا بالضبط الحقيقة في تلك الحالة. خبراؤك لا يزالون يعملون؛ هم فقط لا يستطيعون الوصول إلى خارج KapsuleHost.

بقية Agents لا تتأثر. الدردشات و[المهارات](https://support.kapsulehost.com/ar-ae/agents-skills) وقراءات الحساب تعمل جميعها بشكل طبيعي.

## ماذا إذا فشل

**"لم يتم منح الإذن، لذا لم يتم الاتصال بأي شيء."** لقد ألغيت أو رفضت في شاشة الموافقة الخاصة بالتطبيق نفسه. لم يتم إنشاء أي شيء. انقر على **Connect** مرة أخرى وافق على الوصول.

**"الاتصالات غير متاحة الآن. حاول مرة أخرى في لحظة."** لا يمكن الوصول إلى خدمة التكامل. هذا مقصود أن يكون مغلقاً بشكل فاشل: بدلاً من عرض قائمة نصف مبنية، تعرض الصفحة لا شيء. انتظر دقيقة واحدة وأعد التحميل.

**"لم يتمكن من تحميل الاتصالات."** إعداداتك آمنة. أعد تحميل الصفحة. إذا استمر الأمر، [افتح تذكرة دعم](https://support.kapsulehost.com/ar-ae/opening-a-support-ticket).

**يقول الخبير أنه لا يمكنه الوصول إلى تطبيق متصل.** تحقق من الجدول أعلاه. لا يُسمح لكل خبير باستخدام كل تطبيق، والتطبيق المتصل بـ Iris ليس متاحاً تلقائياً لـ Mara.

**الاتصال معلق.** تم إغلاق نافذة تسجيل الدخول قبل انتهائها. انقر على **Finish Connecting** وأكمله.

## تكلفة الاتصالات

استخدام تطبيق متصل في محادثة يتم قياسه مثل أي عمل آخر. كل نداء يقدمه الخبير إلى تطبيق خارجي يتم فرض رسوم عليه بوزن نداء الاتصال، وهو جزء من تكلفة كتابة نص طويل. تبقى القراءات على حسابك في KapsuleHost مجانية. الترجيح الكامل في [كيف تعمل رصيد Agents](https://support.kapsulehost.com/ar-ae/agents-credits).

## المراجع

- [نظرة عامة على وكلاء Kapsule](https://support.kapsulehost.com/ar-ae/agents-overview)
- [البدء مع وكلاء Kapsule](https://support.kapsulehost.com/ar-ae/agents-getting-started)
- [استخدام مهارات الوكيل](https://support.kapsulehost.com/ar-ae/agents-skills)