خانة المطورون:

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

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

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

كما تلاحظ رسالة التوثيق يمكن إظهارها حسب لغة المتصل، إنتبه للكلمة بين الهلالين حيث نستبدلها بالكود الذي ولدناه {authcode} .
تحتاج هذه الخدمة لبرمجة خاصة فإذا لم تكن أنت المطور لموقعك يمكنك التواصل مع المطور لبرمجة هذه الخدمة .
عندما تصل رسالة من متصل تقوم خدمة مسجلي بتحليل هذه الرسالة لربطها بموضوع من خلال بوت المحادثة او من خلال الائحة و إرسال هذه المعومات لرابط webhook كي تتم معالجتها ان وجد.

رابط webhook الذي سيتم إستدعائه يجب أن يكون أونلاين و ليس ضمن شبكة داخلية.

المعلومات التي سترسلها لك خدمة مسجلي ستكون على هيئة json و بتنسيق utf8 :

رقم الهاتف phone : وهو الرقم الذي تم تفعيل خدمة مسجلي عليه يفيدك لتميز المتصل مع أي رقم يتحدث في حال كان لديك أكثر من رقم في نفس الحساب.

مفتاح التوثيق token : تجده في قسم المطورون في قسم واتساب في موقع my.masseji.com يفيدك للمقارنة مع الtoken المرسل في الرسالة للتأكد أن من يرسل لك المعلومات هي خدمة مسجلي وليس طرف آخر.

المتصل contact: رقم هاتف المتصل الذي يتحدث مع رقمك.

الأمر المطلق الموضوع command : يساعدك في تصنيف الرسائل الواردة من المتصلين, يجب أن تكون قد أدخلته في اللائحة أو في مواضيع بوت المحادثة.

الرسالة message : النص الأصلي الذي أرسله المتصل قبل تصنيفه ضمن موضوع.

مثال عن المعلومات التي ستردك من خدمة مسجلي لرسالة من متصل:

{"phone": "964622445511", "token": "Demofdsf3453328987d3d34", "contact": "9613123456", "command": "opinion", "message": "my opinion is bla bla bla"}

عند وصول هذه المعومات الي رابط webhook الخاص بك يمكنك معالجتها و إرسال رد برسالة على هيئة json و بتنسيق utf8, مثال للرد :

{"message":"hello world"}