الوصول إلى API و MCP

الوصول إلى API و MCP

يتضمن Metricgram واجهة API عامة وخادم MCP لربط أدواتك ولوحاتك وأتمتتك أو عملاء AI بالبيانات والعمليات المتاحة في حسابك.

خادم MCP متاح في جميع الخطط المدفوعة وأثناء التجربة المجانية لمدة 14 يوما. يمكن لعملاء الذكاء الاصطناعي الاتصال عبر OAuth (الصق عنوان URL للخادم ووافق على الوصول) أو باستخدام رمز API. أما REST API فتتطلب وصول Elite. إذا لم تتضمن خطتك هذه الميزة، قد يظهر قسم API مقفلا أو يعرض رسالة ترقية.

أين تجده؟

افتح التكاملات > MCP أو التكاملات > API في لوحة المدير. من هناك يمكنك إنشاء رموز API، ومراجعة الرموز النشطة، وإلغاء الرموز، وقراءة المرجع التقني.

كيف تعمل الرموز؟

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

واجهة Telegram Bot API عبر MCP

يوفر خادم MCP أيضًا واجهة Telegram Bot API مقيّدة بمجموعاتك، ليتمكن وكلاء الذكاء الاصطناعي من التصرف في مجموعاتك عبر بوت Metricgram أو البوت المخصص الخاص بك.

• استخدم telegram_api_methods لعرض الدوال التي يستطيع رمزك استدعاءها، وtelegram_bot_api لاستدعاء أي منها بمعاملات Bot API الرسمية.
• تغطي الأدوات محددة النوع العمل اليومي: send_telegram_message وsend_telegram_media وsend_telegram_poll وpin_telegram_message وmanage_forum_topic وcreate_telegram_invite_link وغيرها.
• الدردشة دائمًا إحدى مجموعاتك أنت. لا تمرر chat_id أبدًا، إذ يستنتجه Metricgram من group_id.
• لإجراءات Telegram صلاحيات خاصة بها: telegram:read وtelegram:write وtelegram:moderate وtelegram:admin. يجب إعادة إنشاء الرموز التي أُنشئت قبل إضافة هذه الصلاحيات لاستخدامها.
• يجب أن تكون الوسائط رابط HTTPS عامًا أو قيمة file_id من Telegram، ولا يمكن للأزرار المضمنة إلا فتح روابط أو نسخ نص.
• تقبل أدوات الكتابة قيمة idempotency_key اختيارية، حتى لا تُنفَّذ إعادة المحاولة مرتين.

المصادقة والحدود

تستخدم طلبات API ترويسة Authorization: Bearer mg_.... الحد الافتراضي هو 600 طلب في الدقيقة لكل رمز، ويمكن ضبطه ضمن الحدود المسموحة.

ممارسات جيدة

• أنشئ رمزا منفصلا لكل أداة خارجية.
• استخدم أسماء واضحة لتعرف أين يستخدم كل رمز.
• ألغ الرموز التي لم تعد تحتاجها.
• لا تشارك الرموز في المحادثات أو الصور أو المستودعات العامة.