مقدمة
يشرح هذا الدليل تدفق WhatsApp صادراً كاملاً باستخدام واجهات Buzzbip REST. تحتاج تفعيل الوصول إلى API على حسابك وقالباً واحداً معتمداً على الأقل من Meta. تستهدف جميع الطلبات https://app.buzzbip.com مع Authorization: Bearer <token>. في الإنتاج، صفّ الإرسال من الخادم وعالج أخطاء JSend صراحةً.
الخطوات
اتبع هذه الخطوات لإكمال التكامل.
- صادق عبر POST /api/login_check واحفظ JWT.
- تأكد أن القالب APPROVED (GET /api/whatsapp/templates/{id} أو v2).
- أنشئ أو اعثر على جهة اتصال عبر POST /api/contacts/ أو GET /api/contacts/.
- أرسل عبر POST /api/whatsapp/ مع template_id وcontact_id.
- تحقق من التسليم في سجل GET /api/whatsapp/.
التفاصيل
يشرح هذا الدليل تدفق WhatsApp صادراً كاملاً عبر واجهات Buzzbip REST. تحتاج وصول API مفعّلاً وقالب Meta معتمداً. جميع الطلبات إلى https://app.buzzbip.com مع Authorization: Bearer. في الإنتاج، صفّ الإرسال على الخادم وعالج أخطاء JSend.
curl -X POST 'https://app.buzzbip.com/api/whatsapp/' \
-H 'Authorization: Bearer ${TOKEN}' \
-H 'Content-Type: application/json' \
-d '{"template_id": 42, "contact_id": 1}'اختبر في بيئة التجربة قبل الإنتاج.
ملاحظات التكامل
عند دمج نقطة نهاية 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/whatsapp-messaging/send-whatsapp-message guides/create-whatsapp-template api/contacts
