جدول المحتويات

الخطوة: طلب HTTP

Shing-Yi Tan محدث بواسطة Shing-Yi Tan

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

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

إعدادات

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

أسلوب طلب HTTP

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

URL

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

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

جسم

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

الرؤوس

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

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

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

أمثلة:

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

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

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

 {
 "custom_fields": {
 "firstName": "John",
 "lastName": "Doe",
 "locale": "en_GB",
 "timezone": "5",
 "gender": "male",
 "phone": "123123",
 "email": "zy@ respond.io ",
 "customerid": "1"
 },
 "created_at": 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 ، تأكد من استيفاء الشروط التالية:

  • استخدم طريقة HTTP الصحيحة ورأس نوع المحتوى.
  • تأكد من أن نوع المحتوى صالح.
  • استبعد رقم المنفذ من عنوان URL.
  • تجنب استخدام شهادة موقعة ذاتيًا في عنوان URL.
  • تحقق من أن التفويض صالح.
  • تأكد من عدم حظر عناوين IP الخاصة بنا (52.74.35.155 ، 18.138.31.163 ، 54.169.155.20).

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

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

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

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

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

وقائع الاستخدام المقترحة

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

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

يشعر بالضيق؟ لا تخف.

احتاج مساعدة؟ اتصل بنا للحصول على الدعم. المساعدة هنا!

الخطوة: تشغيل سير عمل آخر

الخطوة: إضافة صف إلى جداول بيانات Google

ليس ما كنت تبحث عنه؟

تحدث إلى خبير هنا!

اتصل بالدعم
شركة
معلومات عنا Roadmap برنامج الشركاء
سياسات الشروط
سياسة الخصوصية سياسة ملفات تعريف الارتباط شروط الخدمة
موارد
مركز المطوّر حاسبة أسعار استخدام WhatsApp أداة إنشاء الروابط على WhatsApp
© 2024 Respond.io.
حالة الأمن
ISO 27001 Certified.
Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)