پایگاه دانش GetMyBot

یکپارچه‌سازی‌ها

اتصال سرویس‌های خارجی: هوش مصنوعی، Google Sheets، Google Drive، GetCourse، webhook.

در این صفحه

یکپارچه‌سازی‌ها بات را به سرویس‌های خارجی متصل می‌کنند. هر یکپارچه‌سازی یک پیکربندی ذخیره‌شده (با اسرار رمزنگاری‌شده) است که سپس توسط اقدامات واکنش‌ها استفاده می‌شود. بخش — یکپارچه‌سازی‌ها در منوی سمت چپ؛ دکمه افزودن یکپارچه‌سازی، کلید اتصال و دکمه پیکربندی در هر کارت.

سرویس‌های در دسترس

  • هوش مصنوعی — مدل زبانی (API سازگار با OpenAI). ببینید پاسخ‌های هوش مصنوعی.
  • Google Sheets — افزودن ردیف به جدول.
  • Google Drive — آپلود فایل‌ها به پوشه.
  • GetCourse — ارسال کاربران و معاملات به GetCourse.
  • Webhook — ارسال جهانی داده‌ها از طریق HTTP به هر سرویس.
  • پردازشگر خارجی — اتصال بک‌اند خودتان از طریق WebSocket: واکنش توسط سرور شما پردازش می‌شود. ببینید پردازشگر خارجی.

پیکربندی

هنگام افزودن سرویس انتخاب می‌شود، نام و فیلدهای پیکربندی وابسته به نوع مشخص می‌شوند:

Webhook

  • URL وبهوک — آدرس گیرنده.
  • امضای HMAC (راز) — برای تأیید اصالت؛ درخواست با هدر X-Signature: sha256=... امضا می‌شود.

GetCourse

  • حساب و کلید مخفی.
  • شیء — «کاربران» یا «معاملات».

Google Sheets

  • شناسه جدول و محدوده.
  • JSON حساب سرویس (راز) — کلید Google service account.

Google Drive

  • شناسه پوشه.
  • JSON حساب سرویس (راز).

هوش مصنوعی

پردازشگر خارجی

یکپارچه‌سازی WebSocket: سرور شما به GetMyBot متصل می‌شود و واکنش‌ها را با پاسخ دادن به دستورات در قالب Telegram Bot API پردازش می‌کند.

  • آدرس WebSocket — سرویس شما از طریق آن متصل می‌شود.
  • توکن اتصال (راز) — یک بار هنگام ایجاد نمایش داده می‌شود؛ دکمه صدور مجدد وجود دارد.

جزئیات، پروتکل و نمونه‌های سرویس — پردازشگر خارجی.

استفاده در واکنش‌ها

  • هوش مصنوعی و Webhook فوراً به عنوان اقدامات/کانال‌ها در دسترس هستند: اقدام هوش مصنوعی را اضافه کنید یا داده‌ها را با اقدام درخواست وب به آدرس webhook ارسال کنید.
  • اقدامات GetCourse، Google Sheets، Google Drive در سازنده واکنش‌ها به عنوان «به زودی» علامت‌گذاری شده‌اند — خود یکپارچه‌سازی‌ها هم‌اکنون قابل پیکربندی هستند.

امنیت

همه درخواست‌های خروجی از حفاظت SSRF عبور می‌کنند (دسترسی به شبکه داخلی ممنوع است)، و پاسخ به اندازه محدود شده است. اسرار یکپارچه‌سازی‌ها به صورت رمزنگاری‌شده ذخیره می‌شوند.

مرحله بعد