التكاملات والاتصالات

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

تطبيقات المراسلة

‏Telegram وMAX — يمكن للوكيل أن يملك بوتًا مخصّصًا له (يرد فقط عنه، فورًا)، أو بوتًا مشتركًا عبر اتصال يوجّه الرسائل إلى الوكيل المناسب.

يحتوي Telegram أيضًا على المواضيع: يُشغّل الوكيل كل موضوع في مجموعة كمحادثة مستقلة خاصة به — انظر الوكلاء للتفاصيل.

خدماتك الخاصة

إذا لم توجد بطاقة جاهزة لخدمة تحتاجها، تغطي فئة “عامة” أي شيء آخر بثلاث طرق:

• خدمتك الخاصة (REST API) — العنوان الأساسي، طريقة تسجيل الدخول، سرّ، واختياريًا عنوان وصف OpenAPI. يستدعي الوكيل الخدمة بنفسه؛ لا يترك السرّ خادمك أبدًا.
• الأحداث الواردة (ويب-هوك) — يحصل الاتصال على عنوانه الخاص، مثل /api/hooks/<الرمز>، وموقّع اختياريًا بـ HMAC-SHA256. يتحول كل حدث وارد إلى رسالة يقرأها الوكيل ويمكنه التصرف بناءً عليها، تمامًا كرسالة في تطبيق مراسلة. حتى 120 حدثًا في الدقيقة لكل اتصال؛ لا يُنفَّذ أي شيء في محتوى الحدث كأمر أبدًا.
• خادم MCP — يضيف Neo الخادم إلى مجموعة أدوات الوكيل الخاصة، دون كشف الأسرار بشكل علني. يرى الوكيل الأدوات الجديدة بعد إعادة التشغيل.

عند تغيير اسم بطاقة في الكتالوج أو دمجها

في بعض الأحيان تحلّ بطاقة واحدة في الكتالوج محل بطاقات أقدم (مثل Bitrix24، الذي يقدّم خيارًا بين طريقتي اتصال — ويب-هوك أو تسجيل دخول وكلمة مرور). تنتقل الاتصالات التي أُنشِئت تحت البطاقة القديمة إلى الجديدة تلقائيًا، مع الاحتفاظ بقيمها؛ وتُخفى حقول الطريقة التي لم تختارها فقط، دون أن تكون مطلوبة.