Whatsapp Template 4jawaly

4jawaly WhatsApp Templates

الثابت في كل الطلبات

• Endpoint: POST https://api-users.4jawaly.com/api/v1/whatsapp/{PROJECT_ID} — PROJECT_ID متغيّر حسب الحساب (مثال: 591)، اقرأه من env JAWALY_WA_PROJECT_ID.
• Headers: accept: application/json, Content-Type: application/json, Authorization: Basic {{TOKEN}} (نفس التوكن للقوالب الثلاثة).
• path: دائماً "message/template".
• language: {"policy":"deterministic","code":"ar"}.
• namespace: "d62f7444_aa0b_40b8_8f46_0bb55ef2862e".

المتغيرات في كل طلب

• phone: رقم المستلم دولي بدون +.
• template: اسم القالب المفعّل من Meta.
• params: مصفوفة المكوّنات (body/button/header) — تعتمد على متغيرات القالب.

الشكل العام

{
  "path": "message/template",
  "params": {
    "phone": "{{PHONE}}",
    "template": "{{TEMPLATE_NAME}}",
    "language": {"policy":"deterministic","code":"ar"},
    "namespace": "d62f7444_aa0b_40b8_8f46_0bb55ef2862e",
    "params": [ /* مكوّنات */ ]
  }
}

الحالة 1 — قالب بدون متغيرات

params: [] فقط. مثال (not4j2):

{"path":"message/template","params":{
  "phone":"{{PHONE}}","template":"not4j2",
  "language":{"policy":"deterministic","code":"ar"},
  "namespace":"d62f7444_aa0b_40b8_8f46_0bb55ef2862e",
  "params":[]}}

الحالة 2 — قالب بـ body متغيّر متعدد (مثال account_pricing_update_notification بـ 4 متغيرات)

"params": [
  {"type":"body","parameters":[
    {"type":"text","text":"{{BODY_1}}"},
    {"type":"text","text":"{{BODY_2}}"},
    {"type":"text","text":"{{BODY_3}}"},
    {"type":"text","text":"{{BODY_4}}"}
  ]}
]

الحالة 3 — body + زر URL ديناميكي (مثال OTP gocode)

"params": [
  {"type":"body","parameters":[{"type":"text","text":"{{OTP_CODE}}"}]},
  {"type":"button","index":0,"sub_type":"URL",
   "parameters":[{"type":"text","text":"{{OTP_CODE}}"}]}
]

القاعدة المستنتجة

ثبّت كل العوامل (endpoint, auth, namespace, language, path) واملأ فقط: phone, template, ومحتوى params. عدد عناصر parameters داخل body = عدد المتغيرات {{1}}..{{N}} المعتمَدة في القالب من Meta. أي إضافة/نقصان يُعيد الخطأ من Meta.

curl موحّد

curl -X POST "https://api-users.4jawaly.com/api/v1/whatsapp/$PROJECT_ID" \
  -H "accept: application/json" -H "Content-Type: application/json" \
  -H "Authorization: Basic $TOKEN" \
  -d @template.json

تلميحات للوكيل

• لا تخمّن أسماء القوالب — يجب أن تكون موافَقاً عليها من Meta لنفس namespace.
• ترتيب parameters يجب أن يطابق ترتيب {{1}}..{{N}} في القالب.
• للأزرار: index يبدأ من 0 ويطابق ترتيب الأزرار في القالب، و sub_type ∈ URL | QUICK_REPLY.
• لا تُسجّل Authorization في اللوقات.