إرسال الإجابات إلى Zapier
شغّل Zap مع كل إجابة تتلقاها حملة، أو من خطوة في سير عمل، ومرّرها إلى آلاف التطبيقات الأخرى. اربط Zapier مرة واحدة، ثم أعطِ كل حملة رابط catch hook الخاص بالـ Zap.
في هذه الصفحة
ينقل Zapier ما يحدث في تطبيق إلى آلاف التطبيقات الأخرى. عند ربط Zapier، تشغّل كل إجابة تتلقاها حملة أحد الـ Zaps الخاصة بك — لإضافة ملاحظة في نظام CRM، أو نشر رسالة، أو فتح تذكرة — ويمكن لسير العمل أيضًا تشغيل واحد. في نهاية هذا الدليل سيكون لديك Zap يستقبل إجاباتك، وستعرف بالضبط ما تحتويه كل إجابة.
يتوفر Zapier في خطة أعمال. لا يستطيع ربطه واختيار وجهة إجابات الحملة إلا المسؤول.
قبل أن تبدأ
تحتاج إلى:
- مساحة عمل على خطة أعمال، ودور مسؤول فيها.
- تفعيل التكاملات لمساحة العمل، من الإعدادات ← عام ← ما تقوم به مساحة العمل هذه.
- حساب Zapier على خطة تتضمن Webhooks by Zapier. يذكر Zapier الخطط في Zapier: Trigger Zaps from webhooks.
كيف يعمل
- يُربط مرة واحدة. يحتفظ اتصال Zapier في Polzy بسر اختياري يوقّع كل طلب. ولا يوجد تسجيل دخول إلى Zapier.
- Zap واحد لكل حملة. تحدد كل حملة رابط catch hook للـ Zap الذي تشغّله إجاباتها، فيمكن لحملتين تشغيل Zap مختلف لكل منهما.
- من سير عمل. تشغّل الخطوة الإرسال إلى Zapier أحد الـ Zaps بكل ما يعرفه التشغيل.
ربط Zapier بـ Polzy
- في الشريط الجانبي، ضمن الأتمتة، افتح التكاملات واختر علامة التبويب متاحة.
- ابحث عن Zapier واختر ربط.
- إذا أردت التحقق من أن الطلبات تأتي من Polzy، فأدخل قيمة عشوائية طويلة في المفتاح السري (اختياري). وإلا فاتركه فارغًا.
- اختر ربط. يرد الاختبار بـ Connected. Each survey and step names the Zap it starts.
إنشاء الـ Zap
- في Zapier، أنشئ Zap واختر مشغّله: التطبيق Webhooks by Zapier مع الحدث Catch Hook.
- انتقل إلى علامة التبويب Test الخاصة بالمشغّل وانسخ رابط الويب هوك. يبدأ بـ
https://hooks.zapier.com/hooks/catch/.
أبقِ الـ Zap مفتوحًا: فهو يتعلّم حقول الإجابة من أول طلب يستقبله.
إعطاء الحملة الـ Zap الخاص بها
- في Polzy، افتح الحملات، ثم الحملة وعلامة التبويب التكاملات الخاصة بها.
- ضمن إضافة اتصال، ابحث عن Zapier واختر اتصال. إذا ظهر على الزر إعداد، فهذا يعني أن Zapier لم يُربط بمساحة العمل بعد.
- الصق رابط الويب هوك في Catch hook الخاص بالـ Zap.
- اختر حفظ التغييرات.
- أجب عن استبيان الحملة مرة واحدة، أو انتظر أول إجابة.
- عُد إلى Zapier واختر Test trigger، ثم اختر الطلب الذي وصل. بعد ذلك أضِف إجراءات الـ Zap، وطابق الحقول، وانشره.
تعرض علامة التبويب التكاملات في الحملة بعدها Zapier ضمن متصل بهذه الحملة، مع مفتاحه، وتعديل الإعداد، وقطع الاتصال، وعدد الإجابات المرسلة.
ما يستقبله Zapier
تصل كل إجابة في طلب واحد بمتن JSON:
| الحقل | ما يحتويه |
|---|---|
event | دائمًا survey_response. |
timestamp | وقت إرسال الطلب. وفي الإجابة المجهولة، اليوم الذي قُدّمت فيه. |
survey.id, survey.title, survey.uniqueId | معرّف الاستبيان وعنوانه ورمزه القصير. |
response.id | معرّف الإجابة في Polzy. فارغ في الإجابة المجهولة. |
response.submittedAt | وقت إكمال الإجابة. وفي الإجابة المجهولة، اليوم فقط. |
response.answers | عنصر لكل سؤال أُجيب عنه، يحتوي كل منها على questionId وquestionText وvalue. |
response.score | الدرجة الإجمالية، إذا كانت قد حُسبت وقت إرسال الطلب. |
response.respondent | معرّف المجيب في Polzy. غير موجود في الإجابة المجهولة. |
مع المفتاح السري (اختياري)، يحمل كل طلب أيضًا الترويسة X-Zapier-Signature: وهي HMAC-SHA256 لمتن الطلب، محسوبة بسرّك ومكتوبة بالنظام الست عشري. لا يتحقق Catch Hook منها بنفسه؛ أما Catch Raw Hook في Zapier فيمرّر الترويسات، لخطوة لديك تستطيع ذلك.
تحمل الإجابة المجهولة ما قالته ودرجتها ويومها، ولا شيء يمكن أن يكشف صاحبها أو يحدد وقتها. وينتظر Polzy فحص السلامة لكل إجابة، لمدة تصل إلى 10 دقائق، قبل إرسالها. لا يحجب الحد الأدنى لحجم المجموعة الإجابات المفردة، فتصل كل إجابة إلى الـ Zap مهما قلّ عددها.
تشغيل Zap من سير عمل
- افتح سير العمل ثم سير العمل المطلوب، أو أنشئ واحدًا جديدًا.
- ضمن الموصلات في الخطوات المثبتة، اسحب الإرسال إلى Zapier · Zapier إلى لوحة العمل.
- الصق رابط الـ Zap في خطاف التقاط Zap. لكل Zap رابطه الخاص.
- اترك الحمولة فارغة لإرسال كل ما يعرفه التشغيل، أو اكتب JSON الذي تريده، مع
{{لإدراج قيم من التشغيل. - اختر إرسال اختبار. يرسل Polzy طلبًا واحدًا مملوءًا بإجابة نموذجية، ليتعلّم الـ Zap حقوله قبل أن يعمل سير العمل أصلًا.
تمرّر الخطوة رد Zapier باسم {{connector.statusCode}} و{{connector.response}}.
ليست لديك خطة أعمال؟ ترسل الخطوة ويب هوك صادر في سير العمل إلى أي عنوان، بما في ذلك رابط catch hook للـ Zap، دون ربط Zapier. يتوفر سير العمل في خطة فريق. راجع سير العمل.
التحقق من أنه يعمل
في علامة التبويب التكاملات للحملة، يحتسب سطر النشاط الإجابات المرسلة وتلك التي فشلت. وتعرض صفحة Zapier في Polzy كل عملية إرسال ضمن النشاط، مع نجح أو فشل والسبب. وفي Zapier، يعرض سجل الـ Zap كل تشغيل.
حل المشكلات
- لا يستقبل Zapier شيئًا. تحقق من مفتاح الحملة، ومن أن الإجابة قُدّمت عبر الحملة: فالإجابات عن الاستبيان خارجها لا تستخدم وجهات الحملة.
- only https endpoints are allowed. يجب أن يبدأ رابط catch hook بـ
https://. انسخه مجددًا من Zapier. - Request failed with status code متبوعًا برقم (ضمن النشاط). رفض Zapier الطلب — غالبًا لأن الـ Zap حُذف أو تغيّر رابطه. الصق الرابط الحالي عبر تعديل الإعداد.
- تنقص حقول في Zapier. تعلّم الـ Zap من طلب يحتوي على إجابات أقل. أرسل اختبارًا آخر واختر Test trigger مجددًا.
- وصلت الإجابة نفسها مرتين. الطلب الذي يستغرق Zapier أكثر من 10 ثوانٍ لقبوله يُعد فاشلًا ويُعاد، حتى ثلاث مرات إجمالًا.
الإجابات التي وصلت قبل حفظ رابط الـ Zap، أو أثناء إيقاف المفتاح، لا تُرسل لاحقًا. صدّرها بدلًا من ذلك من الردود في الاستبيان.
معلومات مفيدة
- هل يحتاج Polzy إلى كلمة مرور Zapier؟ لا. يكفيه رابط catch hook. تعامل معه ككلمة مرور: فمن يملكه يستطيع تشغيل الـ Zap.
- هل يمكن لإجابة واحدة تشغيل عدة Zaps؟ واحد لكل حملة عبر علامة التبويب التكاملات الخاصة بها. ويمكن لسير العمل تشغيل عدد منها يساوي عدد خطواته.
- هل يمكن لـ Zapier إرسال بيانات إلى Polzy؟ ليس عبر هذا الاتصال. لإدخال أشخاص أو أحداث، راجع الويب هوك ومفاتيح API.
روابط مفيدة
مقالات ذات صلة
يمكن للأعضاء المسجّلين سؤال Polzy أو مراسلة الفريق من صفحة الدعم. تعتمد سرعة ردّنا على خطتك.