ربط OTP واتساب مع Laravel وPHP في سوريا: دليل المطوّر

يمكنك إرسال رمز OTP عبر واتساب من تطبيق Laravel أو PHP إلى الأرقام السورية باستخدام WhatsApp Business API الرسمي من خلال Talkalize - توكالايز، بسعر يبدأ من 0.0102 دولار للرسالة، أو باقة 1,000 رسالة OTP مقابل 12 دولارًا بدون مدة صلاحية. تولّد تطبيقك الرمز وتخزّنه مشفّرًا، ثم تطلب من Talkalize إرساله بقالب Authentication معتمد.

هذا الدليل موجّه للمطوّرين الذين يبحثون عن WhatsApp OTP API Laravel PHP سوريا: ما الذي يلزم قبل البدء، وكيف تبني منطق الإرسال والتحقق بشكل آمن، وكم تكلف الرسائل، ومتى يكون SMS خيارًا احتياطيًا.

حقائق سريعة قبل أن تكتب أول سطر

• السعر: رسالة OTP إلى سوريا بين 0.0102 و0.0109 دولار حسب الحجم، وهو سعر Meta زائد رسوم Talkalize.
• الباقة الابتدائية: 1,000 رسالة OTP بـ 12 دولارًا، والرصيد يبقى في محفظة Talkalize حتى يُستهلك.
• القالب: رمز التحقق يُرسل عبر قالب من فئة Authentication، ويدعم زر نسخ الرمز والتعبئة التلقائية بنقرة واحدة.
• اللغات والأطر: الواجهة REST عادية، لذلك تعمل مع PHP وLaravel وNode.js وPython وFlutter وغيرها.
• الإشعارات: يمكن استقبال حالة الرسالة عبر webhooks لتتبّع التسليم.
• الرسمي فقط: الإرسال يتم عبر WhatsApp Business API الرسمي (Meta Cloud API) وليس عبر أدوات غير رسمية.

سعر رسالة OTP إلى سوريا (آخر تحقق: 26 أكتوبر 2026)

الدفع بنظام «ادفع حسب الاستخدام» بلا حد أدنى، ويُشحن الرصيد في المحفظة. أما باقة 1,000 رسالة بـ 12 دولارًا فهي الأنسب لمن يريد أن يجرّب أو يطلق تطبيقًا صغيرًا. التفاصيل في سعر رسالة OTP واتساب سوريا.

ما الذي تحتاجه قبل ربط WhatsApp OTP بـ Laravel

الربط التقني بسيط، لكن الأمور التنظيمية تأخذ وقتًا أطول، فابدأ بها أولًا:

1. حساب في Talkalize وربط رقم واتساب للأعمال بحسابك.
2. قالب Authentication معتمد من Meta، بنص قصير مثل «رمز التحقق الخاص بك هو {1}».
3. مفتاح API يُنشأ من لوحة Talkalize ويُحفظ في ملف .env وليس في الشيفرة.
4. رصيد في المحفظة، ويكفي رصيد بسيط للاختبار.
5. رقم هاتف المستخدم بالصيغة الدولية، فالأرقام السورية تبدأ بـ 963 دون الصفر الأول.

خطوات بناء إرسال OTP والتحقق منه في Laravel

1. طبّع الرقم: احذف المسافات والرمز + والصفر الأول، وتأكد أن الناتج مثل 963944000000.
2. ولّد رمزًا عشوائيًا: استخدم random_int وليس rand، فالأولى مناسبة للأغراض الأمنية.
3. خزّن الهاش لا الرمز: احفظ Hash::make($code) في الكاش بصلاحية قصيرة، من 3 إلى 5 دقائق.
4. أرسل عبر Talkalize: نادِ واجهة الإرسال بالقالب المعتمد وأرسل الرمز كمتغير.
5. حدّد المحاولات: أضف Rate Limiter على طلب الرمز وعلى التحقق، واحذف الرمز بعد أول نجاح.
6. تتبّع الحالة: استقبل webhook لمعرفة هل وصلت الرسالة أم فشلت، وفعّل بديلًا عند الفشل.

مثال شيفرة PHP / Laravel

الخدمة التالية مثال تعليمي. اسم حقول الطلب وعنوان الإرسال خذهما من توثيق Talkalize في لوحة التحكم، وضع مفتاحك مكان YOUR_API_KEY:

<?php
// app/Services/WhatsAppOtp.php
namespace App\Services;

