Karzoun Chat
  1. شركاء كرزون
Karzoun Chat
  • اهلا بك 👋🏻
  • البدء مع كرزون
  • التعديل على الحساب الشخصي
  • التعديل على الحساب العام
  • إضافة موظفين دعم خدمة العملاء
  • إضافة قناة تواصل
  • إضافة فريق
  • إضافة تصنيف
  • إنشاء ردود جاهزة (سريعة)
  • تطبيق كرزون شات على الجوال
  • الواتساب
    • ما هو حساب الواتساب الرسمي API
    • إنشاء حساب واتساب رسمي
    • انواع الواتساب
    • اسعار الرسائل
    • طريقة اطلاق حملة رسائل واتساب
    • طريقة بدء محادثة جديدة
    • توثيق الواتساب بالعلامة الخضراء
    • قوالب الواتساب
      • إنشاء قالب واتساب تسويقي
      • انشاء قالب مع متغيرات
  • قنوات التواصل
    • الفيسبوك
    • الإنستقرام
    • البريد الالكتروني
    • تليقرام
    • المحادثة المباشرة
      • الربط مع سلة
      • منصات اخرى
  • الإضافات والمميزات
    • إضافة فريق
    • جهات الاتصال
    • التقارير
    • تفعيل التقييم
    • إنشاء ردود جاهزة (سريعة)
    • إضافة تصنيف
    • نظام إسناد المحادثات
    • المجلدات والفلترة
    • الأتمتة
    • الرسالة الترحيبية ورسالة ساعات الدوام
    • الماكرو
    • Dashboard APP
  • التحديثات
  • Karzoun API
    • How to creat message templates for your WhatsApp Business account
    • How to add system user and generate Access Tokens
    • Create Meta App
    • send message
      • Send Authentication Template (OTP)
      • send message with media
      • send message with button
      • send sample message
    • Sync Messages to Karzoun Chat
  • رموز والاخطاء
  • شركاء كرزون
    • الانضمام كـ مزود حلول تقني معتمد من واتساب شريك كرزون
  • شوبيفاي
    • تفعيل الربط مع شوبيفاي
  1. شركاء كرزون

الانضمام كـ مزود حلول تقني معتمد من واتساب شريك كرزون

مقدمة#

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

الخطوات#

مرحبًا بكم في رحلة الانضمام إلى برنامج مزود التقنية! في الأقسام التالية، سنرشدكم خلال عملية مكونة من ثلاث مراحل تشمل الإعداد، التكامل، والإطلاق. سيقدم هذا الدليل لك كتيباً واضحاً للانضمام بنجاح إلى ميتا و كرزون والاستفادة القصوى من إمكانيات واتساب لمنصتك.
تشمل مرحلة الإعداد إجراءات على مستوى ملف الأعمال. يشمل ذلك إنشاء الحساب وتقديم المعلومات الأساسية للتحقق من الحساب. في نفس الوقت، سيساعدك مدير حساب كرزون في تكوين المكونات الضرورية على منصة كرزون للتحضير لمرحلة التكامل.
تشمل مرحلة الإعداد ما يلي:
إنشاء حاظفة أعمال
إنشاء وتكوين تطبيق ميتا
إكمال التحقق من حافظة الأعمال على ميتا
تشمل مرحلة التكامل ما يلي:
تضمين واجهة انضمام واتساب المدمجة من ميتا (Embedded Signup)
التقديم للحصول على الأذونات اللازمة على مستوى حساب ميتا
التكامل مع واجهات برمجة تطبيقات حركة مرور واتساب من كرزون المبنية على واجهات Meta Cloud API
تنفيذ أي واجهات برمجة تطبيقات لإدارة الخدمات من كرزون اللازمة للإعداد
إعداد الويب هوك للرسائل الواردة وتقارير التسليم
مراجعة تطبيق ميتا
بعد الانتهاء من جميع خطوات التكامل، يمكنك التخطيط للاختبار النهائي والإطلاق للعملاء النهائيين.

الإعداد#

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

إعداد تطبيق ميتا#

إنشاء تطبيق ميتا#

