البدء
ربط التطبيقات الخارجية بوكلائك
Connections let a Kapsule Agents expert work inside apps you already use, with your permission, and they are entirely separate from what an expert can do on your Kapsule account.
ما هي الاتصالات
الاتصال هو رابط موقّع بين أحد خبرائك وتطبيق خارجي واحد. بمجرد الاتصال، يمكن لهذا الخبير استخدام أدوات التطبيق في محادثة: قراءة مستند أو صياغة رسالة أو التحقق من سجل. بدون اتصال، لا يملك الخبير أي إمكانية وصول على الإطلاق.
هناك نقطتان تستحقان الدقة:
- يمنح الاتصال الوصول إلى هذا التطبيق، وليس إلى حسابك في Kapsule. لا تختلط مجموعتا الأذونات أبداً.
- أي شيء يغيّر شيئاً ما في التطبيق المتصل يمر عبر نفس بطاقة التأكيد التي تستخدم للتغييرات على حسابك في Kapsule. القراءة فورية، الكتابة تطلب موافقة أولاً.
تقع الاتصالات في 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 |
| Cora, Customer Comms | Gmail, Slack |
| Ash, Sales and Outreach | Gmail, Slack, Stripe (قراءة فقط) |
| Pip, Policy and Docs | لا شيء |
توصيل تطبيق لا يسلمه للفريق كله. يصبح متاحاً فقط للخبراء في الصف أعلاه.
توصيل تطبيق
- افتح Agents، ثم Manage Connections.
- استعرض علامة التبويب Popular، أو انتقل إلى All Apps، أو اكتب في صندوق البحث. تعرض كل بطاقة اسم التطبيق وعدد الأدوات التي يعرضها.
- انقر فوق Connect على التطبيق الذي تريده. يتغيير الزر إلى Opening... أثناء تحضير نافذة تسجيل الدخول.
- قم بتسجيل الدخول إلى التطبيق نفسه وافقد على الوصول الذي يطلبه.
- ستعود إلى صفحة Connections مع تأكيد [التطبيق] Connected.
بمجرد الاتصال، تعرض البطاقة شارة Connected، وتسمية الحساب الذي سجلت الدخول باستخدامه، ومتى تم استخدام الاتصال آخر مرة، أو Not used yet.
حالات الاتصال
| الحالة | ما تعنيه | ما الذي يجب فعله |
|---|---|---|
| Connected | يعمل بشكل صحيح. يمكن لخبرائك استخدامه. | لا شيء |
| Pending | تم بدء تسجيل الدخول لكن لم يتم إنهاؤه أبداً. | انقر فوق Finish Connecting |
| Reconnect Needed | انتهت صلاحية الوصول أو تم سحبها من جانب التطبيق. | انقر فوق Reconnect |
حالة Reconnect Needed طبيعية بمرور الوقت: معظم التطبيقات تنتهي صلاحية الوصول الذي تمنحه بناءً على جدول زمني. إعادة الاتصال تستعيده دون فقدان أي شيء.
كيفية الحفاظ على السلامة
تنص صفحة Connections على نموذج السلامة في ثلاث سطور، وتستحق الفهم بدلاً من مجرد المسح السريع:
- يتعامل بها شريك معتمد. يتم التعامل مع تسجيل الدخول إلى تطبيق من خلال شريك التكامل المعتمد لدينا، الذي يحمل المنحة. كلمة مرور التطبيق الخاصة بك لا تصل أبداً إلى Kapsule.
- تأكيد قبل الإجراء. يطلب Agents الموافقة قبل الإجراء. أي شيء يغيّر شيئاً ما يحتاج إلى موافقتك أولاً.
- إلغاء فوري. قطع الاتصال يقطع الوصول على الفور، هنا وأيضاً مع التطبيق.
تعامل مع الاتصال مثل مفتاح قمت بقطعه لشخص ما. وصّل الحسابات التي تريد أن يعمل فيها خبراؤك، وليس كل حساب تملكه. إذا لم تكن متأكداً ما إذا كان الخبير يحتاج إلى تطبيق للقيام بالمهمة التي تفكر فيها، فلا تقم بتوصيله: اسأل أولاً، ثم قم بالاتصال.
قطع اتصال تطبيق
- افتح Agents، ثم Manage Connections.
- انقر فوق Disconnect على التطبيق المتصل.
- تظهر رسالة تأكيد: يفقد فريقك الوصول إلى [التطبيق] على الفور. أي شيء استخدمه بالفعل يبقى في محادثاتك السابقة.
- انقر فوق Disconnect للتأكيد.
ينتهي الوصول فوراً. ما لا يفعله ذلك هو مسح محتوى التطبيق من المحادثات التي أجريتها بالفعل: إذا اقتبس خبير مستند إلى محادثة الأسبوع الماضي، فسيظل هذا النص موجوداً في نص المحادثة. قطع الاتصال يتعلق بالوصول المستقبلي، وليس بمحو بأثر رجعي.
عندما لا يكون الاتصال متاحاً على حسابك
إذا أظهرت صفحة Connections بطاقة واحدة هادئة تقرأ Connections Are Not Available Yet، فإن توصيل التطبيقات الخارجية لم يتم تفعيله على حسابك. البطاقة صريحة في أنه لا يوجد اتصال ولا وصول، وهذا هو بالضبط الحقيقة في هذه الحالة. خبراؤك لا يزالون يعملون؛ فقط لا يمكنهم الوصول خارج Kapsule.
بقية Agents لا تتأثر. المحادثات والمهارات وقراءات الحساب جميعها تعمل بشكل طبيعي.
ماذا لو فشل
"لم يتم منح الإذن، لذا لم يتم إنشاء اتصال." لقد ألغيت أو رفضت على شاشة موافقة التطبيق نفسه. لم يتم إنشاء أي شيء. انقر فوق Connect مرة أخرى وافقد على الوصول.
"الاتصالات غير متاحة الآن. حاول مرة أخرى في لحظة." لم يتمكن خدمة التكامل من الوصول. هذا متعمد بشكل آمن: بدلاً من عرض قائمة غير مكتملة، تعرض الصفحة لا شيء. انتظر دقيقة وأعد تحميل الصفحة.
"تعذر تحميل الاتصالات." إعداداتك آمنة. أعد تحميل الصفحة. إذا استمرت المشكلة، افتح تذكرة دعم.
يقول خبير إنه لا يمكنه الوصول إلى تطبيق متصل. تحقق من الجدول أعلاه. لا يُسمح لكل خبير بكل تطبيق، واتصال متصل بـ Cora غير متاح تلقائياً لـ Mara.
اتصال معلق في Pending. تم إغلاق نافذة تسجيل الدخول قبل اكتمالها. انقر فوق Finish Connecting وأكمله.
ما تكلفه الاتصالات
استخدام تطبيق متصل في محادثة يتم قياسه مثل أي وظيفة أخرى. كل مكالمة يقوم بها خبير إلى تطبيق خارجي يتم فرض رسوم عليها بوزن استدعاء الاتصال، وهو جزء صغير من تكلفة كتابة طويلة. تظل القراءات على حسابك في Kapsule مجانية. الوزن الكامل موجود في كيف تعمل اعتمادات Agent.