الحصول على قائمة القوالب عبر WhatChimp API
استرجاع جميع قوالب WhatsApp مع حالة الموافقة وأنواع الأزرار
Updated 10 February 2026
استرجاع جميع قوالب رسائل WhatsApp المرتبطة برقم هاتفك — تحقق من حالة الموافقة، واعرض متغيرات القالب، وافحص أنواع الأزرار قبل إرسال الرسائل.
قبل البدء: تأكد من أن لديك بيانات اعتماد WhatChimp API جاهزة.
نقطة النهاية
GET/POST /api/v1/whatsapp/template/list
المعاملات
| المعامل | النوع | مطلوب | الوصف |
|---|---|---|---|
apiToken | String | نعم | رمز WhatChimp API الخاص بك |
phone_number_id | String | نعم | معرف رقم هاتف WhatsApp Business الخاص بك |
أمثلة الطلب
طلب GET:
curl -X GET "https://app.whatchimp.com/api/v1/whatsapp/template/list?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID"طلب POST (cURL):
curl -X POST https://app.whatchimp.com/api/v1/whatsapp/template/list \
-H "Content-Type: application/json" \
-d '{
"apiToken": "API-KEY",
"phone_number_id": "PHONE-NUMBER-ID"
}'الاستجابة
استجابة النجاح:
{
"status": "1",
"message": {
"id": 48,
"template_id": "437509121867805",
"template_name": "ada",
"template_type": "single",
"locale": "en_US",
"header_type": "media",
"header_subtype": "image",
"body_content": "To send an interactive message template...",
"button_type": "none",
"status": "Rejected"
}
}حقول الاستجابة
| الحقل | الوصف |
|---|---|
id | معرف القالب الداخلي لـ WhatChimp (استخدم هذا عند إرسال القوالب عبر API) |
template_id | معرف القالب الداخلي لـ Meta |
template_name | اسم القالب |
locale | رمز اللغة (مثال: en_US, es_ES) |
header_type | نوع الرأس: text أو media أو none |
body_content | نص محتوى الرسالة |
button_type | نوع الزر: quick_reply أو call_to_action أو none |
status | حالة الموافقة: Approved أو Rejected أو Pending |
variable_map | خريطة متغيرات القالب |
مهم: استخدم حقل id (وليس template_id) عند إرسال القوالب عبر API. template_id هو المعرف الداخلي لـ Meta.
حالات الاستخدام
- التحقق من القوالب المعتمدة قبل الإرسال
- العثور على template_id لـ API الإرسال
- فحص button_type و variable_map قبل إنشاء الرسائل
- التحقق من حالة القالب برمجيًا