use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\Hash;
use Illuminate\Support\Facades\Http;

class WhatsAppOtp
{
    public function send(string $phone): void
    {
        $code = str_pad((string) random_int(0, 999999), 6, '0', STR_PAD_LEFT);

        // خزّن الهاش فقط، وبصلاحية 5 دقائق
        Cache::put("otp:$phone", Hash::make($code), now()->addMinutes(5));

        Http::withToken(env('TALKALIZE_API_KEY'))   // YOUR_API_KEY
            ->post(env('TALKALIZE_SEND_URL'), [      // الرابط من لوحة Talkalize
                'to'       => $phone,                // 9639XXXXXXXX
                'template' => 'login_otp',           // قالب Authentication معتمد
                'language' => 'ar',
                'code'     => $code,
            ])->throw();
    }

    public function verify(string $phone, string $code): bool
    {
        $hash = Cache::get("otp:$phone");
        if ($hash && Hash::check($code, $hash)) {
            Cache::forget("otp:$phone");
            return true;
        }
        return false;
    }
}

وفي المتحكم (Controller) تضيف مسارين: الأول يستدعي send بعد التحقق من الرقم وتطبيق throttle:3,1، والثاني يستدعي verify ثم يسجّل دخول المستخدم أو يفعّل حسابه. لا تُرجع الرمز أبدًا في استجابة الـ API، ولا تسجّله في ملفات السجل.

واتساب أم SMS للتحقق في سوريا؟

متى يناسبك خيار آخر؟ إذا كان بعض مستخدميك بلا واتساب أو بلا إنترنت وقت التسجيل، أبقِ SMS أو البريد الإلكتروني كبديل احتياطي. وقد شرحنا المقارنة بالتفصيل في بديل SMS للتحقق في سوريا.

حالات استخدام عملية في سوريا

تطبيقات التوصيل

عند تسجيل الزبون لأول مرة أرسل رمزًا من 6 أرقام، وبعد التحقق افتح له الطلب مباشرة. اجعل الصلاحية 5 دقائق وزر «إعادة الإرسال» يتفعّل بعد 60 ثانية.

المتاجر الإلكترونية

اطلب OTP عند تأكيد الطلب بالدفع عند الاستلام لتقليل الطلبات الوهمية، ثم أرسل إشعار الشحن لاحقًا بقالب Utility بالسعر نفسه تقريبًا.

العيادات وحجز المواعيد

تحقق من رقم المريض قبل تثبيت الموعد، فيصبح تذكير الموعد في اليوم التالي موجّهًا إلى رقم صحيح.

تحويل الأموال والخدمات المالية

استخدم OTP لتأكيد العمليات الحساسة كتغيير كلمة المرور أو إضافة مستفيد جديد، مع حدّ صارم للمحاولات.

أخطاء شائعة عند ربط OTP بواتساب

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

للمزيد عن تصميم تجربة التحقق راجع تصميم تجربة آمنة وسهلة لرمز التحقق عبر واتساب ودليل المصادقة ورموز OTP، وللتخطيط الأوسع للربط ربط موثوق بواجهة واتساب.

كم ستكلفك ميزانية OTP لتطبيقك؟

احسب الكلفة من عدد المستخدمين الجدد وعدد مرات تسجيل الدخول، وأضف هامشًا لإعادة الإرسال. مثال حسابي بالأسعار أعلاه: تطبيق يرسل 5,000 رمز في الشهر يدفع نحو 52.5 دولارًا بسعر 0.0105 للرسالة، بينما 10,000 رمز تكلف نحو 104 دولارات بسعر 0.0104. أما إن كنت في مرحلة التجربة فباقة 1,000 رسالة بـ 12 دولارًا تكفي لاختبار التسجيل مع مجموعة صغيرة قبل الإطلاق. هذه حسابات تقريبية من جدول الأسعار، وتبقى قائمة الأسعار الحيّة في الصفحة الرسمية هي المرجع.

أمان الرمز: ما الذي يجب أن تلتزم به

• صلاحية قصيرة: لا تتجاوز 5 دقائق، وأخبر المستخدم بها داخل الواجهة.
• استخدام واحد: احذف الرمز فور التحقق الناجح.
• حدّ للمحاولات: بعد 5 محاولات خاطئة اطلب رمزًا جديدًا وأوقف الرمز القديم.
• حدّ للطلبات: حدّد عدد الرموز المسموح طلبها لكل رقم وكل عنوان IP خلال ساعة.
• رسالة موحّدة: لا تكشف في رسائل الخطأ هل الرقم مسجّل لديك أم لا.
• سرّية المفتاح: احفظ مفتاح API في متغيرات البيئة وبدّله فورًا إن ظننت أنه تسرّب.

