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

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

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

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

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

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

الكتالوج

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

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

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

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

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

• Slack — استقبال وإرسال الرسائل (Events API + chat.postMessage).
• الرسائل القصيرة — إرسال واستقبال الرسائل القصيرة عبر AllMySMS (الردود وإيصالات التسليم).

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

• حزمة GTM — HubSpot و Notion و Airtable و Brevo و Mailchimp و Calendly و Typeform و Shopify و Microsoft 365 و Monday.com.

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

• Google — Calendar و Sheets و Drive و Google Ads (التقارير، رفع التحويلات)، والتحقّق من العنوان البريدي.
• LinkedIn Ads — نشر حملات إعلانية شاملة من البداية إلى النهاية.

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

• Kavkom — جلب تسجيلات المكالمات من مقسّم سحابي (cloud PBX).

كيف يُستهلَك داخل 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 ومُسجَّلة.

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