أرسل طلب HTTP من تدفق

للوكلاء

الدليل: أرسل طلب HTTP من تدفق

هذه الصفحة: https://commentwatchdog.com/help/http-requests/send-an-http-request-from-a-flow

الموضوع: طلبات HTTP

الوقت: حوالي 5 دقائق

من يمكنه القيام بذلك: المالك أو المسؤول أو المدير

المؤلف: https://anantgupta.xyz (Anant Gupta، مؤسس CommentWatchDog)

البدء في التطبيق: https://app.commentwatchdog.com/ar/inbox

النتيجة عند الانتهاء: يرسل تدفقك بيانات إلى نظام آخر، أو يقرأ منه، ثم يسلك مخرج «نجاح» أو «فشل».

السياق: خطوة «طلب HTTP» تستدعي API نظام آخر من وسط المحادثة: تبحث عن طلب شراء، أو تتحقق من رمز بريدي، أو ترسل عميلًا محتملًا جديدًا إلى نظام CRM عندك. وهي تعمل في أي موضع من التدفق، على إنستغرام وفيسبوك. نموذج واحد يجمع كل شيء: الطريقة والعنوان، والمصادقة، والـ body، ومعاملات الاستعلام، والـ headers، مع ملء كل ما تعرفه عن الشخص عبر المتغيرات. الاستجابة الجيدة تسلك «نجاح»؛ والخطأ أو انتهاء المهلة أو غياب الاستجابة يسلك «فشل»، فلا يبقى الشخص منتظرًا أبدًا.

قبل أن تبدأ

1. خطوة «طلب HTTP» تأتي مع منشئ التدفقات، في Starter وما فوقها (وفي تجربة 7 أيام لأتمتة الرسائل الخاصة في Mini و Lite).

2. الخطوة تتصل بالخارج فقط: الأنظمة الأخرى لا تستطيع الاتصال بالتدفق.

3. المصادقة تكون Bearer token أو Basic auth أو مفتاح API؛ والمفاتيح تُحفظ مشفّرة ولا تُعرض مجددًا.

الخطوات

الخطوة 1 من 5: أضف خطوة «طلب HTTP».

المكان: افتح التدفق على اللوحة. في لوحة «الخطوات» على اليمين، اكتب HTTP في «ابحث في الخطوات» واسحب «طلب HTTP» إلى اللوحة، أو اضغط عليه لإضافته بعد الخطوة المحددة. وعلى الهاتف، «إضافة خطوة»، ثم «طلب HTTP».

الرابط: https://app.commentwatchdog.com/ar/inbox (افتح التطبيق)

لقطة شاشة: https://commentwatchdog.com/media/shots/dm-node-http.ar.webp (خطوة «طلب HTTP» على اللوحة، وإعداداتها مفتوحة على اليسار.)

لقطة شاشة: https://commentwatchdog.com/media/shots/dm-node-http-phone.ar.webp (إعدادات الخطوة على الهاتف.)

يجب أن ترى: الخطوة على اللوحة ولها مخرجان، «نجاح» و«فشل»، وإعداداتها مفتوحة بجانبها.

الخطوة 2 من 5: اختر الطريقة واكتب العنوان.

المكان: تحت «العنوان»، قرب أعلى الإعدادات: الطريقة على اليمين (GET، وتُفتح على POST و PUT و PATCH و DELETE)، ثم حقل العنوان، ثم زر المتغيرات {x}، الذي يدرج قيمًا تتغير لكل شخص، مثل https://api.zippopotam.us/us/{{zip}}. والمتغير داخل العنوان يُرمَّز تلقائيًا.

لقطة شاشة: https://commentwatchdog.com/media/shots/dm-node-http.ar.webp (العنوان، وفيه المتغير {{zip}}؛ الطريقة على يمينه، وزر المتغيرات على يساره.)

لقطة شاشة: https://commentwatchdog.com/media/shots/dm-node-http-phone.ar.webp (الأمر نفسه على الهاتف.)

يجب أن ترى: تعرض الخطوة على اللوحة الطريقة والعنوان.

الخطوة 3 من 5: املأ ما تطلبه الـ API: المصادقة، والـ body، والمعاملات، والـ headers.

المكان: يستمر النموذج تحت العنوان، قسمًا بعد قسم. «المصادقة»: «بلا مصادقة»، أو Bearer token، أو Basic auth، أو «مفتاح API» (يُرسل في header أو في الـ query string). وقسم Body (ليس لطلب GET؛ فطلب GET يرسل قيمه كمعاملات استعلام): JSON بما يصل إلى 40 حقلًا، يُرسل كل منها كـ «نص» أو «رقم» أو «صح/خطأ» أو JSON (والنقطة في المفتاح تجعله متداخلًا)، أو «نموذج»، أو «خام» (JSON أو نص عادي أو XML)، أو «بلا». «معاملات الاستعلام»: حتى 20 صفًا، تُضاف إلى العنوان بصيغة key=value. وقسم Headers: حتى 20 صفًا؛ اقفل صفًا لإبقاء قيمته سرية. و«أرسل هذا الصف» يعطّل صفًا دون حذفه.

لقطة شاشة: https://commentwatchdog.com/media/shots/dm-node-http.ar.webp («المصادقة»، أول قسم تحت العنوان.)

لقطة شاشة: https://commentwatchdog.com/media/shots/dm-node-http-phone.ar.webp (الأمر نفسه على الهاتف.)

