الخطوة: طلب HTTP

تتيح لك هذه الخطوة إرسال طلبات HTTP وحفظ استجاباتها كمتغيرات.

هذه الخطوة متاحة فقط في خطة Advanced أو أعلى.

إعدادات

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

طريقة طلب HTTP

الطريقة المحددة المطلوبة للطلب. اختر الطريقة المناسبة من القائمة المنسدلة.

عنوان URL

في حقل عنوان URL، أدخل نقطة نهاية عنوان URL لواجهة برمجة التطبيقات الخارجية لاسترداد البيانات. لتضمين المتغيرات، استخدم البادئة "$" لدعم استيفاء النص الثابت والمتغيرات.

بإمكانك الآن استخدام عناوين IP وأرقام المنافذ في خطوة طلب HTTP، مما يتيح لك الوصول المباشر إلى الخوادم والمرونة للوصول إلى الخدمات على المنافذ غير القياسية.

يرجى ملاحظة أن نطاق respond.io مدرج في القائمة السوداء. لا يُسمح بإرسال استدعاء API إلى هذا النطاق، لأنه قد يتسبب في حدوث حلقات متكررة.

جسم

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

العناوين

في قسم الرأس، يمكنك إضافة رؤوس إلى طلب HTTP في أزواج. يمثل المفتاح اسم الرأس، وتمثل القيمة قيمة الرأس. يمكنك استخدام المتغيرات كعناوين عن طريق إضافة البادئة "$". ومع ذلك، تذكر أنه لا يُسمح إلا بما يصل إلى 10 رؤوس.

رسم خرائط الاستجابة

بالنسبة لاستجابات API بتنسيق JSON، يمكنك حفظ قيم الاستجابة المحددة كالمتغيرات الديناميكية. في قسم تعيين الاستجابة، أدخل مسار/مرجع JSON للقيمة على اليسار وقم بتعيين اسم المتغير على اليمين.

يجب أن يحتوي حقل JSON Key على مسار/مرجع JSON للقيمة التي تريد حفظها، بدءًا من جذر الاستجابة باستخدام `$`. على سبيل المثال، بالنسبة لـ `{"phone":"123123"}`، أدخل `$.phone`، وليس `phone`.

أمثلة:

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

{  
    "الاسم": "جيسون"،  
    "الرموز البريدية": "12345"،  
    "الهاتف": "123123"  
}

لحفظ رقم الهاتف من الاستجابة أعلاه، أدخل $.phone في حقل JSON Key.

{ 
    "الحقول المخصصة": {  
        "الاسم الأول": "جون"،  
        "اسم العائلة": "دو"،  
        "الموقع": "en_GB"،  
        "المنطقة الزمنية": "5"،  
        "الجنس": "ذكر"،  
        "الهاتف": "123123"،  
        "البريد الإلكتروني": "zy@respond.io"،  
        "معرف العميل": "1"  
    }،  
    "تاريخ الإنشاء": 1575618542  
}

لحفظ رقم الهاتف من الاستجابة أعلاه، أدخل $.custom_fields.phone في حقل JSON Key.

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

لحفظ الاسم الأول 'Jane' من الاستجابة أعلاه، أدخل $.data.contacts[1].firstName في حقل JSON Key.

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

لحفظ حالة الاستجابة من طلب HTTP كمتغير، قم بتشغيل مفتاح التبديل حفظ حالة الاستجابة كمتغير . ثم قم بتسمية المتغير في الحقل المخصص.

كيف يعمل

عند تفعيل هذه الخطوة، ستقوم بإرسال طلب HTTP إلى عنوان URL المحدد، باستخدام النص والرأس المحددين.

بإمكانك توجيه سير العمل استنادًا إلى حالة الاستجابة. على سبيل المثال، يمكنك إنشاء فرع لحالة "رمز يساوي 200". إذا تم تلقي أي رمز حالة استجابة آخر، فقد تقوم خطوة الانتقال بإرجاع جهات الاتصال إلى خطوة طلب HTTP. وبدلاً من ذلك، يمكن توجيه جهة الاتصال إلى فرع الفشل إذا لم يتم استيفاء شروط الفرع. إذا لم يتم إعداد أي خطوات ضمن فرع الفشل، فسوف ينتهي سير العمل.

