الوثائق

نظرة عامة على التكاملات

اربط أدوات عملك (Stripe، الخدمات المصرفية، Jira، Slack، الرسائل القصيرة، Google، HubSpot، Meta، HeyGen…) بنمط BYO للقراءة منها والتصرّف عليها من داخل pipeline.

يربط التكامل أداة عمل خارجية بـ pipelines الخاصة بك: إمّا لـ قراءة البيانات (الإيرادات، نشاط الفريق، التقويم) أو لـ التصرّف (نشر حملة، إنشاء حدث، جلب تسجيل مكالمة).

بخلاف القناة التي تُطلِق pipeline، يُستهلَك التكامل داخل pipeline — عبر node مخصّص أو عبر أداة تُتاح لأحد وكلاء agent.

نموذج «BYO» (Bring Your Own)

جميع التكاملات هي BYO: أنت من يوفّر بيانات الاعتماد الخاصة بك (مفتاح API، رمز token، حساب OAuth) في لوحة الإدارة، ضمن الإعدادات ← الخدمات ← الخدمة المعنيّة ← تبويب الحسابات. لا تتدخّل betool أبداً بينك وبين المزوّد، ولا تخزّن أيّ سرّ بنصّ صريح على جانب العميل، ولا تفرض أيّ هامش على هذه الاستدعاءات — فأنت تدفع للمزوّد مباشرةً.

تقدّم بعض التكاملات ربطاً مُداراً («تسجيل الدخول عبر…» من خلال تطبيق المنصّة) إضافةً إلى بيانات اعتمادك الخاصة، ويقدّم بعضها بديلاً احتياطياً مشتركاً على مستوى المورّد: إن لم تكن مؤسستك قد أعدّت حسابها الخاص، يمكن لـ betool توجيه الاستدعاء عبر حساب مُجمَّع (بترتيب الحلّ حسابك > الحساب المشترك). راجع صفحة كل تكامل.

الكتالوج

المالية والدفع

  • Stripe — اقرأ إيراداتك و MRR والاشتراكات؛ وأنشئ روابط دفع.
  • Enable Banking — الخدمات المصرفية المفتوحة (PSD2/AIS): اقرأ الحسابات والمعاملات، ولقطة خزينة لكل عملة.

التطوير والإنتاج

  • GitHub — تقرير إنتاجية الفريق لكل مطوّر، وحالة CI.
  • Jira — قراءة وكتابة التذاكر (Cloud أو Server/Data Center).

التواصل والمراسلة

  • Slack — استقبال وإرسال الرسائل (Events API + chat.postMessage).
  • الرسائل القصيرة — إرسال واستقبال الرسائل القصيرة عبر AllMySMS (الردود وإيصالات التسليم)، أو عبر Brevo.
  • Meta — Messenger، والنشر على صفحة Facebook، وتقارير Meta Ads وإدارتها.

CRM والتسويق والإنتاجية

  • حزمة GTM — HubSpot و Notion و Airtable و Brevo و Mailchimp و Calendly و Typeform و Shopify و Microsoft 365 و Monday.com.
  • CRM متخصّص — beTool Application؛ Qhare (Beta).

الإنتاجية والإعلان

  • Google — Calendar و Sheets و Drive و Google Ads و Analytics 4 و Search Console و Business Profile (المنشورات والمراجعات)، والتحقّق من العنوان البريدي.
  • LinkedIn Ads — نشر حملات إعلانية شاملة من البداية إلى النهاية (الربط غير متاح بعد للمؤسسات العميلة).

الفيديو

  • HeyGen — فيديوهات بأفاتار، ودبلجة مع مزامنة الشفاه، و Video Agent، واستنساخ الصوت.

الاتصالات الهاتفية

  • Kavkom — جلب تسجيلات المكالمات من مقسّم سحابي (cloud PBX).
  • Onoff Business — مكالمات الفريق ورسائله القصيرة، للقراءة فقط (Beta).

البريد والميدان والأجهزة المتّصلة

  • La Poste — تتبّع الإرساليات؛ الرسالة المسجّلة عبر الإنترنت (Beta).
  • Mitti — عمليات الفحص الميداني، والتقارير، والإجراءات التصحيحية.
  • Smart Life / Tuya — حالة الأجهزة المتّصلة والتحكّم فيها.

منتجات beTool

كيف يُستهلَك داخل pipeline

صيغتان، بحسب التكامل:

  1. node مخصّص — يوضَع في pipeline، فيستدعي المزوّد وينشر النتيجة في السياق (مثل stripe_report و github_report و jira_report و enablebanking_report و slack_outbound و linkedin_ads_publish). تستهلك الـ nodes اللاحقة المُخرَج كأيّ بيانات أخرى. الـ nodes التي تتصرّف نحو الخارج (إرسال، إنشاء، نشر) هي exactly-once: لا تكرار عند إعادة المحاولة.
  2. أداة agent — تُتاح لأحد nodes الوكيل agent الذي يقرّر متى يستدعيها (مثل google.calendar_list_events و jira.create_issue و slack.post_message و stripe.create_payment_link). راجع إجراءات بلا كود.

الأمان

  • تُخزَّن الأسرار على جانب الخادم ولا تُكشَف أبداً في استجابة GET (الواجهة الأمامية لا ترى سوى مؤشّر «المفتاح مُعَدّ»).
  • كل استدعاء محصور بنطاق مؤسستك: لا يظهر تكامل مؤسسة لأخرى ولا يمكن لأخرى استخدامه.
  • الاستدعاءات الصادرة محميّة ضد SSRF ومُسجَّلة.

راجع الأمان ← المبادئ.