مواد پر جائیں
FormFlow

ویب ہک کے ذریعے سبمشنز Slack پر بھیجیں

فارم کے «ترسیل» ٹیب میں ویب ہک اینڈ پوائنٹ شامل کریں، Slack پیغام کی شکل منتخب کریں اور اپنا ان کمنگ ویب ہک ایڈریس پیسٹ کریں۔ یہ پے لوڈ کی شکل ہے، Slack کا نیٹو انضمام نہیں۔

یہ مضمون مشین کے ذریعے ترجمہ کیا گیا ہے۔ انگریزی میں اصل مضمون پڑھیں

A dark plate titled 'Send Submissions to Slack through a webhook', listing a webhook endpoint on the Delivery tab, a Slack-shaped message payload, and a receiver address you own.

جب بھی کسی فارم کو سبمشن ملتا ہے، FormFlow Slack پر ایک مختصر پیغام پوسٹ کر سکتا ہے۔ وہ یہ ویب ہک اینڈ پوائنٹ کے ذریعے کرتا ہے، یعنی اسی طریقے سے جو سبمشنز کو آپ کے کسی بھی URL پر آگے بھیجتا ہے۔ یہ Slack کا نیٹو انضمام نہیں ہے: انسٹال کرنے کے لیے کوئی Slack ایپ نہیں، Slack سے سائن اِن نہیں، اور چینل منتخب کرنے کی سہولت نہیں۔ آپ FormFlow کو ایک ان کمنگ ویب ہک ایڈریس دیتے ہیں، اور FormFlow اس پر Slack کی شکل کا پیغام بھیجتا ہے۔ یہ ٹیوٹوریل اسے ترتیب دینے کے مراحل بتاتا ہے اور صاف کہتا ہے کہ پیغام میں کیا ہوتا ہے اور کیا نہیں۔

پہلے آپ کو کیا چاہیے

  • آپ کی ٹیم کا ایک فارم جسے آپ ایڈٹ کر سکتے ہوں۔

  • آپ کی ملکیت والا ان کمنگ ویب ہک ایڈریس: آپ کے Slack ورک اسپیس کا ان کمنگ ویب ہک URL، یا آپ کے کسی بھی اینڈ پوائنٹ کا ایڈریس جو Slack کے پیغام کی شکل قبول کرتا ہو۔ اسے Slack کی اپنی دستاویزات پر عمل کر کے Slack میں بنائیں؛ یہ تحریر اس پہلو کا احاطہ نہیں کرتی۔

  • ایک https ایڈریس۔ FormFlow ویب ہک اینڈ پوائنٹس کے لیے سادہ http مسترد کرتا ہے۔

اینڈ پوائنٹ شامل کریں

  1. فارم کھولیں اور اس کے «ترسیل» ٹیب پر جائیں۔

  2. «ویب ہک اینڈ پوائنٹس» تلاش کریں اور «اینڈ پوائنٹ شامل کریں» منتخب کریں۔

  3. «بطور بھیجیں» نامی فیلڈ میں «Slack پیغام» منتخب کریں۔ ڈیفالٹ «FormFlow JSON (دستخط شدہ)» ہے، اس لیے یہی تبدیلی Slack اینڈ پوائنٹ اور سادہ ویب ہک کے درمیان پورا فرق ہے۔

  4. URL فیلڈ کا نام اب «ان کمنگ ویب ہک URL» ہے۔ اپنا ایڈریس اس میں پیسٹ کریں۔ ٹائپ کرتے وقت فیلڈ چھپا رہتا ہے، اور جو پیسٹ کیا ہے اسے جانچنے کے لیے آپ اسے ظاہر کر سکتے ہیں۔

  5. «ترسیل جاری ہے» کو چالو رہنے دیں۔ یہ ڈیفالٹ طور پر چالو ہوتا ہے؛ اس اینڈ پوائنٹ پر ترسیل روکنے کے لیے اسے بند کریں۔

  6. فارم محفوظ کریں۔

«بطور بھیجیں» کے نیچے کا معاون متن بتاتا ہے کہ ایڈریس خفیہ شدہ شکل میں محفوظ ہوتا ہے اور ای میل کے ذریعے کبھی واپس نہیں بھیجا جاتا۔ اینڈ پوائنٹ کی سمٹی ہوئی قطار ایڈریس چھاپنے کے بجائے شکل کا نام بتاتی ہے، تاکہ URL پورے صفحے پر سادہ متن میں نہ پڑا رہے۔

ٹیسٹ بھیجیں

ہر اینڈ پوائنٹ کی قطار میں «ٹیسٹ بھیجیں» کارروائی ہے۔ یہ قطار کے ایڈریس پر ایک ہی سطر پوسٹ کرتی ہے، «FormFlow test — submissions from this form will arrive here.» کامیاب ہو تو آپ کو «ٹیسٹ پہنچا دیا گیا» نظر آتا ہے؛ ناکام ہو تو «ٹیسٹ کی ترسیل ناکام ہو گئی» نظر آتا ہے، ساتھ وصول کنندہ کا اپنا خرابی کا متن، جو 300 حروف پر کاٹ دیا جاتا ہے۔

