يتيح GramClaw محرك تيليجرام نفسه بطريقتين: واجهة REST API للأتمتة المخصّصة، وخادم MCP (Model Context Protocol) بعيد لوكلاء الذكاء الاصطناعي. كلاهما يستوثق بمفتاح API تنشئه في الإعدادات، وكلاهما يحترم تنظيم الإيقاع نفسه لكل حساب الذي يحافظ على صحة حسابات تيليجرام لديك، وكلاهما يتطلب اشتراكًا نشطًا أو فترة تجريبية.
عمليًا: واجهة REST API للشيفرة — زامن جهات الاتصال من منتجك، وأطلق حملة عند تسجيل مستخدم، وضخّ المحادثات إلى مستودع بياناتك. أما خادم MCP فللوكلاء — يحصل Claude Desktop أو Claude Code أو Cursor أو وكيلك الخاص على أدوات لعرض الدردشات، وقراءة الرسائل، وإرسال الردود، وتشغيل البث الجماعي، وإدارة مسار المبيعات، دون كتابة أي شيفرة.
أنشئ مفتاح API
- 1
افتح الإعدادات ← مفاتيح API
أنشئ مفتاحًا واختر نطاقاته — القراءة لعرض البيانات وقراءتها، والإرسال لكل ما يكتب أو يراسل. قيّد المفاتيح بالحد الأدنى الذي تحتاجه.
- 2
انسخه مرة واحدة
يظهر المفتاح الكامل (gc_live_…) عند الإنشاء فقط — فاحفظه في مدير أسرار. وإذا تسرّب، احذفه من الإعدادات فيتوقف عن العمل فورًا.
- 3
استوثق
لواجهة REST: أرسله في ترويسة Authorization: Bearer. ولخادم MCP: ضعه في عنوان الخادم كمعامل key.
واجهة REST API في دقيقة واحدة
تغطي واجهة API سطح المنصة: الحسابات، والدردشات، والرسائل، وجهات الاتصال، والحملات، والبث الجماعي، وأعمدة مسار المبيعات، والتحليلات. الطلبات بصيغة JSON عادية عبر HTTPS. التوثيق الكامل لنقاط النهاية — كل مسار، ونطاقاته، وأمثلة الطلب والاستجابة — موجود على صفحة توثيق API، وتتوفر مواصفة OpenAPI قابلة للقراءة آليًا على /openapi.json لتوليد الشيفرة أو لتسليمها إلى نموذج ذكاء اصطناعي.
اربط خادم MCP
- 1
انسخ عنوان الخادم
https://gramclaw.com/api/mcp?key=gc_live_… — المفتاح يعرّفك ويفوّضك في آن واحد، مقيّدًا بالحسابات التي يجوز له التصرف عليها.
- 2
أضفه إلى عميل MCP الخاص بك
يقبل Claude Desktop و Claude Code و Cursor وأي عميل متوافق مع MCP عنوان خادم بعيد. لا تثبيت محلي، ولا وسيط.
- 3
اطلب عملًا حقيقيًا
بمجرد الاتصال، يستطيع وكيلك البحث في الدردشات، وصياغة الردود وإرسالها، وإطلاق الحملات، والتحقق من حالة الحملات، ونقل الصفقات عبر مسار المبيعات — وكل إرسال يخضع لتنظيم إيقاع الحسابات نفسه كسائر GramClaw.
ممارسات جيدة
- مفتاح واحد لكل تكامل، مسمّى وفق ذلك، حتى لا يعطّل إلغاءُ شيء واحد شيئًا آخر أبدًا.
- فضّل نطاقات القراءة فقط للوحات المتابعة ومهام التحليلات.
- بدّل المفاتيح عند مغادرة الزملاء واحذف المفاتيح التي لم تعد تستخدمها — الإلغاء فوري.
- تذكّر أن إرسالات API و MCP رسائل تيليجرام حقيقية من حساباتك الحقيقية: تنطبق عليها معايير الموافقة والحجم نفسها المتبعة في التطبيق.