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

ربط قناة مراسلة

ما هو​

يوضح لك هذا الدليل كيفية ربط قناة مراسلة بـ BotBat حتى تتمكن من إرسال واستقبال الرسائل. يغطي WhatsApp Business API وTelegram وFacebook Messenger ومزودي SMS. بنهاية هذا الدليل، ستكون لديك قناة تم التحقق منها وتعمل وجاهزة للحملات وروبوتات المحادثة.

متى تستخدمه​

  • الإعداد الأولي: أنت تقوم بإعداد BotBat لأول مرة وتحتاج إلى ربط قناة المراسلة الأساسية لديك.
  • إضافة قناة: تريد التوسع إلى منصة جديدة (مثل إضافة Telegram بجانب WhatsApp الحالي لديك).
  • تبديل المزودين: أنت تنتقل إلى مزود SMS أو WhatsApp جديد وتحتاج إلى إعادة تهيئة الاتصال.

الخطوة 1: انتقل إلى صفحة القنوات​

افتح الشريط الجانبي في وحدة تحكم BotBat وانتقل إلى الإعدادات > القنوات (أو التكاملات > القنوات، حسب إصدار وحدة التحكم لديك). تعرض هذه الصفحة جميع القنوات المتصلة حاليًا مع اسم القناة ونوعها والمزود والحالة (متصل، غير متصل، أو خطأ) وآخر نشاط.

Channel list page showing connected channels with status indicators and provider details

الخطوة 2: ابدأ معالج إعداد القناة​

انقر على زر إضافة قناة في الزاوية العلوية اليمنى لفتح معالج إعداد القناة. يرشدك المعالج خلال اختيار المزود وإدخال بيانات الاعتماد والتحقق وتهيئة Webhook في تدفق تسلسلي.

Provider selection screen showing available channel types including WhatsApp, Telegram, Messenger, and SMS

حدد نوع قناتك والمزود من القائمة. تشمل الخيارات WhatsApp (عبر Meta Cloud API أو BSP) وTelegram وFacebook Messenger وSMS (Twilio أو MessageBird أو Vonage أو مزودين آخرين مدعومين).

نوع القناةخيارات المزودالمتطلبات الأساسية
WhatsAppMeta Cloud API، 360dialog، Gupshup، Infobip، مزودو BSP آخرونحساب Meta مُعتمد للأعمال، رقم هاتف معتمد، رمز وصول دائم.
TelegramTelegram Bot APIروبوت تم إنشاؤه عبر BotFather، رمز الروبوت.
MessengerFacebook Messenger (Meta)صفحة Facebook، رمز وصول الصفحة، سر التطبيق، رمز التحقق من Webhook.
SMSTwilio، MessageBird، Vonage، مزودون مدعومون آخرونحساب مزود، بيانات اعتماد API (SID/رمز المصادقة أو مفتاح API)، رقم/معرّف المرسل.

الخطوة 3: أدخل بيانات اعتماد API​

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

Credentials form with labeled fields filled in for WhatsApp Cloud API configuration
المزودالحقول المطلوبةأين تجدها
WhatsApp Cloud APIمعرّف رقم الهاتف، معرّف حساب WhatsApp للأعمال، رمز وصول دائمMeta Business Suite > WhatsApp > إعداد API. أنشئ رمزًا دائمًا عبر مستخدم نظام في إعدادات الأعمال.
Telegramرمز الروبوتافتح Telegram، أرسل رسالة إلى @BotFather، استخدم أمر /newbot، وانسخ الرمز المقدّم.
Facebook Messengerرمز وصول الصفحة، سر التطبيق، رمز التحققبوابة مطوري Meta > تطبيقك > إعدادات Messenger. سر التطبيق في لوحة تحكم التطبيق تحت الإعدادات > أساسي.
Twilio (SMS)معرّف الحساب SID، رمز المصادقة، رقم هاتف المرسلوحدة تحكم Twilio > لوحة تحكم الحساب. يجب أن يكون رقم المرسل رقم Twilio أو معرّف متصل مُتحقق منه.
MessageBird (SMS)مفتاح API، المُنشئ (اسم أو رقم المرسل)لوحة تحكم MessageBird > المطورون > وصول API.
Vonage (SMS)مفتاح API، سر API، رقم المرسللوحة تحكم Vonage API > الإعدادات.

تحقق من كل قيمة بعناية قبل المتابعة. الأخطاء الشائعة تشمل المسافات الزائدة في الرموز، واستخدام رمز مؤقت بدلًا من دائم، وإدخال معرّف حساب خاطئ.

الخطوة 4: تحقق من الاتصال​

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

Verification success screen showing a green checkmark and confirmation message
نتيجة التحققالمعنىالإجراء
نجاح (علامة صح خضراء)بيانات الاعتماد صحيحة، ويمكن لـ BotBat التواصل مع المزود.تابع إلى الخطوة التالية.
فشل المصادقةالرمز أو SID أو مفتاح API غير صحيح أو منتهي الصلاحية.أعد التحقق من بيانات الاعتماد في لوحة تحكم المزود وحدّث النموذج.
رفض الصلاحياتبيانات الاعتماد صحيحة لكنها تفتقر للنطاقات أو الصلاحيات المطلوبة.امنح الصلاحيات اللازمة (المراسلة، إدارة Webhook) في لوحة تحكم المزود.
خطأ في الشبكةلم يتمكن BotBat من الوصول إلى نقطة نهاية API الخاصة بالمزود.تحقق من إعدادات الشبكة وقواعد جدار الحماية وحالة خدمة المزود.

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