دو شرطیں لاگو ہوتی ہیں۔ پہلے فارم محفوظ کریں: جو اینڈ پوائنٹ کبھی محفوظ نہیں ہوا اس کا ٹیسٹ نہیں ہو سکتا، اور کارروائی آپ کو یہ بتا دیتی ہے۔ اور ہر شخص ایک گھنٹے میں 20 ٹیسٹ ترسیلات بھیج سکتا ہے، ناکام ہونے والی سمیت۔ ٹیسٹ ایک بٹن ہے، کوئی دروازہ نہیں؛ آپ نے اسے دبایا ہو یا نہیں، اینڈ پوائنٹ ترسیل کرتا ہے۔

چینل میں کیا پہنچتا ہے

پیغام دروازے کی گھنٹی ہے، ریکارڈ نہیں۔ اس میں یہ ہوتا ہے:

  • بولڈ میں پہلی سطر: «New submission — » اور اس کے بعد فارم کا نام۔

  • زیادہ سے زیادہ پانچ جوابات، ہر سطر میں ایک، ہر ایک بولڈ لیبل اور ایک قدر کی شکل میں۔ قدر 200 حروف پر کاٹ دی جاتی ہے۔

  • ایک سطر جو بتاتی ہے کہ مزید کتنے فیلڈز ہیں، جب فارم میں پانچ سے زیادہ ہوں۔

  • آپ کے ڈیش بورڈ میں سبمشن کا «View submission» لنک۔

قدر کے اندر کی خالی جگہیں سمیٹ دی جاتی ہیں، اس لیے قدر صرف ایک سطر کی ہی ہو سکتی ہے۔ حروف &، < اور > کو ایسکیپ کیا جاتا ہے تاکہ Slack فارم بھرنے والے کے متن کو مارک اپ نہ سمجھے، اور قدر میں ستارے (*) کو ملتے جلتے حرف سے بدل دیا جاتا ہے تاکہ فارم بھرنے والا بولڈ لیبل کی نقل نہ کر سکے۔ پیغام صرف سادہ متن ہے؛ یہ Slack کا Block Kit استعمال نہیں کرتا۔

جاننے کے لائق حدود

  • یک طرفہ۔ FormFlow بھیجتا ہے؛ Slack میں کچھ بھی FormFlow کی طرف واپس نہیں آتا۔

  • زیادہ سے زیادہ پانچ جوابات، ہر ایک 200 حروف کا۔ پورا سبمشن دیکھنے کے لیے لنک یا سبمشنز ان باکس استعمال کریں۔

  • Slack دستخط کو نظرانداز کرتا ہے۔ ہر ویب ہک شکل پر دستخط ہوتے ہیں، لیکن Slack دستخط والا ہیڈر چھوڑ دیتا ہے، اس لیے Slack اینڈ پوائنٹ کے لیے نقل کرنے کے لائق کوئی دستخطی راز نہیں۔

  • جن سبمشنز کو FormFlow سپیم قرار دیتا ہے انہیں آگے نہیں بھیجا جاتا۔ صرف قبول شدہ، غیر سپیم سبمشنز ہی ویب ہک اینڈ پوائنٹ تک پہنچتے ہیں۔

  • دوبارہ کوششیں، بیک آف اور غیر فعال کرنا تمام ویب ہک شکلوں میں مشترک ہیں۔ جو وصول کنندہ مسلسل ناکام ہوتا رہے اس کا اینڈ پوائنٹ غیر فعال ہو سکتا ہے، اس لیے پیغامات آنا بند ہو جائیں تو قطار جانچیں۔

  • ایڈریس ایک اسناد (کریڈنشل) ہے۔ جس کے پاس بھی Slack ان کمنگ ویب ہک URL ہو وہ اس چینل میں پوسٹ کر سکتا ہے۔ اسے پاس ورڈ کی طرح سمجھیں، اور لیک ہونے پر Slack میں اسے بدل دیں۔

یہ کیا طے نہیں کرتا

یہ آپ کا چینل منتخب نہیں کرتا، اور آپ کے لیے Slack کا انتظام نہیں کرتا: آپ جو ایڈریس پیسٹ کرتے ہیں وہی طے کرتا ہے کہ پیغامات کہاں پہنچیں، اور وہ Slack میں ترتیب دیا جاتا ہے۔ یہ Slack کو آپ کا ان باکس نہیں بنا دیتا؛ سبمشنز پڑھنا، تلاش کرنا اور ایکسپورٹ کرنا FormFlow میں ہی رہتا ہے۔ اور یہ Slack پیغام کو ڈیٹا کی نقل نہیں بناتا۔ اگر آپ کو ہر فیلڈ ساختہ ڈیٹا کی صورت میں چاہیے تو اس کے بجائے ڈیفالٹ FormFlow JSON شکل والا دوسرا اینڈ پوائنٹ شامل کریں۔