استقبال حالة الرسالة عبر webhook

لا تكتفِ بإرسال الطلب ثم الانتظار. سجّل عنوان webhook في Talkalize واستقبل تحديثات الحالة، ثم اربطها برقم العملية في تطبيقك. إذا ظهرت حالة فشل، أظهر للمستخدم خيار «إرسال بطريقة أخرى» وفعّل البريد الإلكتروني أو SMS كبديل. وتأكد أن نقطة الاستقبال تتحقق من مصدر الطلب وتردّ بسرعة، وأن معالجة الحدث نفسه مرتين لا تُحدث ضررًا.

ماذا عن Node.js وPython وFlutter؟

المنطق واحد في كل اللغات: ولّد رمزًا عشوائيًا آمنًا، خزّن هاشه مع صلاحية، استدعِ واجهة REST الخاصة بـ Talkalize، ثم قارن الرمز المُدخل بالهاش. في Node.js استخدم crypto.randomInt، وفي Python استخدم وحدة secrets. وفي تطبيقات Flutter لا تضع مفتاح API داخل التطبيق نفسه، بل اجعل الخادم الخلفي هو من يستدعي Talkalize ويحتفظ بالمفتاح، لأن أي شيفرة داخل التطبيق يمكن استخراجها.

نصائح لرفع نسبة نجاح التحقق

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

قائمة فحص قبل الإطلاق

1. اختبر الإرسال على رقمين سوريين على الأقل، وبأكثر من صيغة إدخال.
2. تأكد من اعتماد القالب بالعربية وبأي لغة أخرى تستخدمها.
3. اختبر حالة انتهاء الصلاحية وحالة الرمز الخاطئ وحالة إعادة الإرسال.
4. راقب رصيد المحفظة وضع تنبيهًا عند اقترابه من النفاد.
5. جهّز بديلًا (SMS أو بريد) للمستخدمين الذين لا يصلهم الرمز.

ابدأ الآن

إن كنت تبني تسجيل دخول أو تأكيد طلبات لمستخدمين في سوريا، فابدأ بباقة 1,000 رسالة OTP مقابل 12 دولارًا من Talkalize - توكالايز: صفحة OTP واتساب سوريا. وإذا أردت مقارنة الباقات والأسعار الكاملة فهي في صفحة الأسعار.

الأسئلة الشائعة

كيف أرسل OTP عبر واتساب إلى رقم سوري من Laravel؟

ولّد رمزًا عشوائيًا بـ random_int، خزّن هاشه في الكاش لمدة 5 دقائق، ثم استدعِ واجهة REST الخاصة بـ Talkalize بقالب Authentication معتمد لإرساله إلى الرقم بصيغة 963، وتحقق منه لاحقًا بمقارنة الهاش.

كم تكلف رسالة OTP واتساب إلى سوريا؟

من 0.0102 إلى 0.0109 دولار للرسالة حسب الحجم، أو باقة 1,000 رسالة OTP مقابل 12 دولارًا بدون مدة صلاحية.

هل أحتاج قالبًا معتمدًا لإرسال رمز التحقق؟

نعم، يُرسل الرمز عبر قالب من فئة Authentication معتمد من Meta، ويدعم زر نسخ الرمز والتعبئة التلقائية بنقرة واحدة.

هل يعمل الربط مع PHP العادي وNode.js وFlutter؟

نعم، الواجهة REST عادية فتعمل مع أي لغة. في Flutter استدعِ Talkalize من الخادم الخلفي ولا تضع مفتاح API داخل التطبيق.

كيف أعرف أن الرسالة وصلت؟

سجّل عنوان webhook في Talkalize لاستقبال تحديثات حالة الرسالة، واربطها بعملية التحقق في تطبيقك.

ما الصيغة الصحيحة لأرقام الهواتف السورية؟

الصيغة الدولية: 963 ثم الرقم بدون الصفر الأول، مثل 963944000000.

هل يوجد حد أدنى للدفع؟

لا، الدفع حسب الاستخدام بلا حد أدنى عبر شحن المحفظة، ويمكنك البدء بباقة 1,000 رسالة بـ 12 دولارًا.