بدء الاستخدام
يشرح هذا العرض التوضيحي كيفية إعداد عميل API داخل المواقع وتسجيل رقم هاتف النشاط التجاري وتحديث الإعدادات وإرسال رسالة اختبارية.
يمكن تقسيم عملية بدء استخدام API إلى 3 أجزاء:
- تجهيز الأصول - قبل البدء، يجب إعداد الأصول المطلوبة لإكمال عملية دمج API لديك، بما في ذلك حساب واتساب للأعمال.
- تثبيت عميل API داخل المواقع - تثبيت عميل API. بمجرد أن يبدأ العميل في العمل، يمكنك تحديث إعدادات التطبيق لديك.
- بدء استخدام العميل - سجّل رقم هاتفك من خلال إجراء استدعاء API إلى
/accountوإرسال رسالة اختبارية ضمن استدعاء إلى/messages.
قبل البدء
ستحتاج إلى ما يلي:
- حد ائتمان لحساب واتساب للأعمال — لمزيد من المعلومات حول عملية الفوترة أيضًا، يمكنك الرجوع إلى حول الفوترة في API داخل المواقع.
- يمكن لأداة سطر أوامر مثل Terminal أو تطبيق مثل Postman إجراء طلبات cURL.
بعد التحقق من نشاطك التجاري، يخضع نشاطك التجاري للمراجعة بشأن الامتثال لشروط الخدمة في واتساب وسياسة التجارة في واتساب. يتم بدء هذه الخطوة تلقائيًا. ويمكنك تتبع حالة التحقق من النشاط التجاري ومراجعة النشاط التجاري في علامة التبويب الإعدادات في حساب WhatsApp للأعمال لديك في مدير الأعمال. وسيظهر التحقق من النشاط التجاري بالحالة تم التحقق منه، وستظهر حالة الحساب بالحالة مُعتمد عند إصدار الموافقات.
إعداد حساب WhatsApp لديك
أضف رقم الهاتفواسم العرض إلى حساب WhatsApp للأعمال. وسيؤدي ذلك إلى إرسال اسم العرض لإجراء المراجعة.
إذا كنت تريد تغيير اسم العرض، فيمكنك إجراء ذلك عدة مرات كما تريد حتى تنتهي من إكمال التسجيل، أما بعد ذلك، فيجب الانتظار لمدة 30 يومًا بين الطلبات المُقدمة لتغيير اسم العرض.
عند اكتمال جميع عمليات المراجعة، يمكنك عرض شهادة بتشفير base64 والوصول إليها وهو أمر ضروري لتسجيل عميل API داخل المواقع. نوصيك بالتسجيل باستخدام اسم عرض مُعتمد لبدء عملية الدمج وذلك قبل إجراء أي تغييرات إضافية على اسم العرض. ويمكنك تغيير اسم العرض خلال أية مرحلة بعد الانتهاء من الدمج.
مراجعة معلومات الفوترة والأسعار
بمجرد أن يبدأ نشاطك التجاري في إرسال رسائل من خلال API داخل المواقع، من المهم فهم عملية الفوترة، مثل طريقة تحصيل الرسوم وموعدها، وكيفية عرض فاتورتك الشهرية ودفعها. لمزيد من المعلومات، يمكنك الرجوع إلى حول فوترة حساب واتساب للأعمال. بالنسبة لقواعد الأسعار والتكلفة لكل رسالة، يمكنك الرجوع إلى صفحة الأسعار لدينا.
إصدارات البرامج الموصى بها
| البرامج | الإصدار | التفاصيل |
|---|---|---|
API داخل المواقع | ||
API داخل المواقع لخدمات AWS | إصدار القالب: | |
MySQL |
| يُرجى ملاحظة أنه يتعذر العودة إلى إصدار قاعدة البيانات التي تم ترحيلها إلى MySQL 8 لتكون MySQL 5. لذلك، يمكنك إنشاء نسخة احتياطية لقاعدة البيانات قبل الترحيل. |
PostgreSQL |
| الإصدارات |
Docker |
| الإصدار تأكد من وجود statx syscall في قائمة السماح syscalls في docker. |
Postman | أي إصدار حديث | |
libseccomp |
| لا يتم دعم سوى |
glibc |
| لا يتم دعم سوى الإصدار |
نظام التشغيل (OS) | أحدث إصدار | استخدم الإصدار |
الخطوة الأولى: تثبيت عميل API داخل المواقع
البيئة
يستند عميل API داخل المواقع في جوهره إلى حاوية Docker. اطلع على بنية العميل لمعلومات حول كل مكون.
لا يدعم عميل API داخل المواقع حاليًا حاوية Docker في نظام Windows أو نظام Windows Subsystem في Linux. بالنسبة لاحتياجات التطوير، يكون الحل الموصى به هو استخدام جهاز ظاهري يعمل بنظام التشغيل Linux وتشغيل حاوية Docker فيه. بالنسبة لأحمال العمل الإنتاجية، نوصي باستخدام خادم يعمل بنظام التشغيل Linux لتجنب حدوث مشاكل في التوافق والأداء.
الأجهزة
ستعمل API داخل المواقع على أي جهاز متصل بالإنترنت يمكنه تشغيل حاوية Docker في نظام التشغيل Linux، سواء على جهاز ظاهري أو على خادم Linux. لمزيد من المعلومات، يمكنك الرجوع إلى الأسئلة المتكررة. فعلى سبيل المثال، يمكن إجراء الاختبار البسيط على كمبيوتر محمول. في خادم بيئة الإنتاج، نوصي باستخدام SSD بسعة تخزين 250 جيجابايت على الأقل وذاكرة وصول عشوائي تصل إلى 16 جيجابايت ووحدة معالجة مركزية ذات 4 نويات. لا يوصى باستخدام HDD لأن سرعات الإدخال/الإخراج ستصبح مواضع تعثر في ظل التحميل.
في معظم الحالات، يجب عليك تشغيل قاعدة البيانات على خادم فعلي منفصل من حاويات Coreapp وWebapp. ويجب ألا يتأخر خادم قاعدة البيانات في وقت الاستجابة عن بضعة مللي ثوانٍ من جهاز (أجهزة) الكمبيوتر.
التثبيت
تتوفر طريقتان لبدء استخدام API داخل المواقع:
- التثبيت في الموقع — يمكنك إعداد حاويات Docker بمفردك باستخدام دليل التثبيت. ونوصيك بالبدء بأحد إعدادات المطوّرين للتعرف على عملية الإعداد وإرسال الرسائل. كما يمكن استخدام الحل "داخل الموقع" هذا على جهاز الكمبيوتر لديك قبل الترحيل إلى بيئة الإنتاج.
- خدمات الويب من Amazon (AWS): إذا كنت تستخدم AWS أو ترغب في حل مستقل بشكل أكبر، فيمكنك الرجوع إلى دليل AWS. يقوم حل خدمات الويب من AWS بإعداد حل API داخل المواقع باستخدام عمليات النسخ الاحتياطي والاسترداد والمزيد في سحابة AWS التي تديرها وتمتلكها.
بمجرد تشغيل عميل API داخل المواقع، يجب تسجيل الدخول باعتبارك admin لتنفيذ خطوات الإعداد المتبقية.
تحديث الإعدادات
يمكنك إجراء تغييرات على إعدادات التطبيق بمجرد بدء تشغيل عميل API داخل المواقع. ومع ذلك، لن تتوفر لديك صلاحية الوصول إلى إعدادات الملف الشخصي المختلفة لعميل API داخل المواقع حتى تكتمل عملية التسجيل.
- تتعلق إعدادات التطبيق بطريقة عمل العميل، مثل إعدادات الاستدعاء وأحداث Webhooks وجهاز النداء الموجود قيد الاستدعاء وحالة الرسائل المُرسلة وسلوك تنزيل الوسائط وغير ذلك. ملاحظة: نوصيك بشدة بإعداد عنوان URL لحدث Webhook حتى تتمكّن من تلقي إشعارات حول الرسائل الواردة أو الأخطاء.
- تتضمن إعدادات الملف الشخصي للنشاط التجاري وإعدادات الملف الشخصي معلومات حول نشاطك التجاري، مثل العنوان والبريد الإلكتروني وموقع الويب ومجال الصناعة والمعلومات التعريفية وصورة الملف الشخصي.
الخطوة الثانية: بدء استخدام العميل
التسجيل
بمجرد توفير عميل API داخل المواقع وتشغيله، يمكنك تسجيل رقم الهاتف عن طريق إرسال استدعاء API إلى نقطة النهاية account.
إرسال رسالة اختبارية
يمكنك إرسال رسائل اختبارية باستخدام نقطة النهاية messages. أولًا، تحقق من حالة رقم الهاتف الذي تستخدمه للاختبار. وستحتاج إلى إرسال رسالة إلى حساب WhatsApp لديك من رقم الهاتف الاختباري لتمكين نافذة خدمة العملاء والتي تتيح لك إرسال أي نوع من الرسائل في غضون 24 ساعة (لمزيد من التفاصيل، يمكنك الرجوع إلى التحكم في الانقطاع). وبعد ذلك، أرسل رسالة نصية إلى رقم الهاتف الاختباري لديك. إذا تلقيت الرسالة، فهذا يعني أن عملية التثبيت تمت بنجاح. وإذا لم يتم تلقيها، فتحقق من حدث Webhook للحصول على الإشعارات التي قد يمكن أن تشير إلى وجود أية مشكلات.
الأمان
اطلع على دليل الأمان لمعلومات حول كلمات السر والمصادقة وتكوين SSL والفصل بين الشبكات والاتصالات المشفّرة وعناوين HTTP وبروتوكول TLS لخادم الويب فيما يتعلق بعميل API داخل المواقع.
عملية بدء التشغيل
تخضع API داخل المواقع في واتساب إلى إجراء بدء التشغيل عند إنشاء اتصال مع الخادم. هذه العملية ضرورية لضمان وجود وسائل سلسة وموثوقة لإرسال الرسائل واستلامها. أثناء مرحلة بدء التشغيل، ينتظر التطبيق الأساسي (coreapp) تلبية عدة متطلبات أساسية، منها:
تحميل رسائل القوالب: تعمل API على تحميل رسائل القالب من الخادم كجزء من عملية بدء التشغيل.
استلام الرسائل غير المتصلة ومعالجتها: كما يعمل على معالجة استلام الرسائل غير المتصلة ومعالجتها.
إذا تم إجراء محاولات لإرسال الرسائل مع عدم تلبية هذه المتطلبات الأساسية، فسيستجيب التطبيق الأساسي برسالة خطأ "Coreapp غير جاهز"، وستعرض السجلات خطأ "الخدمة غير جاهزة". من الضروري ملاحظة أنه يتم تنفيذ عملية بدء التشغيل هذه في كل مرة يتم فيها إنشاء اتصال جديد مع خادم واتساب. بالتالي، إذا تمت إعادة تشغيل التطبيق الأساسي أو حدث انقطاع في الاتصال، فسيتم بدء عملية بدء التشغيل مرة أخرى لتعيين حالة corapp على "جاهز". هذا يضمن موثوقية API داخل المواقع في واتساب وجاهزيتها لإرسال الرسائل.
معالجة الرسائل غير المتصلة
عندما لا يمكن العثور على أي رسائل غير متصلة، يتم حذف خطوة معالجة الرسائل غير المتصلة. بعبارة أخرى، إذا لم تكن هناك رسائل قيد الانتظار في حالة غير متصلة، فسيتم تجاوز هذه المرحلة المحددة من معالجة الرسائل.
في ظل الظروف المعتادة، تتبع API داخل المواقع في واتساب بروتوكولاً قياسيًا لمعالجة الرسائل غير المتصلة. حيث تنتظر استلام كل الرسائل غير المتصلة ومعالجتها، مع تحديد مسبق لانتهاء المهلة بحد أقصى 6 دقائق. بمجرد انقضاء مدة الـ 6 دقائق هذه، تعتبر مرحلة معالجة الرسائل غير المتصلة مكتملة بنجاح.
اقتراحات إضافية
أمور يجب القيام بهاابدأ في إرسال الرسائل وتلقيها مع الموظفين الداخليين أولاً للتحقق من عمل النظام. قم بالرد على جميع العملاء في غضون 24 ساعة. التزم بسياساتنا الموضحة في سياسة واتساب للأعمال والسياسة التجارية في واتساب. استخدم أرقام هواتف متعددة للتطوير والاختبار والإنتاج. تحقق من الأسئلة المتكررة قبل فتح تذكرة الدعم المباشر. قدّم ملاحظات حول المنتجات. الدعم المباشر هو القناة الأفضل لتحقيق ذلك. | أمور يجب ألا تقم بهاأرسل إشعارات مكررة إلى قنوات متعددة. أرسل محتوى غير مهم أو احتيالي. استخدم أرقام 1-800 للاختبار. أنشئ مدير أعمال فقط لإجراء عمليات دمج واتساب. واستخدم واحدًا موجودًا إذا كان ذلك متاحًا. |
إذا اكتشفنا أنك انتهكت الإرشادات أو السياسات لدينا، فإننا نحتفظ بالحق في تقييد وصولك إلى WhatsApp أو إزالته.