البدء
سيساعدك هذا الدليل في إرسال أول رسالة واستلامها باستخدام API السحابة. كما ستتعرف على كيفية تكوين أحداث Webhooks لاستخدامها مع عينة التطبيق.
هذا الدليل مخصص للأشخاص الذين يطورون التطبيقات لأنفسهم أو للمؤسسة. إذا كنت تطور تطبيقًا سيتم استخدامه بواسطة أنشطة تجارية أخرى، فراجع موفرو الحلول.
قبل البدء
ستحتاج إلى ما يلي:
- حساب مطوّر Meta - تعرف على المزيد حول التسجيل كمطوّر Meta.
- تطبيق أعمال - تعرف على المزيد حول إنشاء التطبيقات. إذا لم يظهر خيار إنشاء تطبيق أعمال، فحدد غير ذلك > التالي > الأعمال أثناء إنشاء التطبيق).
الخطوة الأولى: إضافة منتج واتساب إلى التطبيق
في هذه المرحلة، إذا قمت بتطوير تطبيق جديد، فستتم مطالبتك بإضافة المنتجات إلى التطبيق. يمكنك التمرير لأسفل، وضمن واتساب، حدّد إعداد. بخلاف ذلك، حدد التطبيق من شاشة تطبيقاتي، ويمكنك اتباع الإرشادات ذاتها مرة أخرى لإضافة منتج واتساب إلى التطبيق.
إذا كان لديك حساب Meta للأعمال (MBA)، فستتم مطالبتك بإرفاقه عند إضافة منتج واتساب إلى التطبيق. إذا لم يكن لديك حساب MBA، فسيتم عرض بعض المطالبات التي ستساعدك في إنشاء حساب. بمجرد إرفاق حساب MBA في التطبيق، ستصبح مستعدًا لبدء الاختبار.
تؤدي إضافة منتج واتساب إلى تطبيقك إلى القيام ببعض الأمور من أجلك:
- مطالبتك بإنشاء حساب Meta للأعمال إذا لم يكن لديك حساب.
- إنشاء حساب واتساب للأعمال اختباري تلقائيًا. يتم فرض تقييدات على هذا الحساب ويجب استخدامه لأغراض الاختبار والتطوير حيث إنك لا تدفع مقابل الرسائل.
- إنشاء رقم هاتف اختباري للنشاط التجاري مرتبط بحساب واتساب للأعمال. من خلال هذا الرقم، يمكنك إرسال رسائل مجانية إلى ما يصل إلى 5 أرقام هاتف للمستلم.
- إنشاء مجموعة من قوالب الرسائل التي تمت الموافقة عليها مسبقًا.
الخطوة الثانية: إضافة رقم مستلم
أضف رقم واتساب صالح حيث يمكنك إرسال الرسائل الاختبارية.
في القائمة على الجانب الأيمن من لوحة معلومات التطبيق، انتقل إلى واتساب > إعداد API. ضمن إرسال الرسائل واستلامها، حدّد الحقل إلى واختر إدارة قائمة أرقام الهواتف.
يمكنك إضافة أي رقم واتساب صالح كمستلم. سيتلقى الرقم المستلم رمز تأكيد في واتساب يمكن استخدامه للتحقق من الرقم.
بمجرد التحقق من الرقم المستلم، من المفترض أن يتم تحديده في الحقل إلى. كرّر هذه العملية إذا أردت إضافة مستلم آخر، بما يصل إلى 5 مستلمين كحد أقصى.
الخطوة الثالثة: إرسال رسالة اختبارية
أرسل رسالة القالب hello_world الذي تم الموافقة عليها مسبقًا إلى الرقم المستلم المختار.
في لوحة تحكم واتساب > إعداد API:
- تأكد من تحديد رقم هاتف النشاط التجاري الاختباري في الحقل من.
- تأكد من تحديد رقم الهاتف المستلم الذي تريد مراسلته في الحقل إلى. إذا تمت إضافة العديد من الأرقام، فيمكنك إرسال رسائل متعددة في وقت واحد.
- في لوحة التحكم إرسال الرسائل من خلال API، انقر على الزر إرسال رسالة.
بدلاً من ذلك، يمكنك نسخ أمر cURL، ثم لصقه في نافذة وحدة طرفية جديدة وتشغيله.
لاحظ أن الرمز يشير إلى إرسال رسالة قالب (”type”:”template”) وتحديد قالب معين للاستخدام (”name”:”hello_world”).
الخطوة الرابعة: استنساخ عينة من التطبيق وتكوين أحداث Webhooks
مع أحداث webhooks، يمكنك تلقي إشعارات HTTP فورية تتضمن التغييرات التي تطرأ على كائنات محددة. في واتساب بإمكان أحداث webhooks إبلاغك بالعديد من الأحداث في التطبيق، مثل تسليم الرسالة وقراءة الإشعارات وحتى تغييرات الحساب.
أضف عنوان URL للاستدعاء لعرض محتويات أحداث webhooks. اتبع دليل عينة من عنوان URL للاستجابة لاختبار أحداث Webhooks لاستنساخ عينة من التطبيق، والذي يقبل إشعارات أحداث webhooks ويعرض حمولات بيانات JSON على الشاشة.
بمجرد إعداد حدث webhook، أعد إرسال رسالة القالب ثم رد عليها مجددًا. يمكنك عرض 4 إشعارات webhook منفصلة: إشعارات إرسال الرسالة وتسليمها وقراءتها ومحتويات الرسالة الواردة.
الخطوة الخامسة: (اختيارية) إضافة رقم نشاط تجاري حقيقي
من خلال رقم النشاط التجاري الاختباري وحساب واتساب للأعمال الاختباري، يمكنك بدء تطوير التطبيق. عند استخدام هذه الأصول الاختبارية، فإنك لا تدفع مقابل إرسال الرسائل بينما تعمل على تطوير التطبيق.
بمجرد الاستعداد لبدء إرسال الرسائل إلى العملاء، يمكنك إضافة رقم هاتف النشاط التجاري الحقيقي في لوحة التحكم إعداد API وإنشاء حساب واتساب للأعمال حقيقي.