كيفية ربط نظامك مع ZentraMsg

دليل عملي شامل لربط متجرك أو نظامك الداخلي مع ZentraMsg لإرسال الرسائل وإدارتها تلقائيًا عبر الواتساب.

أهمية الربط مع ZentraMsg

يمكنك إرسال رسائل التأكيد، الأكواد (OTP)، تحديثات الطلبات، أو العروض تلقائيًا باستخدام رقم واتساب الخاص بك بسهولة وبشكل احترافي.

ما تحتاجه قبل الربط

1️⃣ حساب مفعل على ZentraMsg مع إضافة جهاز واتساب.
2️⃣ الوصول لصفحة API Developer للحصول على API Token.
3️⃣ إعداد Webhook بنظامك (اختياري) لاستقبال الرسائل الواردة.

خطوات الربط مع ZentraMsg

1. الحصول على API Token:
انتقل إلى "API Developer" من لوحة التحكم وأضف API Token جديد واختر الجهاز المطلوب ثم انسخ التوكن للاستخدام.

2. إعداد Webhook (اختياري):
لربط استقبال رسائل العملاء داخل نظامك يمكنك إضافة رابط Webhook الخاص بك في إعدادات الجهاز داخل ZentraMsg.

3. تجربة إرسال رسالة:
يمكنك تجربة إرسال رسالة باستخدام الكود التالي:

curl --location 'https://api.zentramsg.com/v1/messages' \
--header 'x-api-token: YOUR_API_TOKEN' \
--form 'device_uuid="YOUR_DEVICE_UUID"' \
--form 'type_message="text"' \
--form 'type_contact="numbers"' \
--form 'ids="201030025254"' \
--form 'text_message="مرحبًا بك في ZentraMsg"' \
--form 'timezone="Africa/Cairo"'

4. تكامل API مع نظامك:
يمكنك إعداد نظامك لإرسال طلبات POST إلى API لإرسال الرسائل تلقائيًا عند التسجيل، تحديث الطلبات أو إرسال العروض.
المتطلبات:

device_uuid
type_message
type_contact
ids
text_message أو media_url
timezone (اختياري)

أمثلة عملية مع كود Curl

1️⃣ إرسال OTP بعد التسجيل:

curl --location 'https://api.zentramsg.com/v1/messages' \
--header 'x-api-token: YOUR_API_TOKEN' \
--form 'device_uuid="YOUR_DEVICE_UUID"' \
--form 'type_message="text"' \
--form 'type_contact="numbers"' \
--form 'ids="201030025254"' \
--form 'text_message="رمز التحقق الخاص بك هو: 456789"' \
--form 'timezone="Africa/Cairo"'

2️⃣ إرسال تحديث حالة الطلب:

curl --location 'https://api.zentramsg.com/v1/messages' \
--header 'x-api-token: YOUR_API_TOKEN' \
--form 'device_uuid="YOUR_DEVICE_UUID"' \
--form 'type_message="text"' \
--form 'type_contact="numbers"' \
--form 'ids="201030025254"' \
--form 'text_message="تم تحديث حالة طلبك إلى: جاري التجهيز."' \
--form 'timezone="Africa/Cairo"'

3️⃣ إرسال رابط تقييم الخدمة:

curl --location 'https://api.zentramsg.com/v1/messages' \
--header 'x-api-token: YOUR_API_TOKEN' \
--form 'device_uuid="YOUR_DEVICE_UUID"' \
--form 'type_message="text"' \
--form 'type_contact="numbers"' \
--form 'ids="201030025254"' \
--form 'text_message="شكرًا لاستخدامك خدماتنا، نرجو تقييم تجربتك عبر الرابط: https://yourstore.com/review"' \
--form 'timezone="Africa/Cairo"'

4️⃣ إرسال عروض وتنبيهات للعملاء:

curl --location 'https://api.zentramsg.com/v1/messages' \
--header 'x-api-token: YOUR_API_TOKEN' \
--form 'device_uuid="YOUR_DEVICE_UUID"' \
--form 'type_message="text"' \
--form 'type_contact="group"' \
--form 'ids="YOUR_GROUP_ID"' \
--form 'text_message="عرض خاص اليوم: خصم 20% عند الطلب الآن."' \
--form 'timezone="Africa/Cairo"'