📌 تنفيذ طلبات HTTP وحفظ الاستجابات كمتغيرات

🔹 تقوم هذه الخطوة بإرسال طلبات HTTP، وحفظ بيانات الاستجابة كمتغيرات، مما يتيح تنفيذ إجراءات متقدمة في سير العمل.
🔹 هذه الخطوة متاحة فقط في الخطط التجارية وما فوقها.

📌 التكوين

هناك إعدادان رئيسيان في خطوة طلب HTTP:

✅ طريقة طلب HTTP:
الطريقة المحددة المطلوبة لتنفيذ الطلب. اختر الطريقة المناسبة من القائمة المنسدلة.

✅ عنوان URL:

• في حقل URL، أدخل نقطة النهاية (endpoint) الخاصة بواجهة API الخارجية لاسترداد البيانات.
• لاستخدام المتغيرات داخل URL، استخدم التنسيق {{}} لدعم إدراج النصوص الثابتة والمتغيرات معًا.

ملاحظة:
يتم حظر إرسال طلبات API إلى نطاقات respond.io والنطاقات ذات العلامة البيضاء، حيث قد يؤدي ذلك إلى مشكلات في التكرار (looping issues).

✅ النص (Body):

• لضمان فك التشفير الصحيح من قبل المستلم، قم بتوسيع قسم النص وإضافة محتوى الطلب.
• تأكد من تضمين رأس Content-Type المناسب لتحديد نوع البيانات المرسلة، مما يساعد في معالجة الطلب بشكل صحيح من قبل الخادم المستلم.

✅ الرؤوس (Headers):

• يمكنك إضافة رؤوس إلى طلب HTTP على شكل أزواج.
• يمثل المفتاح (Key) اسم الرأس، بينما يمثل القيمة (Value) محتوى الرأس.
• يمكنك استخدام المتغيرات كقيم للرؤوس عن طريق إضافتها باستخدام التنسيق {{}}.

ملاحظة: يُسمح بإضافة ما يصل إلى 10 رؤوس فقط لكل طلب.

✅ تعيين الاستجابة (Response Mapping):

• بالنسبة لاستجابات API بتنسيق JSON التي تحتوي على أزواج المفتاح والقيمة (Key-Value Pairs)، يمكنك حفظ عناصر معينة من الاستجابة كمتغيرات.
• في قسم تعيين الاستجابة، أدخل المفتاح (Key) الخاص بكائن JSON في الحقل الأيسر، وقم بتعيين اسم للمتغير في الحقل الأيمن.

ملاحظات مهمة:

• يمكن حفظ الاستجابات بتنسيق JSON فقط.
• الحد الأقصى لإعدادات تعيين الاستجابة هو 10 عناصر.

📌 أمثلة على استجابات JSON

لحفظ الاستجابة بتنسيقات مختلفة، قم بإدخال مفتاح JSON المطابق للبيانات التي ترغب في حفظها.

🔹 مثال على استجابة JSON:

JSON

{
    "name": "Jason",
    "zip_codes": "12345",
    "phone": "123123"
}

✅ لحفظ رقم الهاتف من الاستجابة أعلاه، استخدم:
{{contact.phone_number}} كمفتاح JSON.

🔹 مثال آخر:

JSON

{
    "custom_fields": {
        "firstName": "John",
        "lastName": "Doe",
        "locale": "en_GB",
        "timezone": "5",
        "gender": "male",
        "phone": "123123",
        "email": "info@bevatel.com",
        "customerid": "1"
    },
    "created_at": 1575618542
}

✅ لحفظ رقم الهاتف من الاستجابة أعلاه، استخدم:
{{custom_fields.phone}} كمفتاح JSON.

🔹 مثال على استجابة تحتوي على قائمة جهات اتصال:

Json

{
    "data": {
        "id": "1776025372480910",
        "contacts": [
            {
                "firstName": "John",
                "lastName": "Doe",
                "locale": "en_GB"
            },
            {
                "firstName": "Jane",
                "lastName": "Doe",
                "locale": "en_GB"
            }
        ]
    }
}

