إنتقل إلى المحتوى الرئيسي

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

ما هو​

تربط تكاملات BotBat المنصة بالأنظمة الخارجية بحيث تتدفق البيانات بسلاسة من وإلى سير عمل التواصل مع العملاء. بدلاً من العمل كأداة مراسلة معزولة، يصبح BotBat عقدة متصلة في منظومتك التقنية الأوسع، حيث يقوم بمزامنة جهات الاتصال، وتشغيل العمليات الخارجية، واستقبال البيانات من الأنظمة المصدرية.

هناك أربع فئات للتكاملات، تخدم كل منها غرضاً مختلفاً. تربط تكاملات القنوات مزودي المراسلة (WhatsApp وTelegram وSMS وغيرها) ويتم إدارتها من صفحة القنوات. تقوم تكاملات CRM بمزامنة سجلات جهات الاتصال وسجل المحادثات وبيانات الصفقات مع منصات CRM الخارجية. تتيح تكاملات خطافات الويب التواصل المبني على الأحداث عن طريق إرسال حمولات HTTP إلى نقاط النهاية الخارجية عند وقوع أحداث في BotBat، أو عن طريق استقبال حمولات من الأنظمة الخارجية لتشغيل سير عمل BotBat. توفر مفاتيح API وصولاً موثقاً إلى REST API الخاص بـ BotBat للتطوير المخصص والبرمجة والتحكم البرمجي.

تعمل صفحة التكاملات في BotBat كمركز مركزي لإدارة اتصالات CRM وخطافات الويب ومفاتيح API. يتم ربط تكاملات القنوات هنا كمرجع لكنها تُهيأ في صفحة القنوات المخصصة.

Integrations main page showing integration categories: Channels, CRM, Webhooks, API Keys

فئات التكاملات​

يوفر الجدول أدناه مقارنة تفصيلية لكل نوع من أنواع التكاملات، بما في ذلك اتجاه تدفق البيانات وطريقة المصادقة وحالات الاستخدام الشائعة.

الفئةاتجاه تدفق البياناتالمصادقةحالات الاستخدام الشائعة
تكاملات القنواتثنائي الاتجاه (رسائل واردة وصادرة)رموز خاصة بالمنصة وOAuthWhatsApp، Telegram، Messenger، SMS، محادثة الويب، البريد الإلكتروني
تكاملات CRMثنائي الاتجاه (مزامنة جهات الاتصال والصفقات)OAuth أو مفتاح APISalesforce، HubSpot، Zoho CRM، Pipedrive
خطافات الويب (الصادرة)صادر (من BotBat إلى الخارج)سر توقيع HMAC اختياريإشعارات الأحداث، خطوط تحليل البيانات، مستودعات البيانات
خطافات الويب (الواردة)وارد (من الخارج إلى BotBat)رمز URL فريدمشغلات سير العمل، أحداث طلبات التجارة الإلكترونية، تحديثات CRM
مفاتيح APIكلا الاتجاهين (وصول برمجي عبر API)رمز Bearer في ترويسة HTTPالتطبيقات المخصصة، الخدمات الخلفية، سكربتات الترحيل، التقارير

متى تستخدم​

ربط بيانات CRM الخارجية. عندما يستخدم فريق المبيعات لديك CRM مثل Salesforce أو HubSpot، فإن دمجه مع BotBat يضمن بقاء معلومات جهات الاتصال وسجل المحادثات ومراحل الصفقات متزامنة. يمكن لجهات الاتصال الجديدة المنشأة في BotBat أن تظهر تلقائياً في CRM الخاص بك، وتنعكس التحديثات التي يجريها مندوبو المبيعات في CRM على BotBat. هذا يزيل الإدخال اليدوي للبيانات ويقلل من مخاطر السجلات القديمة أو المتضاربة.

CRM integration list showing available CRM providers with connection status

