هل هذه المادة مفيدة؟

كيف أبلينا؟

مشكلة مع النظام الأساسي؟ تواصل مع فريق الدعم هنا.

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

الخطوة: طلب 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.

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

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

الخطوة: التاريخ والوقت

الخطوة: إضافة صف أوراق جوجل

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

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

اتصل بنا
© 2023 Respond.io.
Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)