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

مزوّدو الرسائل

الإعدادات → الاتصالات → مزوّدو الرسائل هو المكان الذي تربط فيه LeadHub بقنوات الرسائل ثنائية الاتجاه. بمجرد التهيئة، يمكن التواصل مع العملاء المحتملين مباشرة من عرض تفاصيلهم، وتصل الرسائل الواردة من تلك القنوات في المحادثات.

القنوات المدعومة:

القناةالاتجاهالمزوّد
WhatsAppإرسال واستقبالMeta Cloud API (WhatsApp Business)
SMSإرسال واستقبالTwilio Programmable Messaging
Telegramإرسال واستقبالTelegram Bot API
Viberإرسال واستقبالViber Business Messages
الصوت (اتصال بنقرة)صادر + تسجيلTwilio Programmable Voice

WhatsApp Business (Meta Cloud API)​

المتطلبات المسبقة​

  • حساب Meta Business على business.facebook.com
  • حساب WhatsApp Business برقم هاتف معتمد
  • يجب تسجيل الرقم على WhatsApp Cloud API (وليس تطبيق WhatsApp العادي)

الخطوة 1 — إنشاء تطبيق Meta​

  1. انتقل إلى developers.facebook.com → تطبيقاتي → إنشاء تطبيق.
  2. اختر أعمال كنوع التطبيق.
  3. أعطه اسمًا (مثل LeadHub Integration) وانقر على إنشاء تطبيق.
  4. تحت إضافة منتجات، ابحث عن WhatsApp وانقر على إعداد.

الخطوة 2 — الحصول على بيانات الاعتماد​

  1. في لوحة تحكم منتج WhatsApp، انتقل إلى إعداد API.
  2. لاحظ:
    • معرّف رقم الهاتف (رقمي، مثل 106540352242922)
    • معرّف حساب WhatsApp Business
  3. انتقل إلى مستخدمو النظام (في إعدادات الأعمال) → أنشئ مستخدم نظام → ولّد رمز وصول دائم بصلاحية whatsapp_business_messaging.

الخطوة 3 — التهيئة في LeadHub​

  1. انتقل إلى الإعدادات → الاتصالات → مزوّدو الرسائل.

  2. وسّع قسم WhatsApp Business وأدخل:

    الحقلالقيمة
    مُفعّلفعّل التبديل
    رمز الوصول الدائممن الخطوة 2
    معرّف رقم الهاتفمن الخطوة 2
    رقم الهاتف المعروضرقم WhatsApp الخاص بك (مثل +1-415-555-0199)

  3. انقر على حفظ الإعدادات.

  4. يظهر رابط Webhook الوارد بعد الحفظ — يبدو كـ: https://yourdomain.com/api/messaging/whatsapp/webhook/TENANT_ID/TOKEN

الخطوة 4 — تسجيل Webhook في Meta​

  1. في لوحة تحكم تطبيق Meta، انتقل إلى WhatsApp → التهيئة → Webhooks.
  2. عيّن رابط Callback إلى رابط Webhook الوارد من الخطوة 3.
  3. عيّن رمز التحقق لأي سلسلة نصية (مثل leadhub_verify).
  4. اشترك في حقل webhook messages.

اختبره: أرسل رسالة إلى رقم WhatsApp الخاص بك من هاتفك. يجب أن تظهر كمحادثة جديدة في LeadHub.

SMS (Twilio Programmable Messaging)​

الخطوة 1 — الحصول على بيانات اعتماد Twilio​

  1. سجّل الدخول إلى console.twilio.com.
  2. من لوحة التحكم، انسخ Account SID وAuth Token.
  3. تحت أرقام الهاتف → إدارة → الأرقام النشطة، لاحظ رقم Twilio الخاص بك.

الخطوة 2 — التهيئة في LeadHub​

  1. انتقل إلى الإعدادات → الاتصالات → مزوّدو الرسائل.

  2. وسّع SMS (Twilio) وأدخل:

    الحقلالقيمة
    مُفعّلفعّل التبديل
    Account SIDAC... من لوحة تحكم Twilio
    Auth Tokenمن لوحة تحكم Twilio
    رقم المُرسلرقم Twilio الخاص بك بتنسيق E.164 (مثل +14155550199)

  3. انقر على حفظ الإعدادات.

  4. انسخ رابط Webhook الوارد الذي يظهر بعد الحفظ.

الخطوة 3 — تسجيل Webhook في Twilio​

  1. في Twilio، انتقل إلى أرقام الهاتف → إدارة → الأرقام النشطة → انقر على رقمك.
  2. تحت الرسائل → عند وصول رسالة، عيّن رابط Webhook إلى رابط Webhook الوارد في LeadHub.
  3. عيّن الأسلوب إلى HTTP POST واحفظ.