✅ لحفظ الاسم الأول "Jane" من الاستجابة أعلاه، استخدم:
{{data.contacts[1].firstName}} كمفتاح JSON.

✅ حفظ حالة الاستجابة كمتغير:

• قم بتفعيل خيار "حفظ حالة الاستجابة كمتغير" (Save Response Status as Variable).
• أدخل اسم المتغير
  في الحقل المخصص لحفظ القيمة.

📌 كيف يعمل

🔹 عند تفعيل هذه الخطوة، سيتم إرسال طلب HTTP إلى عنوان URL المحدد، باستخدام النص (Body) والرؤوس (Headers) المعرفة مسبقًا.

🔹 إدارة سير العمل بناءً على حالة الاستجابة:

• يمكنك توجيه سير العمل بناءً على رمز حالة الاستجابة (Response Status Code).
• على سبيل المثال، يمكن إنشاء فرع (Branch) للتحقق مما إذا كان "رمز الحالة يساوي 200".
• إذا تم استلام رمز استجابة مختلف، يمكن استخدام خطوة القفز (Jump Step) لإعادة المتصل إلى خطوة طلب HTTP لمحاولة جديدة.
• إذا لم تتحقق شروط الفرع، يمكن توجيه المتصل إلى فرع الفشل (Failure Branch).
• في حال عدم وجود خطوات متابعة ضمن فرع الفشل، سينتهي سير العمل تلقائيًا.

📌 أسباب الفشل المحتملة

لتجنب فشل تنفيذ طلبات HTTP، تأكد من تلبية الشروط التالية:

✅ استخدام الطريقة الصحيحة لـ HTTP (GET, POST, PUT, DELETE...) وتحديد رأس Content-Type الصحيح.
✅ تأكد من أن Content-Type صالح، مثل: application/json.
✅ لا تقم بإدراج رقم المنفذ (Port) في عنوان URL.
✅ تجنب استخدام شهادة موقعة ذاتيًا (Self-Signed Certificate) في URL.
✅ تحقق من صحة بيانات المصادقة (Authorization) المستخدمة.
✅ تأكد من عدم حظر عناوين IP الخاصة بنا:

• 52.74.35.155
• 18.138.31.163
• 54.169.155.20

✨ باتباع هذه الإرشادات، يمكنك ضمان تنفيذ طلبات HTTP بنجاح داخل سير العمل! 🚀

📌 أفضل الممارسات

🔹 عند نجاح طلب HTTP:

1️⃣ حفظ حالة الاستجابة كمتغير
2️⃣ التحقق من نجاح الطلب باستخدام:

• خطوة الفرع (Branch Step) للتحقق مما إذا كان رمز الاستجابة 200.
• Google Sheet لتسجيل حالة الاستجابة.
• إضافة تعليق (Comment) في سير العمل.

🔹 عند فشل طلب HTTP:

1️⃣ إعادة المحاولة تلقائيًا باستخدام:

• خطوة الانتظار (Wait Step) لتأخير المحاولة التالية.
• خطوة القفز (Jump Step) لإعادة المحاولة.
  2️⃣ توثيق الأخطاء عبر:
• إضافة تعليق (Comment) يحتوي على تفاصيل الخطأ.
• استخدام Google Sheet لتسجيل الأخطاء.
  3️⃣ إسناد المهمة إلى مستخدم محدد لمعالجة المشكلة.

📌 حالات الاستخدام المقترحة

✅ توجيه المتصلين المهمين (VIP Contacts)

• استخدم خطوة طلب HTTP لجلب تفاصيل المتصل من CRM.
• بمجرد التعرف على العملاء المميزين، يمكنك:
  • توجيههم إلى وكلاء متخصصين.
  • توفير أولوية استجابة أسرع.
  • تقديم عروض أو خدمات حصرية بناءً على تصنيفهم.

✨ بهذه الطريقة، يمكنك تحسين تجربة العملاء وتعزيز ولاء العلامة التجارية! 🚀