مقدمة
يتطلب WhatsApp Business قوالب معتمدة مسبقاً لمعظم الرسائل الصادرة. تعرض Buzzbip واجهات قوالب v1 وv2. يغطي هذا الدليل صياغة نص الجسم مع المتغيرات ووسائط الترويسة الاختيارية والإرسال ومراقبة الاعتماد قبل أول إرسال.
الخطوات
اتبع هذه الخطوات لإكمال التكامل.
- صِغ قالباً عبر POST /api/whatsapp/templates (multipart) أو إنشاء v2.
- ارفع وسائط الترويسة عبر POST /api/v2/whatsapp/media عند الحاجة.
- أرسل للمراجعة عبر POST .../submit.
- استعلم GET حتى الحالة APPROVED.
- أرسل عبر POST /api/whatsapp/ أو endpoint إرسال القالب.
التفاصيل
يجب اعتماد قوالب WhatsApp من Meta قبل الإرسال. تعرض Buzzbip واجهات v1 وv2. يغطي الدليل الصياغة مع المتغيرات ووسائط الترويسة والإرسال للمراجعة.
اختبر في بيئة التجربة قبل الإنتاج.
ملاحظات التكامل
عند دمج نقطة نهاية 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-templates/create-template api/v2/whatsapp-templates guides/send-whatsapp-message