يجب أن ترى: يمتلئ كل قسم مع تقدمك: «أضف معاملًا» و«أضف header» يعدّان صفوفهما (0/20، 1/20). والمفتاح الذي تكتبه يُحفظ مشفّرًا ثم يظهر «محفوظ ومخفي»، ومعه «استبدال».

الخطوة 4 من 5: افتح «خيارات أخرى» لضبط النجاح والمهلة وإعادة المحاولة.

المكان: «خيارات أخرى»، مطوية في أسفل النموذج؛ وسطرها يعرض الاختيارات الحالية (مثلًا «استجابة 2xx فقط · 8 ث · مرة واحدة»). «يُعدّ نجاحًا»: «استجابة 2xx فقط»، أو «أي استجابة» (وعندها تحقق من رمز الحالة في خطوة «شرط»). «المهلة»: 3 أو 5 أو 8 أو 10 ث (8 افتراضيًا). «أعد المحاولة عند الأخطاء»: «لا تُعد المحاولة»، أو «مرة واحدة»، أو «مرتان»، عند غياب الاستجابة أو استجابة 5xx، وللطلبات التي يصح إرسالها مرتين فقط.

لقطة شاشة: https://commentwatchdog.com/media/shots/dm-node-http-more.ar.webp («خيارات أخرى»، في أسفل النموذج، وعلى سطرها الاختيارات الحالية.)

لقطة شاشة: https://commentwatchdog.com/media/shots/dm-node-http-more-phone.ar.webp (الأمر نفسه على الهاتف.)

يجب أن ترى: سطر «خيارات أخرى» يعرض ما اخترته.

الخطوة 5 من 5: اربط «نجاح» و«فشل».

المكان: اسحب من نقطة «نجاح» إلى الخطوة التالية (رسالة تستخدم الاستجابة)، ومن «فشل» إلى ما يجب أن يحدث بدلًا من ذلك (تنبيه فريقك، أو التحويل إلى شخص، أو رسالة لطيفة). وعلى الهاتف، اختر كل خطوة تحت «الخطوات التالية»، في أسفل الإعدادات. ومخرج «فشل» غير المربوط بشيء ينهي التشغيل كفاشل، والشريط ينبّهك إلى ذلك.

لقطة شاشة: https://commentwatchdog.com/media/shots/dm-node-http.ar.webp (المخرجان على الخطوة، «نجاح» و«فشل»، وكل منهما مربوط بخطوته التالية.)

لقطة شاشة: https://commentwatchdog.com/media/shots/dm-node-http-more-phone.ar.webp (على الهاتف: «نجاح» و«فشل» تحت «الخطوات التالية»، ومع كل منهما الخطوة التي يقود إليها.)

يجب أن ترى: المخرجان مربوطان؛ والشريط يعرض «جاهز للتفعيل» حين لا يبقى ما يحتاج إصلاحًا.

إذا واجهت مشكلة ما

المشكلة: محظور

الحل: العنوان يشير إلى داخل شبكة خاصة (أو إلى loopback أو إلى عنوان بيانات وصفية سحابية)، لذا يُرفض حفاظًا على الأمان. استخدم العنوان العام للـ API.

المشكلة: انتهت المهلة

الحل: استغرقت الـ API أطول من المهلة المحددة في «خيارات أخرى» (10 ثوانٍ كحد أقصى). وسلك التشغيل مخرج «فشل».

المشكلة: متوقف بعد الإخفاقات

الحل: فشل العنوان 5 مرات متتالية، لذا تتوقف الطلبات إليه دقيقة ثم تُعاد المحاولة.

المشكلة: عنوان غير صالح

الحل: العنوان ليس رابط http أو https صالحًا بعد ملء متغيراته. تأكد أن للمتغير قيمة عند هذا الموضع من التدفق.

أسئلة شائعة

سؤال: هل يستطيع التدفق استدعاء أي API؟

جواب: نعم، أي API يمكن الوصول إليها عبر الإنترنت العام بطرق GET أو POST أو PUT أو PATCH أو DELETE، بلا مصادقة أو باستخدام Bearer token أو Basic auth أو مفتاح API. والعناوين داخل الشبكات الخاصة تُرفض حفاظًا على الأمان.

سؤال: هل يستطيع نظام آخر إرسال بيانات إلى تدفق؟

جواب: لا. خطوة «طلب HTTP» تتصل بالخارج من التدفق فقط؛ ولا يوجد webhook وارد يبدأ تدفقًا أو يغذّيه.

سؤال: ما أطول مدة يمكن أن ينتظرها طلب HTTP؟

جواب: 10 ثوانٍ، وهي أقصى ما تسمح به المهلة (8 افتراضيًا). الناس في منتصف محادثة، فالأقصر ألطف بهم.

سؤال: هل مفاتيح API عندي في أمان؟

جواب: قيم المصادقة وكل صف معلَّم كسري تُشفَّر عند الحفظ، وتُربط بحسابك، ولا تُعرض مجددًا، ولا حتى في سجل التشغيلات.

أدلة ذات صلة

استخدام الاستجابة في تدفقك: https://commentwatchdog.com/help/http-requests/use-the-answer-in-your-flow

الصق أمر cURL: https://commentwatchdog.com/help/http-requests/paste-a-curl-command

إنشاء الطلب بالذكاء الاصطناعي: https://commentwatchdog.com/help/http-requests/build-the-request-with-ai

النص العادي لهذا الدليل: https://commentwatchdog.com/help/http-requests/send-an-http-request-from-a-flow.md

كل الأدلة للمساعدين: https://commentwatchdog.com/help/llms.txt