مرجع API

Buzzbip — واجهة إرسال قالب v2

POST /api/v2/whatsapp/templates/{TEMPLATE_ID}/send مع to وcountry_code وbody_params وbuttons وheader_media_id وotp_code.

نظرة عامة

أرسل قالب 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"]
  }'

Parameter	Type	Required	Description
`TEMPLATE_ID`	`integer`	Required	Template id (path). Must be APPROVED before sending.
`to`	`string`	Required	Recipient phone, digits only, no +, no spaces, no dashes. Example: "21696816277"
`country_code`	`string`	Required	ISO 3166-1 alpha-2 country code. Examples: TN, SA, FR, US, MA, DZ
`body_params`	`string[]`	Optional	Values for {{1}} {{2}} {{3}} body placeholders in order. Count must match placeholder count. Omit when template has no body placeholders.
`buttons`	`array`	Optional	Per-recipient button overrides. Each item: index (zero-based), sub_type (url or copy_code), value (replacement string).
`header_media_id`	`integer`	Optional	media_id from POST /api/v2/whatsapp/media. Overrides template header media for this send (IMAGE, VIDEO, DOCUMENT). User-scoped.
`document_filename`	`string`	Optional	Filename shown in WhatsApp for DOCUMENT headers. Ignored for IMAGE and VIDEO.
`otp_code`	`string`	Optional	AUTHENTICATION templates only. API inserts code into body and Copy Code button. Cannot combine with body_params or buttons.

ملاحظات الاستخدام

⚠️ ملاحظة: يجب أن يطابق عدد 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 إلزامي، مراقبة فشل المصادقة. افصل حسابات التجربة والإنتاج. وثّق القوالب والأتمتة. احذف الأرقام والمحتوى من السجلات المشتركة.

ما التالي؟

Was this helpful?

مرجع API

Buzzbip — واجهة إرسال قالب v2

POST /api/v2/whatsapp/templates/{TEMPLATE_ID}/send مع to وcountry_code وbody_params وbuttons وheader_media_id وotp_code.

نظرة عامة

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"]
  }'

Parameter	Type	Required	Description
`TEMPLATE_ID`	`integer`	Required	Template id (path). Must be APPROVED before sending.
`to`	`string`	Required	Recipient phone, digits only, no +, no spaces, no dashes. Example: "21696816277"
`country_code`	`string`	Required	ISO 3166-1 alpha-2 country code. Examples: TN, SA, FR, US, MA, DZ
`body_params`	`string[]`	Optional	Values for {{1}} {{2}} {{3}} body placeholders in order. Count must match placeholder count. Omit when template has no body placeholders.
`buttons`	`array`	Optional	Per-recipient button overrides. Each item: index (zero-based), sub_type (url or copy_code), value (replacement string).
`header_media_id`	`integer`	Optional	media_id from POST /api/v2/whatsapp/media. Overrides template header media for this send (IMAGE, VIDEO, DOCUMENT). User-scoped.
`document_filename`	`string`	Optional	Filename shown in WhatsApp for DOCUMENT headers. Ignored for IMAGE and VIDEO.
`otp_code`	`string`	Optional	AUTHENTICATION templates only. API inserts code into body and Copy Code button. Cannot combine with body_params or buttons.

ملاحظات الاستخدام

نصيحة: نقاط v2 لا تستخدم شرطة مائلة نهائية. استخدم /api/v2/whatsapp/templates/{id}/send وليس /api/v2/whatsapp/templates/{id}/send/

ملاحظات التكامل

الأمان

ما التالي؟

Was this helpful?

Buzzbip — واجهة إرسال قالب v2

نظرة عامة

POST /api/v2/whatsapp/templates/{TEMPLATE_ID}/send

ملاحظات الاستخدام

ملاحظات التكامل

الأمان

ما التالي؟

Need help with your integration?

Buzzbip — واجهة إرسال قالب v2

نظرة عامة

POST /api/v2/whatsapp/templates/{TEMPLATE_ID}/send

ملاحظات الاستخدام

ملاحظات التكامل

الأمان

ما التالي؟

Need help with your integration?