مقدمة
يكمل SMS تطبيق WhatsApp في الأسواق ذات الانتشار الأقل أو للتنبيهات العاجلة. تقبل واجهة SMS في Buzzbip أرقاماً مباشرة أو مراجع جهات اتصال. احترم حدود المعدل ولوائح الموافقة المحلية.
الخطوات
اتبع هذه الخطوات لإكمال التكامل.
- احصل على JWT من POST /api/login_check.
- اختياري: أنشئ جهة اتصال عبر POST /api/contacts/.
- أرسل SMS عبر POST /api/sms/ مع number وmessage.
- تحقق من حالة التسليم في سجل GET /api/sms/.
التفاصيل
أرسل SMS معاملات عبر POST /api/sms/ مع JWT. ضمّن الرقم الكامل مع رمز الدولة ونصاً مختصراً متوافقاً مع قواعد المشغل.
curl -X POST 'https://app.buzzbip.com/api/sms/' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json' \
-d '{"number": "21690123456", "message": "Your order shipped!"}'اختبر في بيئة التجربة قبل الإنتاج.
ملاحظات التكامل
عند دمج نقطة نهاية Buzzbip هذه، استخدم https://app.buzzbip.com كمضيف إنتاج. احصل على JWT من POST /api/login_check وأرسل Authorization: Bearer في كل طلب. تأكد من تفعيل User.hasApiAccess في إدارة Buzzbip. حلّل استجابات JSend (status وmessage وdata). لإضافات التجارة الإلكترونية، أرسل أيضاً x-api-key وx-platform-type وx-base-uri. احترم الشرطة المائلة النهائية في POST /api/contacts/ وPOST /api/whatsapp/. نفّذ إعادة المحاولة مع backoff عند حدود المعدل. خزّن بيانات الاعتماد على الخادم وأعد المصادقة قبل انتهاء JWT (3600 ثانية).
الأمان
أفضل الممارسات: بيانات الاعتماد على الخادم فقط، TLS إلزامي، مراقبة فشل المصادقة. افصل حسابات التجربة والإنتاج. وثّق القوالب والأتمتة. احذف الأرقام والمحتوى من السجلات المشتركة.
ما التالي؟
تابع التعلم: api/sms api/contacts getting-started/rate-limits