التكاملات

تربط التكاملات البوت بالخدمات الخارجية. كل تكامل هو إعداد محفوظ (بأسرار مشفّرة) تستخدمه إجراءات التفاعلات لاحقاً. القسم — التكاملات في القائمة اليسرى؛ زر إضافة تكامل ومفتاح التوصيل وزر إعداد على كل بطاقة.

الخدمات المتاحة

  • ذكاء اصطناعي — نموذج لغوي (API متوافق مع OpenAI). انظر ردود الذكاء الاصطناعي.
  • Google Sheets — إضافة صفوف إلى جدول بيانات.
  • Google Drive — رفع الملفات إلى مجلد.
  • GetCourse — إرسال المستخدمين والصفقات إلى GetCourse.
  • Webhook — إرسال البيانات عبر HTTP إلى أي خدمة.
  • معالج خارجي — توصيل الخادم الخاص بك عبر WebSocket: يعالج خادمك التفاعل. انظر المعالج الخارجي.

الإعداد

عند الإضافة يُختار الخدمة ويُحدَّد الاسم وحقول الإعداد التي تعتمد على النوع:

Webhook

  • URL الـwebhook — عنوان المستقبِل.
  • توقيع HMAC (السر) — للتحقق من صحة الطلب؛ يُوقَّع الطلب بالترويسة X-Signature: sha256=....

GetCourse

  • الحساب والمفتاح السري.
  • الكائن — «المستخدمون» أو «الصفقات».

Google Sheets

  • معرّف الجدول والنطاق.
  • JSON حساب الخدمة (السر) — مفتاح Google service account.

Google Drive

  • معرّف المجلد.
  • JSON حساب الخدمة (السر).

ذكاء اصطناعي

المعالج الخارجي

تكامل WebSocket: يتصل خادمك بـGetMyBot ويعالج التفاعلات مُجيباً بأوامر بصيغة Telegram Bot API.

  • عنوان WebSocket — يتصل به خدمتك.
  • رمز التوصيل (السر) — يظهر مرة واحدة عند الإنشاء؛ يتوفر زر لإعادة الإصدار.

التفاصيل والبروتوكول والأمثلة — المعالج الخارجي.

الاستخدام في التفاعلات

  • الذكاء الاصطناعي وWebhook متاحان كإجراءات/قنوات مباشرةً: أضف إجراء ذكاء اصطناعي أو أرسل البيانات بإجراء طلب ويب إلى عنوان الـwebhook.
  • إجراءات GetCourse وGoogle جداول البيانات وGoogle درايف في محرر التفاعلات مصنّفة كـ«قريباً» — يمكن إعداد التكاملات نفسها الآن.

الأمان

تمر جميع الطلبات الصادرة عبر حماية SSRF (محظور الوصول إلى الشبكة الداخلية)، والرد محدود الحجم. تُحفظ أسرار التكاملات مشفّرةً.

الخطوات التالية