إرسال الإجابات إلى نقطة نهايتك عبر الويب هوك

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

أي ويب هوك تحتاج؟

يمكن لـ Polzy استدعاء خادمك بثلاث طرق:

للأحداث على مستوى مساحة العمل كلها، راجع إرسال الويب هوك واستقباله.

قبل أن تبدأ

تحتاج إلى:

• مساحة عمل على خطة أعمال، ودور مسؤول فيها.
• تفعيل التكاملات لمساحة العمل، من الإعدادات ← عام ← ما تقوم به مساحة العمل هذه.
• نقطة نهاية على الإنترنت، عبر HTTPS، تقبل POST بمتن JSON وترد بحالة 2xx خلال 10 ثوانٍ. يرفض Polzy عناوين http:// والعناوين داخل شبكة خاصة.

ربط موصل Webhooks

عند الربط يُحفظ ما تشترك فيه كل الطلبات: سر التوقيع وأي ترويسات.

1. في الشريط الجانبي، ضمن الأتمتة، افتح التكاملات واختر علامة التبويب متاحة.
2. ابحث عن Webhooks واختر ربط.
3. في سر التوقيع، أدخل قيمة عشوائية طويلة واحتفظ بنسخة منها لخادمك.
4. ضمن ترويسات HTTP، أضِف أي ترويسات تريد إرسالها، مثل Authorization. تُحفظ قيمها مشفّرة. راجع معلومات مفيدة لمعرفة وجهتها.
5. اختر ربط. يرد الاختبار بـ Connected. Each survey and step names the endpoint it posts to.

تكامل

ربط Webhooks

تُشفَّر المفاتيح وتُستخدم نيابةً عنك فقط.

بيانات الاعتماد

سر التوقيعاختياري

يُستخدم للتحقق من صحة الـ webhook عبر توقيع HMAC-SHA256

ترويسات HTTPاختياري

إضافة ترويسات HTTP

ترويسات مخصصة لتضمينها مع طلبات webhook

مشفّر أثناء التخزينإلغاءاختبار الاتصالربط

إعطاء الحملة نقطة نهايتها

1. افتح الحملات، ثم الحملة وعلامة التبويب التكاملات الخاصة بها.
2. ضمن إضافة اتصال، ابحث عن Webhooks واختر اتصال. إذا ظهر على الزر إعداد، فهذا يعني أن الموصل لم يُربط بمساحة العمل بعد.
3. في الوجهة، أدخل العنوان الذي تُرسل إليه إجابات هذه الحملة.
4. اختر حفظ التغييرات.

تكامل

الاتصال مع Webhooks

المكان الذي تصل إليه إجابات هذه الحملة. الاتصال نفسه مشترك في مساحة العمل.

1 من 1 مطلوبة

الوجهة

الوجهةمطلوب

إلى أين تُرسل الإجابات المكتملة لهذا الاستبيان.

إلغاءحفظ التغييرات

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

نظرة عامةالمستلمونالردودالتكاملات

متصل بهذه الحملة

تُرسل كل إجابة جديدة إلى هذه الأدوات. أوقف إحداها دون فصلها.

Webhooksيرسل إلى https://acme.com/webhooks/polzy128 مُرسلة · منذ ساعتين

Notionيرسل إلى 1f3a5c7e9b2d4f60a8c1e3b5d7f9a2c441 مُرسلة · منذ 5 دقائق · فشل 1

إضافة اتصال

Google Sheetsتصدير الإجاباتاتصال

Zapierالأتمتةإعداد

ما تستقبله نقطة نهايتك

كل إجابة طلب POST بهذه الترويسات:

وهذا المتن بصيغة JSON:

تحمل الإجابة المجهولة ما قالته ودرجتها ويومها، ولا شيء يمكن أن يكشف صاحبها أو يحدد وقتها. وينتظر Polzy فحص السلامة لكل إجابة، لمدة تصل إلى 10 دقائق، قبل إرسالها؛ والإجابة المحجوبة لمراجعة السلامة تصل نصًا بديلًا. لا يحجب الحد الأدنى لحجم المجموعة الإجابات المفردة.

التحقق من التوقيع

1. اقرأ متن الطلب كما وصل تمامًا، قبل تحليله.
2. احسب HMAC-SHA256 له بسر التوقيع، مكتوبًا بالنظام الست عشري.
3. قارنه بـ X-Polzy-Signature باستخدام مقارنة بزمن ثابت. وإذا اختلفا، فارفض الطلب.

الطابع الزمني جزء من المتن، لذا فإن أي تغيير فيه يُبطل التوقيع أيضًا.

إرسال ويب هوك من سير عمل

