البدء مع Developer API من WhatChimp

Updated 5 February 2026

يمنحك Developer API من WhatChimp وصولاً برمجياً إلى ميزات WhatChimp: أرسل رسائل، وأدر المشتركين، وقم بتشغيل bot flows، والمزيد، كل ذلك من خلال طلبات HTTP بسيطة. سواء كنت تبني تكاملات، أو تقوم بأتمتة سير العمل، أو تربط WhatChimp بأنظمتك الخاصة، فإن API يجعل ذلك ممكناً.

Video: https://www.youtube.com/watch?v=JPmo2B9VOM0

ما هو Developer API من WhatChimp؟

يوفر WhatChimp واجهة REST API للمطورين للتفاعل مع المنصة برمجياً. إنها واجهة API الخاصة بـ WhatChimp (وليست WhatsApp Business API مباشرة): يتولى WhatChimp التعامل مع تعقيدات WhatsApp نيابة عنك.

يمكنك إرسال رسائل، وإدارة جهات الاتصال (المشتركين)، وتشغيل bot flows، وإدارة الكتالوجات، والمزيد. تدعم API طلبات GET وPOST لمعظم endpoints.

إيجاد وحدة تحكم API

اتبع هذه الخطوات للوصول إلى وحدة تحكم API:

1. قم بتسجيل الدخول إلى حساب WhatChimp الخاص بك على app.whatchimp.com
2. انتقل إلى Settings (أيقونة الترس في الشريط الجانبي)
3. انقر على API Developer Console (أو انتقل مباشرة إلى app.whatchimp.com/api/developer/console)

تعرض وحدة تحكم API جميع endpoints المتاحة منظمة في أقسام:

• WhatsApp API: أرسل رسائل، واحصل على محادثات، وتتبع التسليم، وأدر القوالب
• Subscriber API: أنشئ، واقرأ، وحدّث، واحذف المشتركين؛ أدر التسميات والتسلسلات والحقول المخصصة
• Label API: أدرج وأنشئ التسميات
• Catalog API: أدر كتالوجات المنتجات والطلبات
• Direct Login API: أنشئ عناوين URLs لتسجيل الدخول المباشر

إنشاء مفتاح API الخاص بك

يتم عرض مفتاح API الخاص بك في الجزء العلوي من وحدة تحكم API Developer.

1. انتقل إلى وحدة تحكم API Developer
2. يظهر مفتاح API الموجود لديك تحت "Your API key"
3. لإنشاء مفتاح جديد، انقر على زر Generate API key

هام: حافظ على أمان مفتاح API الخاص بك. يمكن لأي شخص لديه مفتاح API الخاص بك الوصول إلى ميزات API لحساب WhatChimp الخاص بك. إذا كنت تشك في أن مفتاحك قد تم اختراقه، فقم بإنشاء مفتاح جديد فوراً.

المصادقة

يتطلب كل طلب API مفتاح API الخاص بك. قم بتضمينه كمعامل apiToken في كل طلب.

عنوان URL الأساسي:

https://app.whatchimp.com/api/v1/

معامل المصادقة:

إجراء الطلبات

تقبل معظم endpoints واجهة API الخاصة بـ WhatChimp طلبات GET وPOST.

طلب GET: مرر المعاملات كـ query string:

https://app.whatchimp.com/api/v1/whatsapp/send?apiToken=YOUR-API-KEY&phone_number_id=PHONE-NUMBER-ID&message=Hello&phone_number=919999999999

طلب POST: مرر المعاملات كبيانات نموذج:

curl -X POST \
  'https://app.whatchimp.com/api/v1/whatsapp/send' \
  -d 'apiToken=YOUR-API-KEY' \
  -d 'phone_number_id=PHONE-NUMBER-ID' \
  -d 'message=Hello' \
  -d 'phone_number=919999999999'

تنسيق الاستجابة

تُرجع جميع استجابات API بيانات JSON بهيكل متسق.

استجابة ناجحة:

{
  "status": "1",
  "message": "Message sent successfully."
}

استجابة خطأ:

{
  "status": "0",
  "message": "Subscriber limit has been exceeded. You cannot have more subscribers."
}

• status: "1" للنجاح، "0" للفشل
• message: وصف النتيجة، أو البيانات المطلوبة

بداية سريعة: إرسال رسالة نصية

إليك مثال كامل لإرسال رسالة نصية على WhatsApp من خلال API الخاص بـ WhatChimp:

curl -X POST \
  'https://app.whatchimp.com/api/v1/whatsapp/send' \
  -d 'apiToken=YOUR-API-KEY' \
  -d 'phone_number_id=YOUR-PHONE-NUMBER-ID' \
  -d 'message=Hello from the WhatChimp API!' \
  -d 'phone_number=919999999999'

المعاملات:

استجابة نموذجية:

{
  "status": "1",
  "wa_message_id": "wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=",
  "message": "Message sent successfully."
}

ملاحظة: يمكن إرسال الرسائل النصية فقط خلال 24 ساعة من آخر رسالة للعميل إليك (نافذة الجلسة). لإرسال رسائل إلى العملاء خارج هذه النافذة، استخدم رسالة قالب معتمدة مسبقاً. تعرف على المزيد في WhatChimp Messaging API.

المعاملات الشائعة

تظهر هذه المعاملات في العديد من endpoints واجهة API الخاصة بـ WhatChimp:

ما التالي؟

الآن بعد أن عرفت الأساسيات، استكشف API الكامل:

• WhatChimp Messaging API: أرسل رسائل نصية وقوالب، وتتبع التسليم، واحصل على سجل المحادثات
• WhatChimp Subscriber Management API: أنشئ وحدّث وأدر جهات الاتصال المشتركين لديك
• WhatChimp Bot, Catalog & Utility APIs: قم بتشغيل bot flows، وأدر الكتالوجات، والمزيد