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

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

القناة في PulseHub تمثل حساب مراسلة متصل واحد. يمكنك امتلاك قنوات متعددة من نفس النوع — على سبيل المثال، رقمي WhatsApp لأقسام مختلفة، أو ثلاث صناديق بريد إلكتروني للمبيعات/الدعم/الفوترة.

كيف تعمل القنوات​

المزود (WhatsApp، Twilio، إلخ.)
           │
           │  HTTP POST (webhook)
           ▼
/webhooks/{type}/{channel_id}
           │
           ▼
WebhookController
  1. يتحقق من التوقيع
  2. يُطبّع الحمولة
  3. يجد/ينشئ جهة اتصال
  4. يجد/ينشئ محادثة
  5. يحفظ الرسالة
  6. يطلق أحداث الأتمتة

كل قناة تحتوي على:

  • معرف فريد (UUID) — هذا هو {channel_id} في عنوان URL الخاص بالـ webhook
  • نوع — واحد من 8 أنواع قنوات مدعومة
  • تكوين — كائن JSON يحتوي على بيانات الاعتماد الخاصة بنوع القناة
  • رمز webhook — رمز عشوائي من 32 حرفاً سداسياً يُنشأ عند الإنشاء
  • علامة نشطة — القنوات غير النشطة ترفض webhooks الواردة ولا ترسل رسائل صادرة

إضافة قناة​

  1. اذهب إلى القنوات في الشريط الجانبي
  2. انقر على إضافة قناة
  3. اختر نوع القناة من القائمة المنسدلة
  4. املأ بيانات الاعتماد الخاصة بالنوع (راجع دليل كل قناة)
  5. انقر على حفظ القناة

بعد الحفظ، تعرض بطاقة القناة عنوان URL الخاص بالـ Webhook. انسخ هذا العنوان والصقه في لوحة تحكم المطور الخاصة بمزودك.

صيغة عنوان URL الخاص بالـ Webhook​

https://yourdomain.com/webhooks/{type}/{channel_id}

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

القناةالاتجاهالتحقق من التوقيعملاحظات
WhatsAppكلاهما✅ HMAC-SHA256يتطلب حساب Meta Business
SMS / Twilioكلاهماجزئييتطلب حساب Twilio
Emailكلاهماغير متاحاستطلاع IMAP للوارد
Telegramكلاهما—Bot API، بدون توقيع
Viberكلاهما✅ HMAC-SHA256يتطلب حساب Viber Partners
Instagramكلاهما✅ HMAC-SHA256عبر Meta Graph API
Facebook Messengerكلاهما✅ HMAC-SHA256عبر Meta Graph API
أداة الدردشة عبر الويبكلاهماTokenمقتطف JS مضمن