1. افتح سير العمل ثم سير العمل المطلوب، أو أنشئ واحدًا جديدًا.
2. ضمن الموصلات في الخطوات المثبتة، اسحب إرسال ويب هوك · Webhooks إلى لوحة العمل.
3. في نقطة النهاية، أدخل العنوان الذي ترسل إليه هذه الخطوة.
4. في اسم الحدث، أبقِ workflow.step أو سمِّ الحدث الذي يتوقعه خادمك. يُرسل باسم X-Polzy-Event.
5. اترك الحمولة فارغة لإرسال كل ما يعرفه التشغيل، أو اكتب JSON الذي تريده، مع {{ لإدراج قيم من التشغيل.
6. اختر إرسال اختبار لإرسال طلب واحد مملوء بإجابة نموذجية.

إرسال ويب هوك · Webhooksإجراء موصل

الموصل

Webhooks

الإجراء

إرسال ويب هوك

التفاصيل

نقطة النهايةمطلوب

الوجهة التي ترسل إليها هذه الخطوة. موقّعة من هذا الاتصال، ولا تُرسَل ترويساته إلا إلى مضيف يرسل إليه الاتصال نفسه.

اسم الحدث

الحمولة

إذا تُرك فارغًا، يُرسل سياق التشغيل.

تربط Zapier وn8n وwebhooks حقولها من أول طلب تتلقاه. أرسل واحدًا الآن معبّأً بإجابة نموذجية.

إرسال اختبار

تُوقَّع الخطوة بسر الاتصال، وتمرّر رد خادمك باسم {{connector.statusCode}} و{{connector.response}}.

التحقق من أنه يعمل

في علامة التبويب التكاملات للحملة، يحتسب سطر النشاط الإجابات المرسلة وتلك التي فشلت. وتعرض صفحة الموصل كل عملية إرسال ضمن النشاط، مع نجح أو فشل والسبب.

الحالة

متصل

آخر مزامنة

منذ 5 دقائق

الأحداث · 7 أيام

312

الأخطاء

2

النشاط

الحدثالنتيجةالتفاصيلالوقت

تم إرسال الردنجح31 أكتوبر، 09:12

تم إرسال الردفشلUnable to parse range: Responses!1:131 أكتوبر، 08:47

نجح اختبار الاتصالنجحConnected as ana@acme.com30 أكتوبر، 16:05

حل المشكلات

ضمن النشاط، تظهر عملية الإرسال الفاشلة بعبارة Webhook failed: متبوعة بالسبب؛ ويعرض تشغيل سير العمل السبب نفسه دون هذه البادئة.

• Webhook failed: only https endpoints are allowed. يجب أن تبدأ نقطة النهاية بـ https://.
• Webhook failed: private addresses are not allowed. يشير العنوان إلى شبكة خاصة، مثل localhost أو 10.0.0.5. استخدم عنوانًا يمكن الوصول إليه من الإنترنت.
• Webhook failed: that host could not be found. الاسم الوارد في العنوان غير موجود. تحقق من كتابته.
• Webhook failed: متبوعة بحالة مثل 500، أو timeout of 10000ms exceeded. ردّت نقطة نهايتك بخطأ، أو استغرقت أكثر من 10 ثوانٍ. أي رد غير 2xx يُعد فاشلًا، ويُعاد الإرسال ثلاث مرات إجمالًا.
• No endpoint for this survey. Set one on its Integrations tab. لا توجد نقطة نهاية للحملة. أضِف واحدة عبر تعديل الإعداد في علامة التبويب التكاملات للحملة.
• لا يتطابق التوقيع. احسبه على المتن الخام، قبل أي تحليل، بالسر الذي أدخلته. وإذا أُنشئ السر لك، فأدخل سرّك الخاص.
• لا تصل الترويسة الخاصة بك. راجع ما يلي: لا تذهب الترويسات إلا إلى مضيف يرسل إليه الاتصال نفسه.

معلومات مفيدة

• إلى أين تذهب ترويسات HTTP؟ إلى مضيف يرسل إليه الاتصال نفسه فقط. نقطة النهاية التي تختارها حملة أو خطوة على مضيف آخر تُستدعى دونها، فلا تصل قيمة Authorization المحفوظة أبدًا إلى عنوان لم تكن مخصصة له. اعتمد على التوقيع لتمييز طلبات Polzy عن غيرها.
• هل تُرسل الإجابات غير المكتملة؟ لا. تُرسل الإجابات المكتملة فقط، مرة واحدة لكل منها.
• هل يمكن لنقطة نهايتي أن ترد ببيانات؟ في خطوة سير العمل، نعم: يُحفظ الرد باسم {{connector.response}} للخطوات اللاحقة. أما في إجابات الحملة فلا يُعتد إلا بحالة الرد.