لإنشاء تطبيق ميتا اختر "اعمال" كنوع التطبيق، واربط حساب العمل بهذا التطبيق الجديد. بدلاً من ذلك، استخدم تطبيقًا تجاريًا موجودًا مرتبطًا بالفعل بملف أعمالك. إذا لم تتمكن من تجاوز هذه الخطوة، حاول ضبط قائمة حساب العمل المنسدلة على "No Business Manager account selected" وتابع.
222whatsapp_tpp1.png
11whatsapp_tpp1_2.png
إذا قمت بإنشاء تطبيق ولم يتم إعطاؤك خيار إنشاء تطبيق تجاري على الفور، اختر "اخر" أولاً ثم "التالي".
123whatsapp_tpp2.png
بمجرد إنشاء التطبيق، انتقل إلى التطبيق الخاص بك ضمن علامة التبويب الإعدادات > الأساسية لتحديث النطاقات، الأيقونة، إلخ. أضف روابط سياسة الخصوصية وشروط الخدمة الخاصة بك، والتي ستكون مرئية للمستخدمين عند الانضمام من خلال التسجيل المدمج. لإكمال إنشاء التطبيق، اختر فئة الرسائل واحفظ جميع التغييرات.
2whatsapp_tpp3.png

اضافة تطبيق واتساب#

من لوحة التحكم في التطبيق الخاص بك، أضف منتج الواتساب. ستتم إعادة توجيهك بعد ذلك لاختيار حساب عملك وقبول شروط فيسبوك لاستخدام واتساب للأعمال وشروط الاستضافة الخاصة بميتا لاستخدام Cloud API.
4whatsapp_tpp4.png

اختبار الارسال#

بعد قبول الشروط والأحكام، سيتم توجيهك إلى صفحة البدء السريع حيث يمكنك بدء استخدام واجهة البرمجة. ستحصل على وصول إلى بيئة اختبار متكاملة تتضمن رقم هاتف اختباري يبدأ برمز المنطقة "555" لإرسال واستقبال الرسائل. يمكنك إضافة حتى 5 أرقام إلى قائمة السماح في بيئة الاختبار.
5whatsapp_tpp5.png
سيتم عرض نافذة تسمح لك بإرسال رسالة واتساب.
INFO
يرجى أن تضع في اعتبارك أنك ستقوم بإعداد واجهات برمجة تطبيقات كرزون لإرسال الرسائل والويب هوكس لاستقبال الرسائل وتحديثات حالة للمرحلة الإنتاجية، والتي سيتم شرحها لاحقًا في الشرح. في هذه المرحلة، يكفي اختبار البيئة الرملية لميتا. لذا، لا تتردد في تخطي خطوات 3، 4، و 5 من التعليمات المعروضة أدناه.
66whatsapp_tpp6.png
بمجرد إعداد التكامل مع واتساب، يمكنك البدء في استقطاب مستخدميك النهائيين عن طريق اختيار خيار "Onboard customers" على صفحة البدء السريع:
33whatsapp_tpp7.png

التحقق من حافظة الاعمال#

حدد "ابدأ التحقق" في خطوة التحقق من مزود الخدمة لتقديم
طلب التحقق لـ محفظة الاعمال إذا لم تفعل ذلك بالفعل، وتأكد من رفع الوثائق الرسمية المطلوبة واتباع الإرشادات المتعلقة بالتحقق من النطاق.
whatsapp88_tpp8.png
whatsapp_99tpp9.png

التكامل مع كرزون#

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

إنشاء حل شراكة#

يعد حل الشراكة علاقة لتبادل الأصول بين كيانين تجاريين، يتم تكوينها وبدؤها وقبولها في لوحة التحكم التطبيقية > واتساب > لوحة حلول الشراكة.
whatsapp11_tpp10.png

اضافة تطبيق كرزون في قائمة حلول الشركاء#

كخطوة أولى، يجب عليك التعاون مع كرزون لتحديد اسم الحل، الذي سيظهر في لوحة واتساب -> حلول الشراكة في لوحة التحكم حتى يمكن لك و كرزون التمييز بينه وبين الحلول الأخرى التي قد تقوم بإنشائها.
بمجرد الاتفاق على الاسم، يمكنك بدء طلب حل شراكة في لوحة التحكم -> واتساب -> حلول الشركاء. انتقل إلى لوحة حلول الشركاء وانقر على زر "إنشاء حل شراكة". أدخل اسم الحل المتفق عليه ومعرف تطبيق كرزون 5122552547866102.
أكمل الخطوات لبدء طلب حل شريك
whatsa111pp_tpp11.png
بمجرد الانتهاء، ستتلقى كرزون رسالة بريد إلكتروني وإشعار من ميتا يخبرانا بالطلب. سيظهر الحل في لوحة حلول الشركاء بحالة "قيد المراجعة" حتى يتم قبوله من قبل كرزون.
عندما يقبل كرزون طلب حل الشراكة، سيتغير حالته من "قيد المراجعة" إلى "نشط". تحقق بشكل دوري من لوحة حلول الشراكة حتى ترى أن حالته قد تغيرت إلى "نشط". بمجرد أن يكون نشطًا، قم بنسخ معرف الحل، حيث ستحتاج إلى إضافته إلى تكوين التسجيل المضمن (Embedded Signup)
image.png