حسابات التجربة: يمكنها فقط إرسال SMS إلى أرقام تم التحقق منها. قم بالترقية إلى حساب مدفوع للاستخدام في الإنتاج.

Telegram​

الخطوة 1 — إنشاء بوت Telegram​

  1. افتح Telegram وأرسل رسالة إلى @BotFather.
  2. أرسل /newbot واتبع التعليمات (الاسم واسم المستخدم).
  3. يمنحك BotFather رمز البوت (الصيغة: 123456:ABCdef...).
  4. لاحظ أيضًا اسم مستخدم البوت (مثل @your_leadhub_bot).

الخطوة 2 — التهيئة في LeadHub​

  1. انتقل إلى الإعدادات → الاتصالات → مزوّدو الرسائل.

  2. وسّع Telegram وأدخل:

    الحقلالقيمة
    مُفعّلفعّل التبديل
    رمز البوتمن BotFather
    اسم مستخدم البوتمثل @your_leadhub_bot

  3. انقر على حفظ الإعدادات.

  4. انسخ رابط Webhook الوارد الذي يظهر.

يسجّل LeadHub تلقائيًا الـ webhook مع Telegram عبر Telegram Bot API — لا تحتاج إلى لصق الرابط في Telegram يدويًا.

Viber Business Messages​

⚠️ يتطلب Viber Business Messages حساب خدمة Viber معتمد (حساب ISV/أعمال). لا يمكن لحسابات Viber الشخصية العادية إرسال رسائل أعمال.

الخطوة 1 — الحصول على رمز مصادقة Viber​

  1. تواصل مع برنامج شركاء Viber واحصل على حساب الخدمة.
  2. سجّل الدخول إلى بوابة شركاء Viber وابحث عن رمز المصادقة.
  3. لاحظ اسم المُرسل (اسم علامتك التجارية، حتى 28 حرفًا).

الخطوة 2 — التهيئة في LeadHub​

  1. انتقل إلى الإعدادات → الاتصالات → مزوّدو الرسائل.

  2. وسّع Viber وأدخل:

    الحقلالقيمة
    مُفعّلفعّل التبديل
    رمز المصادقةمن بوابة شركاء Viber
    اسم المُرسلاسم علامتك التجارية

  3. انقر على حفظ الإعدادات.

  4. انسخ رابط Webhook الوارد وسجّله في لوحة تحكم حساب خدمة Viber.

الصوت / الاتصال بنقرة (Twilio Voice)​

يُتيح Twilio Voice إجراء مكالمات بنقرة واحدة مباشرة من صفحة تفاصيل العميل. تُسجَّل المكالمات في سجل المكالمات ويمكن تسجيلها ونسخها تلقائيًا.

المتطلب المسبق: يجب تهيئة SMS (Twilio) أولًا — يُعيد الصوت استخدام نفس Account SID وAuth Token.

الخطوة 1 — التهيئة في LeadHub​

  1. انتقل إلى الإعدادات → الاتصالات → مزوّدو الرسائل.

  2. وسّع الصوت (Twilio Voice) وأدخل:

    الحقلالقيمة
    مُفعّلفعّل التبديل
    رقم معرّف المتصل الصوتيرقم Twilio الصوتي بتنسيق E.164
    تسجيل المكالماتفعّل للتسجيل
    نسخ تلقائي + ملخص AIفعّل لتوليد نص مكتوب وملخص

  3. انقر على حفظ الإعدادات.

  4. تظهر ثلاثة روابط — TwiML URL وStatus URL وRecording URL. انسخ الثلاثة.

استكشاف الأخطاء وإصلاحها​

المشكلةالحل
"احفظ الإعدادات أولًا لتوليد رابط Webhook الوارد"لم تحفظ بعد — أدخل بيانات الاعتماد وانقر على حفظ أولًا
فشل التحقق من Webhook في WhatsAppتأكد من تطابق رمز التحقق في Meta مع ما استخدمته أثناء الإعداد
رسائل Telegram لا تصليسجّل LeadHub الـ webhook تلقائيًا — تحقق من صحة رمز البوت
فشل اختبار SMSتأكد من صحة Auth Token وأن رقم Twilio نشط
المكالمات الصوتية لا تتصلتأكد من تسجيل روابط TwiML وStatus في Twilio
تظهر الرموز مُخفية (••••••••••••)هذا مقصود — الأسرار الموجودة مُخفية للأمان. اتركها دون تغيير للحفاظ على السر المخزّن.