الإجابة المختصرة
لإضافة إرسال الرسائل النصية إلى تطبيق، استدعِ SMS API الخاص بالمزوّد من الخادم الخلفي باستخدام رمز وصول، ورقم المستلم بالصيغة الدولية، واسم مرسل معتمد، ونص الرسالة. احفظ معرّف الرسالة العائد، واستقبل حالات التسليم عبر Webhook، وعالج الأخطاء وإعادة المحاولة وحدود المعدل قبل الإطلاق.
خطوات الربط
- احصل على بيانات اعتماد تجريبية وسجّل أرقام الاختبار التي سترسل إليها.
- احفظ رمز API في مدير أسرار أو متغير بيئة على خادمك، ولا تضعه أبداً في تطبيق الجوال أو كود المتصفح.
- خزّن الأرقام بصيغة E.164 وحوّلها إلى الصيغة التي يتوقعها الـ API.
- اختر الترميز: نص GSM-7، أو Unicode للعربية والرموز التعبيرية واللغات الأخرى.
- أرسل الرسالة واحفظ معرّف الرسالة العائد بجانب السجل الخاص بك.
- جهّز Webhook لاستقبال حالات التسليم.
- أضف إعادة المحاولة مع backoff لاستجابات 429 و5xx، وسجّل أسماء المرسلين في كل دولة تشترط ذلك.
أخطاء ينبغي تجنّبها
- استدعاء الـ API من تطبيق العميل، ما يكشف الرمز لأي شخص.
- إرسال الأرقام مع علامة + أو مسافات أو صفر محلي بادئ بينما يتوقع الـ API أرقاماً فقط.
- ترك علامة اقتباس منحنية واحدة أو رمز تعبيري يحوّل الرسالة كلها إلى Unicode، ما يقلّص عدد الأحرف في كل جزء.
- إعادة المحاولة عشوائياً بعد انتهاء المهلة. إذا لم يوفّر الـ API مفتاح idempotency، فسجّل كل عملية إرسال أولاً وتحقق من حالتها قبل إعادة الإرسال.
- تجاهل استجابات 429 بدلاً من الانتظار وفق ترويسة Retry-After.
مثال: طلب إرسال رسالة نصية واحدة
على OmniChannels.ai ترسل رسالة نصية واحدة عبر POST https://api.broadnet.me/sms/sendSms مع ترويسة Authorization: Bearer وجسم بصيغة JSON. ويعيد الاستدعاء الناجح الحالة 200 مع معرّف الرسالة كنص عادي. تُمنح صلاحية الاختبار بعد طلب قصير، وتقتصر على أرقامك الموثّقة، ولا يتوفر تسجيل ذاتي فوري.
| الحقل | مثال | ملاحظة |
|---|---|---|
| senderId | OmniDemo | اسم المرسل المعتمد لديك |
| destinationNumber | 447700900123 | رمز الدولة متبوعاً بالرقم، أرقام فقط |
| message | Your code is 482913 | نص الرسالة |
| messageType | TEXT | TEXT لترميز GSM-7، وUNICODE للعربية والرموز التعبيرية |