وب هوک چیست و چگونه از آن در ایپُل استفاده کنم؟

برای فعال کردن قابلیت وب هوک ابتدا لازم است تا از بخش طراحی پرسشنامه به صفحه “ارتباط با برنامه های دیگر” رفته و قابلیت وب هوک را فعال کنید

یکی دیگر از اقدامات برای استفاده از قابلیت وب هوک انتخاب کردن متد ارسال اطلاعات پاسخ ها به سامانه های دیگر است. متناسب با ساختار دیگر سامانه ها ممکن نیاز باشد تا درخواست ارسال اطلاعات متد مشخصی داشته باشد.

متد های HTTP قابل استفاده برای استفاده در قابلیت وب هوک شامل موارد زیر است:

• GET
• POST
• PUT
• PATCH
• DELETE
• COPY
• HEAD
• OPTIONS
• PURGE

با توجه به اینکه چه متدی را برای دریافت اطلاعات در وب سرویس مقصد نیاز دارید، یکی از متد های ذکر شده را از لیست انتخاب کنید

قدم بعدی برای استفاده از قابلیت وب هوک، مشخص کردن آدرس وب سرویس (سامانه‌ای) است که قرار است اطلاعات پاسخ های پرسشنامه به آن ارسال شود. تنها کافیست آدرس (URL) وب سرویس را در این قسمت قرار دهید

شما به دو صورت میتوانید اطلاعات پاسخ های پرسشنامه را به وب سرویس (سامانه) دیگر ارسال کنید.

• ارسال پاسخ تمامی سوالات یک پرسشنامه
• ارسال پاسخ برخی از سوالات مشخص پرسشنامه

ارسال پاسخ تمامی سوالات یک پرسشنامه

برای اینکه پاسخ تمامی سوالات پرسشنامه به وب سرویس یا سامانه مورد نظر ارسال شود کافیست تا قابلیت “وب هوک” را فعال کنید تا سامانه ایپُل به صورت خودکار پاسخ تمامی سوالات را با متد مشخص شده برای وب سرویس مورد نظر ارسال کند.

ارسال پاسخ برخی از سوالات مشخص پرسشنامه

گاهی ممکن است پاسخ تمامی سوالات را نیاز نداشته باشید و تنها نیاز به ارسال پاسخ سوالات مشخصی داشته باشید.

برای انجام این کار لازم است مقادیر (value) پاسخ سوالاتی را که می خواهید برای شما ارسال شود را مشخص نمایید. هر کدام از این مقادیر، باید تحت عنوان یک نام متغیر یا key مشخص شود.

به عنوان مثال اگر شناسه سوال شما Q1 باشد و در این سوال سن شخص پرسیده شده باشد، حال بخواهید سن شخص را با نام Age در سامانه خود دریافت کنید کافی است مطابق با ذیل عمل کنید:

Key = Age

Value = {{Q1}}

حال اگر پاسخ دهنده، عدد 35 را در این سوال ثبت کرده باشد، پیام زیر توسط شما دریافت خواهد شد

Age = 35

• شما می توانید این اطلاعات (پاسخ سوالات) را در هدر و یا بادی پیام خود ارسال کنید
• در صورتی که برای گزینه های سوالات گزینه ای کد مشخص کرده باشید، مقادیر سوالات گزینه ای به صورت کد گزینه ها توسط ایپُل به سامانه های دیگر ارسال میشود. به عنوان مثال اگر در سوال جنسیت برای گزینه مرد کد 30 و برای گزینه زن کد 31 را تنظیم کرده باشید، دیتای ارسال شده کاربری که گزینه زن را انتخاب کرده به جای متن “زن” (String)، عدد 31 (Number) را ارسال میکند
• مقادیر (پاسخ ها) سوالات تشریحی یا متنی به صورت متن (string) توسط ایپُل به سامانه های دیگر ارسال میشود.