وب هوک

وب هوک در وظایف گردش کار

برای ایجاد هر گردش کار، پس از تکمیل بخش‌های اطلاعات پایه، زمان اجرا و شرایط اجرای گردش کار، نوبت به بخش وظایف گردش کار می‌رسد.

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

یکی از آنها، استفاده از وب هوک است.

وب‌هوک ابزاری برای اتوماتیک‌سازی تبادل اطلاعات بین CRM24 و سایر سامانه‌هاست. به زبان ساده، وب‌هوک باعث می‌شود هرگاه رویدادی مشخص در CRM رخ دهد (مانند ثبت مشتری جدید، صدور فاکتور یا تغییر وضعیت یک سرنخ)، سیستم به صورت خودکار یک پیام حاوی اطلاعات مربوطه را به آدرس اینترنتی (URL) تعیین‌شده ارسال کند.

تفاوت وب‌هوک با API

• API: نیاز است کاربر یا یک سیستم دیگر به‌طور مستقیم آن را فراخوانی کرده و اطلاعات را دریافت یا ارسال کند.

• وب‌هوک: بدون نیاز به فراخوانی دستی، بلافاصله پس از وقوع رویداد، اطلاعات را به مقصد مورد نظر ارسال می‌کند (Push).

برای ایجاد یک گردش کار با وظیه وب هوک، ابتدا وارد گردش کارها شده و وب هوک را انتخاب میکنیم:

پس از انتخاب “وب هوک” پاپ اپ تنظیمات وب هوک برای شما باز میشود:

• عنوان وظیفه
  نامی برای وب‌هوک انتخاب کنید تا هدف آن مشخص باشد.

• توضیحات
  توضیحاتی برای درک بهتر کاربرد وب‌هوک وارد کنید. این بخش اختیاری است اما در مدیریت وب‌هوک‌ها بسیار کمک‌کننده خواهد بود.

• URL (الزامی)
  آدرس مقصدی که قرار است داده‌ها به آن ارسال شوند. این آدرس معمولاً مربوط به یک وب‌سرویس یا API است.

• Method (الزامی)
  نوع ارسال داده:

• POST: ارسال اطلاعات جدید به سامانه مقصد.

• PUT: به‌روزرسانی اطلاعات موجود در سامانه مقصد.

• Content Type (الزامی)
  قالب داده‌های ارسالی:

• FORM: داده‌ها به شکل فرم HTML ارسال می‌شوند.

• JSON: داده‌ها به‌صورت ساختار JSON ارسال می‌شوند (استاندارد و مناسب سیستم‌های حرفه‌ای).

• JSON Array: داده‌ها به‌صورت آرایه JSON ارسال می‌شوند (مناسب وقتی چندین رکورد به‌طور همزمان ارسال می‌شوند).

• XML: داده‌ها به فرمت XML ارسال می‌شوند (مناسب برخی سامانه‌ها یا وب‌سرویس‌های قدیمی).

• احراز هویت (Authentication)
  در صورتی که سامانه مقصد نیاز به احراز هویت داشته باشد، می‌توانید روش احراز هویت را انتخاب کنید (مانند ارسال توکن یا Basic Auth). در غیر این صورت روی حالت «بدون احراز هویت» قرار می‌گیرد.

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

  • نام (Key): نام پارامتر ارسالی.

  • مقدار (Value): مقدار پارامتر. این مقدار می‌تواند ثابت باشد (مانند operation=update) یا پویا و برگرفته از فیلدهای CRM (مانند نام مشتری، شماره تماس یا مبلغ فاکتور).