ابعت كود واتساب واتحقق منه من موقعك (API)

كل طلب بيروح من السيرفر بتاعك لشات مايزر والمفتاح في الهيدر: Authorization: Bearer وبعده مفتاحك. خلّي المفتاح في متغير بيئة؛ وأبدًا ما تحطه في صفحة ويب أو تطبيق موبايل، أي حد يقدر يقراه منهم.

1. ابعت كود

POST /api/v1/wa/verify والرقم بالصيغة الدولية، مثلًا {"to": "+201005117920", "locale": "ar"}. هيرجع لك id، ووقت انتهاء الكود، وإمتى ينفع تبعت كود تاني. احتفظ بالـ id مع تسجيل الشخص.

2. اتحقق من الكود

POST /api/v1/wa/verify/check ومعاه {"id": "…", "code": "482913"}. الرد فيه valid: true مرة واحدة بس، لما الكود الصح يتكتب. الكود الغلط بيرد valid: false ومعاه عدد المحاولات الباقية؛ ولو كتر، التحقق بيفشل ولازم كود جديد.

ردود لازم تحسب حسابها

• resend_too_soon (429): الشخص داس إعادة إرسال بسرعة. استنى الثواني اللي في Retry-After.
• phone_limit_reached (429): الرقم ده خد أكواد كتير الساعة دي.
• invalid_to (422): الرقم من غير كود الدولة. اطلبه بـ + وكود الدولة.
• country_not_allowed (422): التطبيق بيبعت بس للدول اللي سمحت بيها في الإعدادات.
• template_not_approved (409): Meta لسه ما اعتمدتش رسالة الكود.
• send_failed (502): واتساب رفض الرسالة ومعاه السبب. اعرض طريقة تانية للتحقق.