بناء تطبيقات مخصصة. إذا كان فريقك الهندسي بحاجة إلى التفاعل مع BotBat برمجياً، فإن مفاتيح API تفتح الوصول الكامل إلى REST API. يمكنك إرسال الرسائل وإنشاء جهات الاتصال وتحديثها وتشغيل سير العمل وسحب بيانات التحليلات من تطبيقاتك أو خدماتك الخلفية أو السكربتات الخاصة بك. تُستخدم مفاتيح API أيضاً أثناء عمليات ترحيل البيانات عند نقل جهات الاتصال أو سجل المحادثات إلى BotBat من منصة أخرى.

تشغيل إجراءات خارجية من أحداث BotBat. تتيح لك خطافات الويب الصادرة إخطار الأنظمة الخارجية في الوقت الفعلي عند حدوث شيء داخل BotBat. على سبيل المثال، يمكنك إرسال حمولة خطاف ويب إلى منصة التحليلات الخاصة بك في كل مرة تكتمل فيها حملة، أو إرسال إشعار إلى Slack عندما يبدأ عميل VIP محادثة، أو تحديث مستودع البيانات الخاص بك كلما تغيرت سمة جهة اتصال.

Webhook management panel showing configured webhooks with status indicators and event subscriptions

تشغيل سير عمل BotBat من أحداث خارجية. تعمل خطافات الويب الواردة في الاتجاه المعاكس. يمكن لمنصة التجارة الإلكترونية الخاصة بك إرسال حدث تأكيد طلب إلى BotBat، مما يشغل سير عمل يرسل للعميل رسالة WhatsApp تحتوي على إيصاله. يمكن لنظام CRM الخاص بك إخطار BotBat عند إغلاق صفقة، مما يشغل تسلسل إعداد العميل الجديد. يمكن لأي نظام قادر على إجراء طلب HTTP POST أن يبدأ سير عمل BotBat.

هندسة تدفق البيانات​

يساعدك فهم كيفية تحرك البيانات بين BotBat والأنظمة الخارجية على تصميم تكاملات فعالة وخالية من التكرار.

البيانات الواردة تتدفق من الأنظمة الخارجية إلى BotBat. يحدث ذلك من خلال خطافات الويب الواردة (تقوم الأنظمة الخارجية بإرسال البيانات عبر POST إلى عنوان URL يولده BotBat)، ومن خلال استدعاءات API باستخدام مفتاح API (يستدعي تطبيقك REST API الخاص بـ BotBat)، ومن خلال عمليات سحب مزامنة CRM (يقوم BotBat دورياً بجلب السجلات المحدثة من CRM). يمكن للبيانات الواردة إنشاء جهات اتصال وتحديث السمات وتشغيل سير العمل وإرسال الرسائل.

البيانات الصادرة تتدفق من BotBat إلى الأنظمة الخارجية. يحدث ذلك من خلال خطافات الويب الصادرة (يرسل BotBat حمولات الأحداث عبر POST إلى نقطة النهاية الخاصة بك)، ومن خلال عمليات دفع مزامنة CRM (يرسل BotBat السجلات الجديدة أو المحدثة إلى CRM)، ومن خلال استجابات API (يقرأ تطبيقك البيانات من REST API الخاص بـ BotBat). تتيح البيانات الصادرة معالجة الأحداث في الوقت الفعلي وإعداد التقارير والاتساق عبر الأنظمة.

المزامنة ثنائية الاتجاه تجمع بين كلا الاتجاهين. تعمل تكاملات CRM عادةً بشكل ثنائي الاتجاه، حيث تقوم بمزامنة السجلات وفق جدول زمني أو في الوقت الفعلي. يمكن تهيئة قواعد حل التعارضات (مثل "التحديث الأحدث يفوز" أو "CRM هو مصدر الحقيقة") لكل تكامل لمنع تصادم البيانات.

Visual diagram showing inbound and outbound data architecture

