أرسل الإرسالات إلى Slack عبر Webhook
أضف وجهة Webhook في تبويب التسليم بالنموذج، واختر صيغة رسالة Slack، والصق عنوان Webhook وارد تملكه. إنها صيغة حمولة وليست تكاملًا أصليًا مع Slack.
تُرجم هذا المقال آليًا. اقرأ النص الأصلي بالإنجليزية
يستطيع FormFlow نشر رسالة قصيرة في Slack كلما استقبل نموذج إرسالًا. ويفعل ذلك عبر وجهة Webhook، وهي الآلية نفسها التي تحوّل الإرسالات إلى أي رابط تملكه. هذا ليس تكاملًا أصليًا مع Slack: لا يوجد تطبيق Slack لتثبيته، ولا تسجيل دخول عبر Slack، ولا منتقي للقنوات. أنت تعطي FormFlow عنوان Webhook وارد، فيرسل إليه رسالة بصيغة Slack. يشرح هذا الدليل خطوات الإعداد ويقول بوضوح ما تحتويه الرسالة وما لا تحتويه.
ما تحتاج إليه أولًا
نموذج في فريقك يمكنك تعديله.
عنوان Webhook وارد تملكه: رابط Webhook الوارد من مساحة عمل Slack لديك، أو عنوان أي وجهة لديك تقبل صيغة رسائل Slack. أنشئه في Slack باتباع وثائق Slack نفسها؛ لا يغطي هذا المقال ذلك الجانب.
عنوان https. يرفض FormFlow صيغة http العادية لوجهات Webhook.
أضف الوجهة
افتح النموذج وانتقل إلى تبويب «التسليم».
ابحث عن «وجهات Webhook» واختر «إضافة وجهة».
في الحقل المسمى «الإرسال باسم» اختر «رسالة Slack». القيمة الافتراضية هي «FormFlow JSON (موقَّع)»، لذا فهذا التغيير هو الفرق كله بين وجهة Slack وWebhook عادي.
يصبح اسم حقل الرابط الآن «رابط Webhook الوارد». الصق عنوانك فيه. يُحجب الحقل أثناء الكتابة، ويمكنك إظهاره للتحقق مما لصقته.
اترك «جارٍ التسليم» مفعّلًا. وهو مفعّل افتراضيًا؛ أوقفه لإيقاف التسليم إلى هذه الوجهة.
احفظ النموذج.
يذكر النص المساعد تحت «الإرسال باسم» أن العنوان يُخزَّن مشفرًا ولا يُعاد إرساله بالبريد الإلكتروني أبدًا. أما الصف المطوي للوجهة فيذكر الصيغة بدلًا من طباعة العنوان، فلا يظهر الرابط نصًّا صريحًا في الصفحة.
أرسل اختبارًا
في كل صف وجهة إجراء «إرسال اختبار». ينشر سطرًا واحدًا، «FormFlow test — submissions from this form will arrive here.»، إلى العنوان الموجود في الصف. إن نجح ترى «تم تسليم الاختبار»؛ وإن فشل ترى «فشل تسليم الاختبار» مع نص الخطأ الذي يرجعه المستقبِل نفسه، مقطوعًا عند 300 حرف.
يسري شرطان. احفظ النموذج أولًا: لا يمكن اختبار وجهة لم تُحفظ قط، ويخبرك الإجراء بذلك. ويستطيع كل شخص إرسال 20 عملية تسليم اختبارية في الساعة، بما فيها الفاشلة. الاختبار زر لا بوابة؛ فالوجهة تسلّم الإرسالات سواء ضغطته أم لا.
ما الذي يصل إلى القناة
الرسالة جرس باب لا السجل. وهي تحتوي على:
سطر أول بخط عريض: «New submission — » متبوعًا باسم النموذج.
حتى خمس إجابات، واحدة في كل سطر، كل منها تسمية بخط عريض وقيمة. تُقطع القيمة عند 200 حرف.
سطر يذكر عدد الحقول الإضافية، حين يزيد عدد حقول النموذج على خمسة.
رابط «View submission» إلى الإرسال في لوحة التحكم.
تُدمج المسافات البيضاء داخل القيمة، فلا يمكن أن تكون القيمة إلا سطرًا واحدًا. وتُهرَّب الأحرف & و< و> حتى لا يقرأ Slack نص المُرسِل على أنه ترميز، ويُستبدل أي نجمة في القيمة بحرف مشابه لها حتى لا يستطيع المُرسِل تزوير تسمية بخط عريض. الرسالة نص عادي فقط؛ ولا تستخدم Block Kit الخاص بـ Slack.
حدود ينبغي معرفتها
باتجاه واحد. FormFlow يرسل؛ ولا شيء في Slack يعود إلى FormFlow.
خمس إجابات على الأكثر، وكل منها 200 حرف. للحصول على الإرسال كاملًا، استخدم الرابط أو صندوق الإرسالات.
Slack يتجاهل التوقيع. كل صيغ Webhook موقَّعة، لكن Slack يتجاهل ترويسة التوقيع، فلا يوجد سرّ توقيع تنسخه لوجهة Slack.
الإرسالات التي يصنّفها FormFlow إزعاجًا لا تُحوَّل. لا يصل إلى وجهة Webhook إلا الإرسالات المقبولة وغير المصنّفة إزعاجًا.
إعادة المحاولة والتراجع الزمني والتعطيل مشتركة بين كل صيغ Webhook. قد تُعطَّل وجهة المستقبِل الذي يفشل باستمرار، فتحقق من الصف إذا توقفت الرسائل عن الوصول.
العنوان بيانات اعتماد. أي شخص يحمل رابط Slack incoming webhook يستطيع النشر في تلك القناة. عامله كما تعامل كلمة المرور، واستبدله في Slack إن تسرّب.
ما لا يحسمه هذا
لا يختار قناتك، ولا يدير Slack نيابةً عنك: العنوان الذي تلصقه يحدد أين تصل الرسائل، وهذا يُضبط في Slack. ولا يحوّل Slack إلى صندوق وارد لك؛ فقراءة الإرسالات والبحث فيها وتصديرها تبقى في FormFlow. ولا يجعل رسالة Slack نسخة من البيانات. وإن احتجت إلى تسليم كل حقل كبيانات منظّمة، فأضف وجهة ثانية بصيغة FormFlow JSON الافتراضية.