نظرة عامة
أرسل قالب v2 معتمداً من Meta إلى رقم هاتف. على عكس إرسال v1 (contact_id)، يقبل إرسال v2 to وcountry_code وbody_params اختيارية للعناصر النائبة {{N}} وأزرار URL ديناميكية أو COPY_CODE ووسائط ترويسة لكل مستلم وotp_code لقوالب AUTHENTICATION. النقطة: POST /api/v2/whatsapp/templates/{TEMPLATE_ID}/send — بدون شرطة مائلة نهائية.
POST /api/v2/whatsapp/templates/{TEMPLATE_ID}/send
صادق باستخدام Authorization: Bearer <token>. أرسل جسم JSON مع to وcountry_code والحقول الاختيارية أدناه.
curl --request POST \
'https://app.buzzbip.com/api/v2/whatsapp/templates/1289/send' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_JWT' \
--data '{
"to": "21696816277",
"country_code": "TN",
"body_params": ["Sam", "ORD-2026-00041"]
}'ملاحظات الاستخدام
⚠️ ملاحظة: يجب أن يطابق عدد body_params عدد العناصر النائبة {{N}} في نص القالب. أي اختلاف يُرجع HTTP 400. ⚠️ ملاحظة: لا يمكن دمج otp_code مع body_params أو buttons. استخدمه فقط مع قوالب AUTHENTICATION.
نصيحة: نقاط v2 لا تستخدم شرطة مائلة نهائية. استخدم /api/v2/whatsapp/templates/{id}/send وليس /api/v2/whatsapp/templates/{id}/send/
ملاحظات التكامل
عند دمج نقطة نهاية Buzzbip هذه، استخدم https://app.buzzbip.com كمضيف إنتاج. احصل على JWT من POST /api/login_check وأرسل Authorization: Bearer في كل طلب. تأكد من تفعيل User.hasApiAccess في إدارة Buzzbip. حلّل استجابات JSend. مسارات WhatsApp v2 لا تستخدم شرطة مائلة نهائية. نفّذ إعادة المحاولة مع backoff عند حدود المعدل. خزّن بيانات الاعتماد على الخادم وأعد المصادقة قبل انتهاء JWT (3600 ثانية).
الأمان
أفضل الممارسات: بيانات الاعتماد على الخادم فقط، TLS إلزامي، مراقبة فشل المصادقة. افصل حسابات التجربة والإنتاج. وثّق القوالب والأتمتة. احذف الأرقام والمحتوى من السجلات المشتركة.
ما التالي؟
صفحات ذات صلة: api/v2/whatsapp-media api/v2/whatsapp-templates guides/whatsapp-v2-use-cases guides/whatsapp-common-gotchas
