الوثائق

نظرة عامة على القنوات

كتالوج قنوات الإدخال المتاحة في betool، ومعايير اختيار القناة المناسبة، والبنية المشتركة بينها وحدودها.

الـقناة هي مصدر حدثٍ تعالجه pipeline. وكل قناة وحدة مستقلة: إضافة قناة بريد إلكتروني لا تؤثّر في قناة الهاتف.

الـقناة تُشغّل pipeline. أما قراءة البيانات أو التصرّف عبر أداة خارجية داخل pipeline (Stripe، GitHub، Google، LinkedIn، الهاتف)، فراجع التكاملات.

الكتالوج

الصوت في الوقت الفعلي

  • الهاتف — LiveKit + SIP، نسخ وتركيب صوتي بالبثّ، المقاطعة (barge-in)، التحويل. مكالمات واردة، ومكالمات صادرة يُطلقها pipeline.

الكتابة غير المتزامنة

  • البريد الإلكتروني — IMAP، تحليل المرفقات، سلاسل محفوظة.
  • WhatsApp — Cloud API، الوسائط. أو Green API لرقم دون حساب Meta Business (Beta، غير رسمي).
  • Messenger — الرسائل الواردة إلى صفحتك على Facebook.
  • Telegram — Bot API، المجموعات والمحادثات الخاصة.
  • Mattermost — webhook صادر، السلاسل.
  • Slack — Events API، توقيع يُتحقَّق منه.
  • SMS — الردود الواردة عبر AllMySMS، أو عبر Brevo.

الويب

  • أداة دردشة الويب — سكربت JS قابل للتضمين في أي موقع ويب.
  • HTTP webhook — استقبال POST عام موقَّع.
  • وكيل خارجي (MCP) — ذكاء اصطناعي من طرف ثالث يحاور أحد نماذجك، إذا كان الـ Start الخاص به يُعلن المستقبِل external_agent_inbound.

الأنظمة الخارجية

  • Meta Lead Ads — استقبال فوري لعملاء Facebook / Instagram المحتملين.
  • الجدولة (cron) — مُشغِّلات متكرّرة.
  • Onoff Business — مكالمة منتهية أو رسالة SMS على خط Onoff (Beta، قراءة فقط).
  • نتيجة مكالمة صادرة — يُشغِّل المستقبِل phone_call_outcome pipeline عند انتهاء مكالمة أُجريت عبر phone_call.
  • ومُشغِّلات التكاملات: ملف جديد في Google Drive، حدث تقويم قادم، فحص Mitti، انتهاء عرض HeyGen.

اختيار القناة المناسبة

ترغب في…القناة المُوصى بها
أتمتة مكالمة هاتفية واردة أو صادرةالهاتف
فرز رسائل الدعم تلقائيًاالبريد الإلكتروني
تشغيل دردشة على موقعك التسويقيأداة الدردشة
استقبال عملاء Meta المحتملين مباشرةًMeta Lead Ads
ربط أداة داخلية تتحدث HTTPWebhook
إطلاق pipeline يومي في الساعة 8 صباحًاالجدولة
الردّ على رسائل WhatsApp على رقم عملWhatsApp
الردّ على رسائل صفحتك على FacebookMessenger
معاودة الاتصال بعميل محتمل فور وصولهالجدولة أو webhook + عقدة phone_call

البنية المشتركة

تتّبع كل القنوات العقد الداخلي نفسه:

  1. استقبال حدث (HTTP، WebSocket، المجدوِل، SIP…).
  2. مصادقة الحدث (التوقيع، الرمز المميّز، مُعرِّف المؤسسة).
  3. تطبيع الحمولة إلى التنسيق الداخلي (ExchangeInput).
  4. تشغيل الـpipeline المستهدَف المُهيَّأ في مؤسستك.

النتيجة العملية: الـpipeline الذي تصمّمه لا يعتمد على قناة الإدخال. فيمكنك الانتقال من البريد الإلكتروني إلى WhatsApp دون تغيير أي شيء لاحق.

القيود

لبعض القنوات متطلبات مسبقة خارجية (رقم SIP، تطبيق Meta، نطاق WhatsApp موثَّق). راجع الصفحة المخصّصة لكل قناة للاطّلاع على القائمة الكاملة.