Skip to main content
این صفحه مفهوم Webhook را از پایه توضیح می‌دهد و شما را قدم‌به‌قدم تا ساخت و تست اولین وب‌هوک در دیدار همراهی می‌کند. اگر تا امروز با Webhook کار نکرده‌اید یا با اصطلاحات دیدار آشنا نیستید، همین‌جا شروع کنید.

​
وب‌هوک چیست؟

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

​
وب‌هوک در دیدار چگونه کار می‌کند؟

فرآیند وب‌هوک در دیدار از چهار مرحله ساده تشکیل شده است:
  1. یک رویداد در دیدار اتفاق می‌افتد؛ مثلاً یک معامله جدید ایجاد می‌شود.
  2. دیدار وب‌هوک‌های تعریف‌شده برای آن رویداد را پیدا می‌کند.
  3. اطلاعات مربوط به همان رویداد به آدرس مقصد ارسال می‌شود.
  4. سیستم مقصد این اطلاعات را دریافت و پردازش می‌کند.

​
وب‌هوک چه کاربردی دارد؟

وب‌هوک در دیدار معمولاً برای اتصال دیدار به سیستم‌های دیگر استفاده می‌شود. چند نمونه کاربرد رایج:
  • ارسال اطلاعات یک معامله جدید به یک سیستم داخلی برای پردازش بیشتر.
  • شروع یک Workflow در n8n بلافاصله پس از ایجاد معامله.
  • اطلاع‌رسانی به تیم فروش یا پشتیبانی پس از ایجاد یک فعالیت یا کارت.
  • همگام‌سازی اشخاص، شرکت‌ها یا محصولات دیدار با نرم‌افزار دیگری که تیم شما از آن استفاده می‌کند.
  • ارسال اطلاعات فاکتور یا پرداخت به سیستم مالی یا حسابداری.
  • اجرای یک عملیات خودکار بلافاصله پس از ویرایش یک رکورد در دیدار.
این‌ها نمونه‌های رایج استفاده هستند، نه قابلیت‌های آماده یا تضمین‌شده‌ی دیدار؛ پیاده‌سازی هر سناریو بر عهده‌ی شماست.

​
وب‌هوک‌های موجود در دیدار

برای هر یک از موجودیت‌های زیر، هر دو رویداد «ایجاد» و «ویرایش» در دیدار قابل استفاده هستند.

​
پیش‌نیازها

برای ساخت وب‌هوک در دیدار به موارد زیر نیاز دارید:
  • دسترسی اکانت مدیر؛ کاربران عادی امکان مدیریت وب‌هوک را ندارند.
  • یک آدرس مقصد آماده که قرار است اطلاعات را دریافت کند.
  • برای تست اولیه، می‌توانید به‌جای آدرس واقعی از webhook.site استفاده کنید.

​
ساخت اولین وب‌هوک در دیدار

مسیر دسترسی به بخش وب‌هوک در دیدار:
برای ساخت یک وب‌هوک جدید:
  1. وارد تب «وب‌هوک» شوید.
  2. روی دکمه «ایجاد وب‌هوک جدید» کلیک کنید.
  3. نوع رویداد را انتخاب کنید: ایجاد یا ویرایش.
  4. نوع موجودیت را مشخص کنید؛ مثلاً معامله، شخص، شرکت، محصول یا فعالیت.
  5. یک عنوان قابل‌تشخیص برای وب‌هوک وارد کنید.
  6. آدرس مقصد را وارد کنید.
  7. روی دکمه «ذخیره» کلیک کنید.

​
فیلدهای فرم ایجاد وب‌هوک

​
نوع

مشخص می‌کند وب‌هوک هنگام ایجاد رکورد فعال شود یا هنگام ویرایش آن.

​
نوع موجودیت

مشخص می‌کند وب‌هوک تغییرات مربوط به کدام موجودیت دیدار را دنبال کند؛ برای مثال معامله، فعالیت، شخص یا محصول.

​
عنوان

نامی داخلی برای تشخیص وب‌هوک در فهرست وب‌هوک‌های دیدار است. عنوانی انتخاب کنید که رویداد و مقصد را مشخص کند؛ برای مثال «ارسال معاملات جدید به سیستم حسابداری».

​
آدرس مقصد

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

​
تست وب‌هوک با webhook.site

پیش از اتصال به سیستم واقعی، بهتر است با webhook.site ارسال اطلاعات را تست کنید:
  1. وارد سایت webhook.site شوید.
  2. آدرس اختصاصی نمایش‌داده‌شده در آن سایت را کپی کنید.
  3. در دیدار یک وب‌هوک آزمایشی با این مشخصات بسازید:
    • نوع: ایجاد
    • نوع موجودیت: معامله
    • عنوان: تست ایجاد معامله
    • آدرس مقصد: آدرس دریافت‌شده از webhook.site
  4. وب‌هوک را ذخیره کنید.
  5. در دیدار یک معامله آزمایشی ایجاد کنید.
  6. به webhook.site برگردید و بررسی کنید که آیا درخواست دیدار دریافت شده است یا خیر.
این روش فقط برای تست اولیه ارسال اطلاعات است. از آدرس webhook.site به‌عنوان مقصد نهایی وب‌هوک‌های واقعی استفاده نکنید.

​
قدم بعدی

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