الإعدادات والتكاملات.

إعدادات الشركة وإنشاء مفاتيح API وتكامل webhook وتهيئة رقم مخصص — أدلة التكامل المتقدمة لمساحة عمل Cxperium الخاصة بك.

إعدادات الشركة

في قسم إعدادات الشركة يمكنك تهيئة طريقة تسليم إشعارات WhatsApp وإضافة شعار شركتك إلى مساحة عملك.

  • إرسال إشعارات WhatsApp مباشرة — سلّم الإشعارات إلى المستخدمين مباشرة عبر WhatsApp.
  • إضافة شعار الشركة — ارفع شعارك ليظهر اسم علامتك التجارية عبر المنصة.
  • التحويل المباشر — يغلق التحويل المباشر عبر WhatsApp الصفحة الوسيطة بين المستخدمين وCxperium، فيصل المستخدمون إلى المحادثة دون خطوة وسيطة.

عمليات إنشاء API والاتصال

أدر مفتاح API المستخدم لربط Cxperium بتطبيقاتك الخاصة. توجد جميع عمليات مفتاح API في شاشة الإعدادات ← تكامل API (Settings → API Integration) في القائمة الجانبية. يمكن إنشاء مفتاح API في خطتي Premium وEnterprise.

  1. افتح شاشة تكامل API

    في القائمة الجانبية، انتقل إلى API Integration (تكامل API) ضمن مجموعة Settings (الإعدادات). تتم إدارة المفتاح من خلال حقل Api Key (مفتاح API).

  2. أنشئ مفتاح API جديدًا

    انقر على Generate (إنشاء). يؤدي إنشاء مفتاح جديد إلى إبطال المفتاح السابق؛ لا تنسَ تحديث أي تكامل يستخدمه.

  3. نزّل المجموعة

    يوفر زر View Collection (عرض المجموعة) مجموعة Postman (JSON) التي تضم جميع نقاط نهاية API مع أمثلة الطلبات.

  4. انسخ المفتاح

    استخدم Copy (نسخ) لأخذ المفتاح وإرساله في ترويسة apikey مع طلباتك. احفظ المفتاح في جهة الخادم فقط.

للاطلاع على القائمة الكاملة لنقاط النهاية وقواعد الطلب والاستجابة، راجع مرجع REST API.

تكامل Webhook

يجعل webhook منصة Cxperium ترسل طلب POST بجسم JSON إلى خادمك كلما وقع أحد الأحداث التي اخترتها. تتوفر webhooks في خطة Enterprise، ويستغرق تعريفها ثلاث خطوات.

  1. افتح شاشة webhook

    انتقل إلى الإعدادات ← Webhook (Settings → Webhook) في القائمة الجانبية وأضف تعريفًا جديدًا.

  2. اختر العنوان والأحداث والاستطلاعات

    أدخل عنوان HTTPS الذي سيستقبل الطلبات، وحدد الأحداث التي تُفعِّله (مثل اكتمال الاستطلاع، إنشاء تذكرة، فتح محادثة)، واختر الاستطلاعات التي يشملها webhook.

  3. فعّل التعريف

    بمجرد التفعيل تُرسل الأحداث المحددة إلى عنوانك. يكفي أن ترد بحالة 2xx؛ ولا يُقرأ جسم الرد.

يتطلب الإعداد تعريف العناصر التالية:

  • عنوان التكامل — عنوان HTTPS متاح عبر الإنترنت يستقبل استدعاءات webhook.
  • الأحداث — رموز الأحداث التي تُفعِّل webhook (COMPLETED، ANSWER_GRANTED، TICKET_CREATED، CHAT_CREATED …). القائمة الكاملة وحقول كل حدث في مرجع Webhook.
  • اختيار الاستطلاعات — الاستطلاعات التي تُرسل أحداثها. اختر "الكل" حتى تُرسل أحداث المحادثات والتذاكر.
يمكن إدارة التعريف نفسه عبر API: POST /api/webhook، GET /api/webhook، DELETE /api/webhook. انظر مرجع REST API ← إدارة Webhook.

تغيير رقم Cxperium – إضافة رقم مخصص

يمكنك استبدال رقم Cxperium الافتراضي برقم مخصص يخص نشاطك التجاري.

  1. افتح شاشة الرقم المخصص

    ادخل إلى زر Custom Number (رقم مخصص) في قائمة Profile (الملف التعريفي) لبدء عملية إضافة رقم مخصص.

  2. أدخل معلومات مزوّدك

    أدخل المعلومات المقدمة من الشركة التي اشتريت منها خدمة الرقم المخصص.

يقدّم فريق Cxperium هذه الخدمة أيضًا — تواصل معنا إذا أردت أن نتولى الإعداد نيابة عنك.

لم تجد ما تبحث عنه؟

دع فريقنا التقني يرافقك في عملية التكامل — أرسل سؤالك وسنعاود التواصل معك في اليوم نفسه.

دعم فني متخصص · استشارات تكامل مجانية