الخطوة 5: هيّئ Webhook​

بعد التحقق الناجح، ينشئ BotBat عنوان URL فريدًا لـ Webhook لقناتك. هذا العنوان هو نقطة النهاية التي يستدعيها مزود المراسلة عند حدوث حدث، مثل رسالة واردة أو إيصال تسليم أو إيصال قراءة.

Webhook URL display panel with the generated URL and a copy-to-clipboard button

انسخ عنوان URL لـ Webhook باستخدام زر النسخ وسجّله في لوحة تحكم المزود. تختلف عملية التسجيل حسب المزود:

  • WhatsApp Cloud API: انتقل إلى لوحة تحكم تطبيق Meta > Webhooks > تعديل الاشتراك. الصق العنوان، أدخل رمز التحقق المعروض في BotBat، واشترك في حقول messages وmessage_deliveries وmessage_reads.
  • Telegram: يسجّل BotBat الـ Webhook تلقائيًا عبر Telegram Bot API. لا حاجة لتهيئة يدوية.
  • Messenger: انتقل إلى لوحة تحكم تطبيق Meta > Webhooks. أضف عنوان URL للاستدعاء، الصق عنوان BotBat، أدخل رمز التحقق، واشترك في messages وmessaging_postbacks وmessage_deliveries.
  • SMS (Twilio): انتقل إلى وحدة تحكم Twilio > أرقام الهاتف > رقمك > تهيئة المراسلة. عيّن Webhook "عند وصول رسالة" إلى عنوان BotBat باستخدام HTTP POST.
  • SMS (MessageBird/Vonage): هيّئ عنوان URL لـ Webhook الرسائل الواردة في لوحة تحكم المزود المعني تحت إعدادات رقمك أو تطبيقك.

تأكد من الاشتراك في جميع أنواع الأحداث المطلوبة. الاشتراكات المفقودة (مثل حذف إيصالات التسليم) ستتسبب في فقدان BotBat رؤية حالة تسليم الرسائل.

الخطوة 6: أرسل رسالة تجريبية​

انقر على إرسال رسالة تجريبية في المعالج. أدخل رقم هاتف أو معرّف محادثة (يُفضّل رقمك الشخصي) وانقر على إرسال. يرسل BotBat رسالة اختبارية عبر القناة المتصلة حديثًا لتأكيد عمل التسليم الصادر.

Test message confirmation screen showing success status and a preview of the sent message

تأكد من وصول الرسالة إلى جهازك. ثم أرسل ردًا من جهازك للتحقق من أن معالجة الرسائل الواردة تعمل بشكل صحيح. يجب أن يعرض BotBat الرد الوارد في لوحة نتائج الاختبار أو في صندوق الوارد. يؤكد اختبار الذهاب والإياب هذا أن كلًا من الإرسال الصادر واستقبال Webhook الوارد يعملان بشكل صحيح.

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

  • رموز منتهية الصلاحية أو محدودة النطاق: يمكن أن تنتهي صلاحية رموز WhatsApp وMessenger أو تفتقر إلى الصلاحيات المطلوبة. استخدم دائمًا الرموز الدائمة المُنشأة عبر مستخدمي النظام، وامنح جميع نطاقات المراسلة ذات الصلة أثناء إنشاء الرمز.
  • عنوان URL لـ Webhook غير مسجّل: إذا تخطيت خطوة تسجيل Webhook، يمكن لـ BotBat إرسال الرسائل لكنه لا يستطيع استقبال الردود أو تحديثات حالة التسليم. سجّل دائمًا عنوان URL لـ Webhook في لوحة تحكم المزود وتحقق من أنه نشط.
  • جدار الحماية يحجب الاستدعاءات: إذا كانت بنيتك التحتية تستخدم جدار حماية أو WAF، تأكد من إدراج نطاقات IP الخاصة بالمزود في القائمة المسموح بها. تنشر Meta وTwilio والمزودون الآخرون نطاقات IP الخاصة بهم في وثائقهم.
  • استخدام بيانات اعتماد اختبارية في الإنتاج: يقدم بعض المزودين بيانات اعتماد اختبارية أو بيئة وضع الحماية بإمكانيات محدودة. تأكد من استخدام بيانات اعتماد الإنتاج لتهيئة قناتك المباشرة.
  • مسافات زائدة في الرموز: نسخ الرموز من رسائل البريد الإلكتروني أو المستندات قد يُدخل أحرف مسافات غير مرئية. قص جميع قيم بيانات الاعتماد قبل لصقها في النموذج.
تلميح

بعد ربط القناة، أرسل رسالة لنفسك وأرسل ردًا عليها. يؤكد هذا الاختبار ذهابًا وإيابًا أن كلًا من التسليم الصادر واستقبال Webhook الوارد يعملان. كرّر هذا الاختبار في كل مرة تحدّث فيها بيانات الاعتماد أو تغيّر عناوين Webhook أو تعدّل إعدادات المزود.

  • صفحة قائمة القنوات
  • معالج إضافة القناة
  • اختيار المزوّد
  • نموذج بيانات الاعتماد
  • التحقق من القناة
  • تكوين Webhook
  • رسالة تجريبية