إذا تجاوز طلب HTTP الخاص بك 10 ثوانٍ، فسيؤدي ذلك إلى انتهاء المهلة، مما يتسبب في فشل الطلب.

الفشل المحتمل

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

• استخدم طريقة HTTP الصحيحة ورأس نوع المحتوى.

• تأكد من تضمين البروتوكول المطلوب http:// أو https:// في عنوان URL الخاص بك بناءً على ما يدعمه نظامك لتجنب فشل الطلب.

• تأكد من أن نوع المحتوى صالح.

• استبعاد رقم المنفذ من عنوان URL.

• تجنب استخدام شهادة موقعة ذاتيًا في عنوان URL.

• تأكد من صحة الترخيص.

• تأكد من عدم حظر عناوين IP الخاصة بنا (52.74.35.155، 18.138.31.163، 54.169.155.20).

إذا لم يتم استيفاء أي من الشروط المذكورة أعلاه، فسوف يقوم جهة الاتصال بتخطي هذه الخطوة والاستمرار في الرحلة المتبقية.

عند التحقق من مخرجات طلب HTTP باستخدام متغيرات ديناميكية، تذكر أن المتغيرات التي لا تحتوي على قيمة ستعود كـ null و undefined.

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

فيما يلي بعض أفضل الممارسات لهذه الخطوة التي يمكنك اتباعها لتحسين سير عملك:

عندما يكون طلب HTTP ناجحًا

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

   1. تأكد من أن الخطوة الأولى هي حفظ حالة الاستجابة كمتغير للإجراءات التالية.

2. خطوة الفرع:

   1. أضف خطوة فرعية لتقييم حالة طلب HTTP.

   2. إذا كانت الحالة 200، فإن الطلب ناجح.

   3. إذا لم يكن الأمر كذلك، فقم بتكوين تنبيه لإعلام المدير بشأن الطلب غير الناجح.

3. Google Sheetللمراقبة:

   1. قم بتسجيل حالة الاستجابة في ورقة Google للحصول على رؤية واضحة لنجاح أو فشل الطلبات.

4. تعليق:

   1. أضف تعليقًا في سير عملك لتوثيق حالة الاستجابة. سيساعدك هذا على تتبع الأخطاء ومراجعتها بكفاءة أكبر.

عندما يفشل طلب HTTP

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

   1. كما في الطلب الناجح، حفظ حالة الاستجابة كمتغير لمعالجة الأخطاء.

2. استخدم خطوة الانتظار أو القفز لإعادة المحاولة:

   1. قم بتنفيذ خطوة الانتظار لإيقاف مؤقت قبل إعادة محاولة تنفيذ طلب غير ناجح.

   2. بدلاً من ذلك، استخدم خطوة القفز للرجوع إلى خطوة طلب HTTP ومحاولة الطلب مرة أخرى.

3. تعليق:

   1. قم بتوثيق الخطأ عن طريق إنشاء تعليق لتسجيل خطأ طلب HTTP

   2. قم بتضمين تفاصيل الاتصال وقم بوضع علامة على الشخص المسؤول.

4. ورقة جوجل للمراقبة:

   1. استخدم خطوة Google Sheet لتسجيل معلومات الاتصال وتفاصيل الخطأ للمراقبة والمراجعة.

5. تعيين المهمة:

   1. تعيين المهمة لمستخدم محدد لبدء عملية أخرى ضمن سير العمل ومحاولة مرة أخرى.

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

فيما يلي بعض الطرق التي يمكنك من خلالها استخدام خطوة طلب HTTP:

• وجّه جهات اتصال VIP: استخدم خطوة HTTP Request لجلب تفاصيل جهات الاتصال من مستودع بيانات مثل CRM. يتيح لك هذا تحديد جهات الاتصال VIP، مما يسمح بحصولك على تجربة عملاء مخصصة وتمييزها عن جهات الاتصال غير VIP.