الخطوة: طلب HTTP

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

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

الإعدادات

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

طريقة طلب HTTP

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

عنوان ويب

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

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

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

الجسم

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

رؤوس الصفحات

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

تخطيط الاستجابة

لـ JSON API مع أزواج القيمة الرئيسية، يمكنك حفظ عناصر استجابة محددة كمتغيرات. في قسم رسم الخرائط، أدخل مفتاح كائن JSON على اليسار وقم بتعيين اسم للمتغير على اليمين. تذكر أنه لا يمكن حفظ إلا ردود JSON، ولا يمكنك الحصول على أكثر من 10 إعدادات لتخطيط الاستجابة.

أمثلة:

لحفظ استجابة بأشكال مختلفة، قم بتعبئة مفتاح JSON المقابل للبيانات التي تريد حفظها.

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

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

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

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

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

لحفظ الاسم الأول 'Jane' من الرد الوارد أعلاه، استخدم $.data.contacts[1].firstName

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

لحفظ حالة الاستجابة من طلب 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 و غير محددة.

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

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

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

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

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

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

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

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

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

3. ورقة جوجل للرصد:

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

4. التعليق:

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

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

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

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

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

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

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

3. تعليق:

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

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

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

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

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

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

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

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

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