التسجيل المضمن Embedded Signup#

يمكن تكوين التسجيل المضمن واستضافته من قبل مزود التقنية، كرزون أو كليهما. سيشاهد العملاء النهائيون الذين يصلون إليه نسخة مخصصة من تدفق التسجيل المضمن:
wh١٣atsapp_tpp13.png
عندما يكمل المستخدم النهائي العملية، يتم إنشاء جميع أصول واتساب الخاصة بالعميل تلقائيًا، ويتم منح الوصول إلى هذه الأصول لكل منكما .

تكوين التسجيل المضمن Embedded Signup#

قم باتباع الخطوات الثلاث
image.png

انشاء التكوين#

هذا الزر يعرض إعدادات إذن تسجيل الدخول إلى فيسبوك للأعمال، ولكن من المحتمل أنك لم تقم بإنشاء أي إعدادات بعد. لإنشاء إعداد، ابحث عن رابط المنتجات على الجانب الأيسر من لوحة التحكم التطبيقية وأضف منتج Facebook Login for Business إلى التطبيق الخاص بك.
عرض السكريبت
هذا الزر يعرض رمز التسجيل المضمن مع العديد من القيم المملوءة مسبقًا، مثل معرف التطبيق الخاص بك. تأكد من تعيين معرف إعداد الإذن الخاص بك إلى خاصية config_id في النص.
بعد ذلك، قم بتكوين تدفق التسجيل المضمن مع الحل بتعيين معرف الحل إلى خاصية solutionID في كائن extras.setup. على سبيل المثال:
<script type="text/javascript">
  document.getElementById('login-btn').onclick = () =>
    FB.login(response => {}, {
      config_id: '<CONFIGURATION_ID>',
      response_type: 'code',
      override_default_response_type: true,
      extras: {
        setup: {
          solutionID: '<SOLUTION_ID>'  // Solution ID goes here
        }
      }
    });
</script>

<button id="login-btn" style="background-color:green; padding:10px 20px; color:#fff;">
  Launch Embedded Signup
</button>

ادارة النطاقات المسموحة#

قم باضافة دومين المنصة الخاصة بك هنا للسماح لها في التعامل مع التسجيل المضمن
image.png

الفوترة#

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

التحقق من الاعداد#

بمجرد إعداد التسجيل المضمن، قم بعرضه في مكان مناسب على موقع الويب الخاص بك حيث يمكنك اختباره. لاختبار التسجيل المضمن، قم بمحاكاة عملية اكتمال التدفق باستخدام بيانات اعتماد عمل العميل التجارية الموجهة من منصتك الخاصة. للتحقق من صحة إعداد التسجيل المضمن الخاص بك، يرجى التأكد من القدرة على القيام بما يلي:
تسجيل رقم بنجاح باستخدام API تسجيل كرزون (Register API).
إرسال رسائل بنجاح نيابةً عن عميلك باستخدام APIs ترافيك كرزون (WhatsApp Standalone أو Messages API، حسب تفضيلك).
بعد ذلك، انتقل إلى Meta App Quickstart -> Onboarding -> Integration وقم بتحديد خانة الاختيار لوضع علامة كمكتمل.
image.png

رفع التطبيق للمراجعة#

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

الاذونات المتقدمة المطلوبة للتطبيق#

