إرسال الإجابات إلى n8n
شغّل سير عمل في n8n مع كل إجابة تتلقاها حملة، أو من خطوة في سير عمل Polzy — على n8n Cloud أو على خادمك. اربط n8n مرة واحدة، ثم أعطِ كل حملة رابط سير عملها.
في هذه الصفحة
n8n أداة لسير العمل يمكنك تشغيلها في سحابتها أو على خادمك الخاص. عند ربط n8n، تشغّل كل إجابة تتلقاها حملة أحد مسارات n8n الخاصة بك، ويمكن لسير عمل في Polzy أيضًا تشغيل واحد. في نهاية هذا الدليل سيكون لديك سير عمل في n8n يستقبل إجاباتك، و— إذا أضفت مفتاح API — قائمة بمساراتك تختار منها بدلًا من عناوين تلصقها.
يتوفر n8n في خطة أعمال. لا يستطيع ربطه واختيار وجهة إجابات الحملة إلا المسؤول.
قبل أن تبدأ
تحتاج إلى:
- مساحة عمل على خطة أعمال، ودور مسؤول فيها.
- تفعيل التكاملات لمساحة العمل، من الإعدادات ← عام ← ما تقوم به مساحة العمل هذه.
- سير عمل في n8n يبدأ بعقدة Webhook تقبل
POST، ومنشور لكي يعمل رابط الإنتاج الخاص به. - نسخة n8n يمكن الوصول إليها من الإنترنت عبر HTTPS. يرفض Polzy العناوين داخل شبكة خاصة.
- اختياريًا، مفتاح API لـ n8n، ليتمكن Polzy من عرض مساراتك بأسمائها. لا يتيح n8n واجهته البرمجية خلال الفترة التجريبية المجانية.
تجهيز سير العمل في n8n
- في n8n، ابدأ سير العمل بعقدة Webhook واضبط طريقتها على
POST. - في إعداد Respond للعقدة، اختر Immediately، ليتلقى Polzy ردًا فورًا بينما يعمل باقي المسار. ينتظر Polzy 30 ثانية كحد أقصى.
- انشر سير العمل وانسخ Production URL الخاص بالعقدة — لا رابط الاختبار، الذي لا يعمل إلا أثناء الاستماع في المحرر.
يصف n8n العقدة في n8n: Webhook node.
ربط n8n بـ Polzy
- في الشريط الجانبي، ضمن الأتمتة، افتح التكاملات واختر علامة التبويب متاحة.
- ابحث عن n8n واختر ربط.
- لاختيار المسارات بأسمائها، املأ كلًا من عنوان URL الخاص بمثيل n8n — العنوان الذي تفتح عليه n8n — وAPI Key. ولكي تلصق عناوين المسارات بدلًا من ذلك، اترك الحقلين فارغين: فإما كلاهما وإما لا شيء.
- اختر اختبار الاتصال. عند ملء الحقلين يرد Polzy بـ Connected to n8n؛ وعند تركهما فارغين بـ Connected. Each step names the n8n workflow it starts.
- اختر ربط.
لإنشاء مفتاح API، افتح في n8n Settings → n8n API واختر Create an API key — راجع n8n: API authentication. يُحفظ المفتاح مشفّرًا.
إعطاء الحملة سير عملها
- افتح الحملات، ثم الحملة وعلامة التبويب التكاملات الخاصة بها.
- ضمن إضافة اتصال، ابحث عن n8n واختر اتصال. إذا ظهر على الزر إعداد، فهذا يعني أن n8n لم يُربط بمساحة العمل بعد.
- في رابط سير العمل، الصق رابط الإنتاج لسير العمل الذي يجب أن تشغّله هذه الإجابات.
- اختر حفظ التغييرات.
يظهر n8n بعد ذلك ضمن متصل بهذه الحملة، مع مفتاحه، وتعديل الإعداد، وقطع الاتصال، وعدد الإجابات المرسلة.
ما يستقبله n8n
كل إجابة طلب POST بمتن JSON:
| الحقل | ما يحتويه |
|---|---|
event | survey.response لإجابة الحملة، وworkflow.step من سير عمل في Polzy. |
timestamp | وقت إرسال الطلب. وفي الإجابة المجهولة، اليوم الذي قُدّمت فيه. |
data.survey.id, data.survey.title | معرّف الاستبيان وعنوانه. |
data.response.id | معرّف الإجابة في Polzy. فارغ في الإجابة المجهولة. |
data.response.submittedAt | وقت إكمال الإجابة. وفي الإجابة المجهولة، اليوم فقط. |
data.response.answers | عنصر لكل سؤال أُجيب عنه، يحتوي كل منها على questionId وquestionText وvalue. |
data.response.score | الدرجة الإجمالية، إذا كانت قد حُسبت وقت إرسال الطلب. |
عندما يكون للاتصال مفتاح API ويكون رابط سير العمل على المضيف نفسه الخاص بـ عنوان URL الخاص بمثيل n8n، يحمل الطلب أيضًا المفتاح في الترويسة X-N8N-API-KEY. أما سير العمل على مضيف آخر فيُستدعى دونه.
تحمل الإجابة المجهولة ما قالته ودرجتها ويومها، ولا شيء يمكن أن يكشف صاحبها أو يحدد وقتها. وينتظر Polzy فحص السلامة لكل إجابة، لمدة تصل إلى 10 دقائق، قبل إرسالها. لا يحجب الحد الأدنى لحجم المجموعة الإجابات المفردة.
تشغيل n8n من سير عمل في Polzy
- افتح سير العمل ثم سير العمل المطلوب، أو أنشئ واحدًا جديدًا.
- ضمن الموصلات في الخطوات المثبتة، اسحب تشغيل مسار n8n · n8n إلى لوحة العمل.
- في رابط سير العمل، اختر أحد مساراتك النشطة التي تبدأ بعقدة Webhook — تظهر عندما يكون للاتصال مفتاح API — أو الصق رابط الإنتاج الخاص به.
- اترك الحمولة فارغة لإرسال كل ما يعرفه التشغيل، أو اكتب JSON الذي تريده، مع
{{لإدراج قيم من التشغيل. - اختر إرسال اختبار لإرسال طلب واحد مملوء بإجابة نموذجية، ثم شاهده في Executions في n8n.
تمرّر الخطوة رد n8n باسم {{connector.statusCode}} و{{connector.response}} — ومع ضبط Respond على When Last Node Finishes، يكون ذلك نتيجة سير عملك.
ليست لديك خطة أعمال؟ ترسل الخطوة ويب هوك صادر في سير العمل إلى أي عنوان، بما في ذلك عقدة Webhook في n8n، دون ربط n8n. يتوفر سير العمل في خطة فريق. راجع سير العمل.
التحقق من أنه يعمل
في علامة التبويب التكاملات للحملة، يحتسب سطر النشاط الإجابات المرسلة وتلك التي فشلت. وتعرض صفحة n8n في Polzy كل عملية إرسال ضمن النشاط، مع نجح أو فشل والسبب، وتعرض علامة التبويب Executions في n8n كل تشغيل من جهته.
حل المشكلات
- The instance URL and the API key go together. امتلأ واحد فقط من الحقلين. املأ كليهما أو أفرغ كليهما.
- n8n refused this API key. المفتاح خاطئ أو منتهي الصلاحية أو محذوف. أنشئ مفتاحًا جديدًا من Settings → n8n API.
- n8n answered, but its public API is switched off. Enable it in n8n's settings. الواجهة البرمجية معطلة على خادمك — راجع n8n: Disable the public REST API. أعد تفعيلها، أو اربط دون مفتاح.
- private addresses are not allowed. يشير العنوان إلى شبكة خاصة. لا يستطيع Polzy الوصول إلا إلى n8n موجود على الإنترنت.
- only https endpoints are allowed. يجب أن يبدأ الرابط بـ
https://. - Request failed with status code 404 (ضمن النشاط). سير العمل غير منشور، أو أن الرابط هو رابط الاختبار. انشره واستخدم Production URL.
- سير عملك غير موجود في قائمة رابط سير العمل. لا تظهر إلا المسارات النشطة التي تبدأ بعقدة Webhook. انشره، أو الصق رابطه.
الإجابات التي وصلت قبل حفظ الرابط، أو أثناء إيقاف المفتاح، لا تُرسل لاحقًا. صدّرها بدلًا من ذلك من الردود في الاستبيان.
معلومات مفيدة
- هل يفشل سير العمل البطيء؟ الطلب الذي لا يرد عليه n8n خلال 30 ثانية يُعد فاشلًا ويُعاد، حتى ثلاث مرات إجمالًا. اختر Immediately لتجنّب ذلك.
- هل يمكن لـ n8n التحقق من أن الاستدعاء يأتي من Polzy؟ لا يذهب مفتاح API إلا إلى مثيلك الخاص. ولحماية عقدة Webhook بمفردها، يوفر n8n المصادقة بالترويسة؛ ولا يرسل اتصال n8n في Polzy أي ترويسة أخرى.
- هل يمكن لـ n8n إرسال بيانات إلى Polzy؟ ليس عبر هذا الاتصال. يمكن لسير عمل في Polzy أن يبدأ بـ ويب هوك وارد — راجع الويب هوك.
روابط مفيدة
مقالات ذات صلة
يمكن للأعضاء المسجّلين سؤال Polzy أو مراسلة الفريق من صفحة الدعم. تعتمد سرعة ردّنا على خطتك.