إرسال رسائل SMS عبر API
واجهة REST API لإرسال رسائل SMS من الكود الخاص بكم. مصادقة برمز API، وطلب واحد لرسالة واحدة أو لحملة كاملة، وتقارير تسليم تصلكم عبر webhook. والـ API نفسه يرسل رسائل واتساب أيضًا، فلا حاجة إلى الربط مع مزوّدَين.
ما هو API إرسال رسائل SMS؟
API إرسال رسائل SMS واجهة تتيح لنظامكم إرسال الرسائل دون أن يدخل أحد إلى واجهة الإدارة ويضغط على زر. يرصد نظامكم حدثًا يستدعي إرسال رسالة، فيستدعي الـ API، وتنطلق الرسالة. هذا هو الفرق بين موظف يرسل التذكيرات يدويًا كل صباح، وتذكير يُرسل تلقائيًا قبل 24 ساعة من كل موعد، حتى في عطلة نهاية الأسبوع في الساعة 3 فجرًا.
عمليًا، تندرج معظم عمليات التكامل ضمن واحدة من ثلاث فئات: رموز تحقق تُرسل لحظة محاولة المستخدم تسجيل الدخول، وتنبيهات تشغيلية يولّدها النظام (تم تأكيد الطلب، خرجت الشحنة، فشلت عملية الدفع)، وتذكيرات مجدولة مستمدة من بيانات موجودة لديكم أصلًا في نظام CRM أو في نظام إدارة المواعيد.
رسالة فردية
طلب POST واحد يحمل رقم المستلم والنص. مناسب لرموز التحقق وللتنبيهات التي تنشأ في الوقت الفعلي.
إرسال متعدد
قائمة مستلمين في طلب واحد، مع حقول ديناميكية لكل مستلم. مناسب للحملات وللتذكيرات اليومية.
إرسال مجدول
الطلب نفسه مع طابع زمني مستقبلي. تُحفظ الرسالة في قائمة الانتظار وتُرسل في الموعد الذي حددتموه.
كيف تبدؤون
أنشئوا حسابًا، وولّدوا رمز API من الإعدادات، وأرسلوا طلب POST واحدًا. لا توجد عملية موافقة يدوية، ولا مكالمة لتحديد المتطلبات، ولا حاجة إلى عقد قبل أن تروا أول رسالة تصل إلى الجهاز. يُرسل الرمز في ترويسة Authorization، ويعود الرد بصيغة JSON مع معرّف للرسالة تستخدمونه لاحقًا للاستعلام عن حالة التسليم.
التوثيق الكامل متاح في صفحة المطورين، مع أمثلة لكل نقطة نهاية (endpoint). ونشرنا أيضًا ملفًا مرجعيًا بصيغة markdown يمكن لصقه مباشرةً في Claude أو ChatGPT أو Cursor، ليكتب مساعد البرمجة لديكم التكامل بشكل صحيح من المرة الأولى بدلًا من تخمين أسماء الحقول.
مصادقة برمز API
رمز شخصي في ترويسة Authorization. يمكن توليد الرموز وإلغاؤها دون المساس بكلمة مرور الحساب.
رد متزامن
يعود الطلب فورًا بمعرّف الرسالة وحالة الاستلام، دون انتظار التسليم الفعلي عبر شبكة الهاتف الخلوي.
ملف مرجعي للذكاء الاصطناعي
توثيق الـ API بصيغة يمكن لصقها في مساعد البرمجة، ليُكتب التكامل بشكل صحيح من المرة الأولى.
تقارير التسليم وما يعود إليكم
نجاح الإرسال ونجاح التسليم حقيقتان مختلفتان، وهذا هو الفرق الذي تغفل عنه معظم عمليات التكامل. رد الـ API يعني أننا استلمنا الرسالة وأدخلناها إلى قائمة الانتظار. أما ما حدث بعد ذلك في شبكة الهاتف الخلوي فيصل بشكل منفصل، أحيانًا بعد ثوانٍ وأحيانًا بعد دقائق.
لذلك تولّد كل رسالة تحديثات حالة يمكن تلقيها بطريقتين: الاستعلام من نقطة نهاية الحالة باستخدام معرّف الرسالة، أو تسجيل عنوان webhook وتلقي تحديث فوري عند كل تغيير في الحالة. إذا كنتم تبنون شيئًا يعتمد على التسليم، مثل تعليق الحساب إلى حين التحقق، فاعتمدوا على تحديث الـ webhook لا على رد الإرسال.
استعلام حسب المعرّف
طلب GET بمعرّف الرسالة يعيد حالتها الحالية ووقت آخر تحديث.
Webhook
تحديث فوري إلى عنوانكم عند كل تغيير في الحالة، فلا تحتاجون إلى الاستعلام في حلقة متكررة.
سبب الفشل
الرسالة التي لم تُسلَّم تعود مع سببها، لتميّزوا بين رقم خاطئ وجهاز مغلق.
الـ API نفسه يرسل واتساب أيضًا
هذا هو الفرق الجوهري مقارنةً بمزوّدي SMS المتخصصين. لدى معظم المزوّدين في السوق، SMS هو كل ما هو متاح، وإن أردتم الإرسال عبر واتساب أيضًا فستحتاجون إلى مزوّد ثانٍ، وعقد ثانٍ، ورمز ثانٍ، ومنطق توجيه خاص بكم يقرر من يتلقى ماذا.
في Vibrate، التكامل نفسه يرسل SMS وواتساب، ويستقبل الردود الواردة، ويشغّل روبوت محادثة على المحادثة إن أردتم. وهذا مهم بشكل خاص للنمط الذي يتكرر في كل مصلحة تجارية في إسرائيل: الإرسال أولًا عبر واتساب لأنه أرخص وأغنى، ثم الاستكمال عبر SMS فقط لمن لم تصله الرسالة. يمكن بناء هذا المنطق فوق API واحد بدلًا من صيانة ربطين منفصلين.
ما الذي يجب فحصه قبل اختيار مزوّد API
تتوقف معظم المقارنات بين مزوّدي SMS عند السعر لكل رسالة، لكن في الإرسال عبر API هناك تفاصيل تؤثر في التكلفة وفي جودة التكامل أكثر بكثير من السعر المعلن.
كم حرفًا يُحتسب رسالة
لدينا 256 حرفًا للوحدة، بالعربية والعبرية والإنجليزية على حد سواء. لدى مزوّدين آخرين الرقم أقل، فتُحتسب رسالة تبدو مطابقة وحدتين.
هل توجد تقارير تسليم حقيقية
المزوّد الذي يعيد تأكيد استلام فقط دون حالة التسليم لا يتيح لكم معرفة ما إذا كان العميل قد تلقى الرسالة فعلًا.
ماذا يحدث عند فشل الرسالة
هل يُعاد سبب فشل يمكن التصرف بناءً عليه، وهل تُحاسبون على رسالة لم تُسلَّم.
هل يمكن التوسع إلى قناة إضافية
إن أردتم واتساب بعد عام، فهل سيكون ذلك تغييرًا في الإعدادات أم مشروع تكامل من جديد.
الباقات والأسعار
دفعة لمرة واحدة، دون اشتراك شهري ودون التزام. الرسائل لا تنتهي صلاحيتها.
* جميع الأسعار تشمل ضريبة القيمة المضافة. وحدة الاحتساب الواحدة تصل إلى 256 حرفًا، بالعربية والعبرية والإنجليزية. الرسائل لا تنتهي صلاحيتها، ويمكن ترقية الباقة في أي وقت.
أسئلة شائعة حول إرسال SMS عبر API
الإرسال الأساسي طلب POST واحد ويمكن تشغيله خلال دقائق. أما التكامل الكامل الذي يشمل تلقي تقارير التسليم عبر webhook، ومعالجة الأخطاء، والإرسال المجدول، فيستغرق عادةً بضع ساعات عمل. لا توجد عملية موافقة يدوية من جانبنا: تولّدون رمزًا وتبدؤون.
عبر رمز شخصي يُرسل في ترويسة Authorization مع كل طلب. يُولَّد الرمز من إعدادات الحساب، ويمكن توليد عدة رموز وإلغاء رمز واحد دون التأثير في البقية ودون تغيير كلمة مرور الحساب.
بطريقتين. يمكنكم الاستعلام من نقطة نهاية مخصصة باستخدام معرّف الرسالة الذي عاد في رد الإرسال، ويمكنكم تسجيل عنوان webhook وتلقي تحديث فوري عند كل تغيير في الحالة. للعمليات التي تعتمد على التسليم الفعلي، مثل التحقق من المستخدم، استخدموا الـ webhook لا رد الإرسال، لأن رد الإرسال يدل فقط على أن الرسالة دخلت قائمة الانتظار.
نعم. رموز التحقق من أكثر استخدامات الـ API شيوعًا، وهي أيضًا الحالة التي تكون فيها السرعة ودقة تقارير التسليم في غاية الأهمية. نوصي بإرسال الرمز عبر الـ API والاعتماد على تحديث الـ webhook لمعرفة ما إذا كان الرمز قد وصل فعلًا قبل عرض رسالة خطأ للمستخدم.
تُرسل كالمعتاد وتصل إلى الجهاز كرسالة واحدة متصلة، لكنها تُحتسب بوحدات من 256 حرفًا: حتى 512 حرفًا تُحتسب وحدتين، وحتى 768 حرفًا ثلاث وحدات، وهكذا. والاحتساب واحد بالعربية والعبرية والإنجليزية، دون فرق بين اللغات ودون مفاجآت بسبب الرموز الخاصة.
نعم. التكامل نفسه يرسل رسائل واتساب أيضًا ويستقبل الردود الواردة، فيمكن بناء منطق توجيه بين القناتين دون الربط مع مزوّد ثانٍ. وهذا هو الاستخدام الأكثر شيوعًا: المحاولة أولًا عبر واتساب، ثم الاستكمال عبر SMS فقط لمن لم تصله الرسالة.
نعم. يمكن إعداد معرّف مرسل يعرض اسم مصلحتكم التجارية بدلًا من رقم هاتف. وينطبق الإعداد أيضًا على الرسائل المرسلة عبر الـ API، فيصل رمز التحقق الذي يخرج من خادمكم إلى العميل باسم شركتكم.
لا. باقة الرسائل نفسها تخدم طريقتي الإرسال، والسعر للوحدة واحد سواء أُرسلت الرسالة من الواجهة أو من حملة مجدولة أو من استدعاء API. لا رسوم إعداد ولا رسوم إضافية مقابل الوصول إلى الـ API.
هل تريدون البدء بالإرسال؟
فتح الحساب يستغرق دقيقة واحدة، دون بطاقة ائتمان ودون التزام. ويمكنكم إرسال أول رسالة تجريبية فور التسجيل.