تبدأ عملية مراجعة التطبيق بالنقر على زر "طلب الأذونات" في خطوة المراجعات النهائية على صفحة التسجيل، ثم اختيار "تعديل" للاستمرار.
image.png
الأذونات هي شكل من أشكال التفويض التفصيلي التي يمنحها المستخدم، حيث يجب على تطبيقك أن يحصل على إذن المستخدم لاستخدام خدمة وصول إلى بيانات مستخدم التطبيق. لتمرير مراجعة التطبيق، من المهم أن تطلب فقط الأذونات التي يحتاجها تطبيقك للعمل بشكل صحيح. طلب الأذونات غير الضرورية هو سبب شائع لرفض مراجعة التطبيق.
هذه هي أذونات التطبيق المطلوبة لمراجعة التطبيق لحلول واتساب للأعمال. يجب عليك تقديم فيديو مختلف لكل أذنية، حيث يجب توضيح مكان استخدام الأذنيات المعنية على منتجك (موقع الويب أو نماذج أخرى)، وليس منتجات كرزون أو ميتا.
whatsapp_business_management: تسمح لتطبيقك بقراءة و/أو إدارة أصول واتساب للأعمال التي تمتلكها أو التي منحتها لك الشركات الأخرى من خلال هذا الإذن. تشمل هذه الأصول حسابات واتساب للأعمال، وأرقام الهواتف، ونماذج الرسائل، ورموز الاستجابة السريعة (QR codes) ورسائلها المرتبطة، واشتراكات الويبهوك. يتيح لك إدارة حسابات واتساب يتم مشاركتها معك عبر تدفق التسجيل المضمن. يجب أن تقدم whatsapp_business_management كجزء من 'scope' في إعداد نص التسجيل المضمن.
كمزود تكنولوجيا، من المحتمل أن تستخدم هذا الإذن لإرسال واستقبال الرسائل نيابة عن عملائك، سواء عبر واجهة برمجة التطبيقات (API) أو تطبيق.
شرح النص: يجب أن تشرح كيفية استخدامك لهذا الإذن لإرسال الرسائل نيابة عن مستخدميك، سواء كان ذلك من خلال API أو تطبيق.
الفيديو: يجب أن يظهر الفيديو تمريرًا عبر وثائق API الخاصة بك، أو بيئة اختبار أو تطوير أو منتج إذا كان لديك شيء من هذا القبيل. إذا كانت كل ما توفره هو API، فليس عليك إنشاء منتج وهمي فقط لعرض مثال على عميل تجريبي باستخدام API الخاص بك.
whatsapp_business_messaging: تسمح لتطبيقك بإرسال رسائل واتساب إلى رقم هاتف محدد، ورفع/استرجاع الوسائط من الرسائل، وإدارة معلومات ملف تعريف واتساب للأعمال، وتسجيل تلك الأرقام الهاتفية مع ميتا.
كمزود تكنولوجيا، من المحتمل أن تستخدم هذا الإذن لإدارة حسابات عملائك بعد أن يكونوا قد انضموا إلى حلولك من خلال التسجيل المضمن. لعرض استخدامه، نوصي ببناء تجربة مستخدم بعد التسجيل تظهر فيها إعداد الحساب والاتصال برقم الهاتف، على سبيل المثال، تدفق حيث تقوم بإعداد هاتف مستخدم وتأخذه إلى تجربة الرسائل. عند عرض أرقام هواتف المستخدمين أو قوالب الرسائل التي تنتمي إلى حساب واتساب للأعمال على بوابتك، سيكون من السهل تأسيس الارتباط بين البيانات المحصولة والإذن المستخدم.
شرح النص: يجب أن تشرح كيف ستدير حساب عميل، على سبيل المثال، يتيح لمزودي التكنولوجيا API أو تطبيق يسمح للعملاء بإدارة تفاصيل حساباتهم وقوالب رسائلهم.
الفيديو: قم بتسجيل ديمو لمنتجك يظهر معلومات/إدارة أصول عملائك. من أسهل الأمور لعرضه هو صفحة تعرض أرقام هواتف عملائك أو قوالب رسائلهم، أو التمرير من خلال وثائق توضح وظائف API.
إذا قمت بإنشاء مستخدم اختبار يستوفي الشروط المذكورة أعلاه، يمكنه المضي قدمًا في التسجيل المضمن مع عملك ويمكنك استخدام ذلك لإنشاء فيديو العرض التوضيحي الخاص بك.
image.png

Access verification#

للتأكد من أنه يمكن للشركات ذات الحالات الاستخدام الشرعية فقط الوصول إلى بيانات تخص الشركات الأخرى، يجب أن تخضع لعملية التحقق من الوصول. يمكنك بدء عملية التحقق من الوصول بعد تقديم طلب للحصول على أذونات متقدمة على تطبيقك. للبدء، انقر على "بدء التحقق". يمكنك فتح صفحة التحقق من الوصول الكاملة داخل منتج واتساب الخاص بنا والعودة بسرعة إلى صفحة الانضمام.
image.png
image.png
Modified at 2024-07-25 20:13:14
Previous
Sync Messages to Karzoun Chat
Next
تفعيل الربط مع شوبيفاي
Built with