الخطوات​

  1. الانتقال إلى التكاملات. انقر على "التكاملات" في شريط التنقل الجانبي الرئيسي لفتح صفحة إدارة التكاملات.

  2. مراجعة التكاملات النشطة. تعرض الصفحة جميع التكاملات المهيأة مجمعة حسب الفئة. يظهر لكل تكامل اسمه ونوعه وحالة الاتصال (متصل، خطأ، غير نشط) والطابع الزمني لآخر مزامنة ناجحة أو تسليم حدث.

  3. ربط CRM. انقر على بطاقة مزود CRM لبدء عملية الاتصال. بالنسبة لأنظمة CRM المعتمدة على OAuth (مثل Salesforce وHubSpot)، سيتم إعادة توجيهك إلى صفحة التفويض الخاصة بالمزود. بالنسبة لأنظمة CRM المعتمدة على مفاتيح API، أدخل بيانات الاعتماد في نموذج الإعداد. بمجرد الاتصال، قم بتهيئة اتجاه المزامنة وتعيينات الحقول وتكرار المزامنة.

  4. إدارة مفاتيح API. انقر على علامة تبويب "مفاتيح API" لإنشاء مفاتيح API وعرضها وإلغائها. التعليمات التفصيلية موجودة في صفحة إعداد التكاملات.

API key list showing key names, creation dates, and last-used timestamps

  1. تهيئة خطافات الويب. انقر على علامة تبويب "خطافات الويب" لإضافة نقاط نهاية خطافات الويب الصادرة واختيار الأحداث للاشتراك وعرض سجلات التسليم. راجع صفحة إعداد التكاملات للحصول على تعليمات خطوة بخطوة.

  2. مراقبة صحة التكاملات. تحقق من مؤشرات حالة التكاملات بانتظام. حالة "متصل" مع مؤشر أخضر تعني أن التكامل يعمل بشكل طبيعي. حالة "خطأ" تشير عادةً إلى رمز منتهي الصلاحية أو نقطة نهاية غير قابلة للوصول أو مشكلة في الأذونات. انقر على التكامل لعرض تفاصيل الخطأ وخطوات المعالجة.

الأخطاء الشائعة​

تكاملات متداخلة كثيرة جداً. إذا قامت تكاملات متعددة بدفع نفس البيانات إلى BotBat (على سبيل المثال، اتصالان CRM يقومان بمزامنة نفس قائمة جهات الاتصال)، فقد ينتهي بك الأمر بسجلات مكررة أو قيم سمات متضاربة. ارسم تدفقات بياناتك على الورق قبل إضافة تكاملات جديدة وتأكد من أن كل مسار بيانات فريد.

عدم مراقبة تسليم خطافات الويب. يمكن أن تفشل خطافات الويب الصادرة بصمت إذا تعطلت نقطة النهاية المستقبلة أو أعادت أخطاء أو انتهت مهلتها. يقوم BotBat بإعادة محاولة عمليات التسليم الفاشلة، ولكن إذا استُنفدت جميع المحاولات يتم تعليم الحدث على أنه فشل نهائي. تحقق من سجلات تسليم خطافات الويب بشكل منتظم وقم بإعداد مراقبة خارجية على نقاط النهاية المستقبلة الخاصة بك.

تخزين مفاتيح API بشكل غير آمن. تمنح مفاتيح API وصولاً موثقاً إلى REST API الخاص بحساب BotBat الخاص بك. لا تكشفها أبداً في JavaScript من جانب العميل أو مستودعات Git العامة أو ملفات التهيئة غير المشفرة. استخدم مدير أسرار أو متغيرات البيئة، وقم بتدوير المفاتيح دورياً.

تجاهل حدود المعدل. تفرض كل من واجهة BotBat API والخدمات الخارجية حدوداً للمعدل. التكامل المخصص الذي يرسل طلبات في حلقة متكررة بدون منطق تراجع سيصل إلى هذه الحدود ويبدأ في تلقي استجابات 429 (طلبات كثيرة جداً). قم ببناء منطق التراجع الأسي وإعادة المحاولة في كل تكامل مخصص.

تلميح

ابدأ برسم احتياجات التكاملات الخاصة بك على الورق: أي الأنظمة تحتاج لإرسال بيانات إلى BotBat، وأيها تحتاج لاستقبال بيانات من BotBat، وأيها تحتاج مزامنة ثنائية الاتجاه. هذا يمنع الإفراط في الهندسة ويساعدك على اختيار نوع التكامل المناسب لكل اتصال.

  • الصفحة الرئيسية للتكاملات
  • قائمة أنظمة CRM
  • لوحة Webhooks
  • مفاتيح API