وب هوک چیست و چطور اتوماسیون را زنده می‌کند

وب هوک چیست و چرا هر کسی که سراغ اتوماسیون می‌رود، خیلی زود به این کلمه برمی‌خورد؟ جواب کوتاه این است: وب‌هوک (Webhook) روشی است که یک سرویس با آن به سرویس دیگر خبر می‌دهد اتفاقی افتاده. بدون آن، سیستم شما باید مدام بپرسد «چیزی جدید هست؟» و با آن، خودِ خبر به سراغتان می‌آید. همین یک تفاوت، مرز بین اتوماسیون کند و اتوماسیون لحظه‌ای است.

اگر تازه با ابزارهای اتوماسیون آشنا شده‌اید، خواندن n8n چیست قبل از این مقاله کمک می‌کند، چون مثال‌های اینجا داخل همان فضا معنا پیدا می‌کنند.

وب هوک چیست به زبان ساده

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

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

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

نکته‌ی مهم این است که سمت شما باید همیشه آماده‌ی دریافت باشد. آدرس وب‌هوک مثل یک صندوق پستی است که باید باز و در دسترس بماند. به همین دلیل است که ابزارهای اتوماسیون این آدرس را برایتان می‌سازند و شما فقط کپی‌اش می‌کنید.

چه فرقی با API دارد

این پرسشی است که تقریباً همه در ابتدا می‌پرسند و جوابش ساده است: جهت.

وقتی از API استفاده می‌کنید، شما هستید که سؤال می‌پرسید. می‌گویید «لیست سفارش‌های امروز را بده» و جواب می‌گیرید. کنترل دست شماست ولی باید بدانید کِی بپرسید. وقتی وب‌هوک دارید، سرویس مقابل است که حرف می‌زند. شما فقط منتظر می‌مانید و هر وقت اتفاقی افتاد، خبردار می‌شوید.

در عمل، بیشتر سیستم‌های خوب هر دو را کنار هم دارند. وب‌هوک خبر می‌دهد که «سفارش جدیدی ثبت شد» و بعد شما با API جزئیات کامل آن سفارش را می‌گیرید. برای درک بخش دوم، آموزش کار با API برای مبتدی را ببینید.

آموزش وب هوک در n8n قدم‌به‌قدم

در n8n، وب‌هوک یک نود آماده است و ساختنش چند دقیقه طول می‌کشد.

قدم اول. یک ورک‌فلوی جدید بسازید و نود Webhook را به‌عنوان تریگر اضافه کنید. n8n برای این نود دو آدرس می‌سازد: آدرس تست و آدرس اصلی.

قدم دوم. آدرس تست را در سرویس مقابل (مثلاً فرم سایت) وارد کنید و در n8n روی «Listen for Test Event» بزنید. حالا یک بار فرم را پر کنید. اطلاعاتی که رسیده همان‌جا در ویرایشگر نشان داده می‌شود و می‌بینید دقیقاً چه فیلدهایی دارید.

قدم سوم. نودهای بعدی را اضافه کنید؛ مثلاً یک نود هوش مصنوعی که پیام را خلاصه کند و یک نود تلگرام که خلاصه را بفرستد.

قدم چهارم. وقتی همه‌چیز درست کار کرد، ورک‌فلو را فعال کنید و در سرویس مقابل آدرس تست را با آدرس اصلی عوض کنید. از این به بعد اجراها دیگر در ویرایشگر دیده نمی‌شوند و باید در بخش Executions نگاهشان کنید.

جزئیات کامل این نود، از جمله روش‌های امن‌سازی مثل Basic auth و Header auth، در مستندات رسمی نود Webhook در n8n آمده است. اگر می‌خواهید جواب سفارشی به فرستنده برگردانید، نود Respond to Webhook را هم ببینید.

چهار کاربرد واقعی که همین امروز می‌شود ساخت

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

پرداخت موفق. درگاه پرداخت خبر می‌دهد، سیستم شما فاکتور می‌سازد، دسترسی مشتری را باز می‌کند و پیام خوش‌آمد می‌فرستد. کل این زنجیره در چند ثانیه و بدون دخالت آدم.

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

ثبت‌نام کاربر جدید. کاربر ثبت‌نام می‌کند، اطلاعاتش وارد سیستم مدیریت مشتری می‌شود، و یک زنجیره‌ی خوش‌آمدگویی چندروزه شروع می‌شود.

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

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

با همه‌ی این‌ها، وب‌هوک برای هر کاری مناسب نیست و دانستن مرزش به‌اندازه‌ی دانستن کاربردش مهم است.

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

اگر سرویس مقابل اصلاً وب‌هوک ارائه نمی‌دهد، انتخابی ندارید و باید دوره‌ای بپرسید. خیلی از سرویس‌های قدیمی‌تر همین وضع را دارند.

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

سه نکته که نادیده گرفتنشان دردسر می‌سازد

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

هر پیام ممکن است دو بار بیاید. بیشتر سرویس‌ها اگر جواب درست نگیرند، دوباره می‌فرستند. اگر ورک‌فلوی شما به‌ازای هر پیام یک فاکتور بسازد، ممکن است روزی دو فاکتور تکراری بسازد. راه‌حل ساده: شناسه‌ی هر رویداد را ذخیره کنید و تکراری‌ها را رد کنید.

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

اگر می‌خواهید این اتصال‌ها برای کسب‌وکارتان درست و امن چیده شود، می‌توانید درخواست مشاوره بدهید.

مقالات مرتبط

حالا که می‌دانید وب هوک چیست، این مقاله‌ها بقیه‌ی قطعه‌های یک اتوماسیون کامل را نشان می‌دهند:

• n8n چیست و چطور کارهای تکراری را حذف می‌کند؟
• آموزش کار با API برای مبتدی، از صفر تا اولین اتصال
• آموزش n8n فارسی برای کسی که برنامه‌نویس نیست
• MCP چیست و چطور کلاد را به ابزارهای شما وصل می‌کند

سوالات متداول

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

نه. ابزارهای اتوماسیون مثل n8n یک نود آماده دارند که آدرس را برایتان می‌سازد. کار شما فقط کپی کردن آن آدرس در تنظیمات سرویس مقابل است.

فرق آدرس تست و آدرس اصلی وب‌هوک در n8n چیست؟

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

اگر سرویس من خاموش باشد و پیام بیاید چه می‌شود؟

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

چطور تست کنم که وب‌هوکم درست کار می‌کند؟

ورک‌فلو را در حالت تست بگذارید و یک بار خودتان آن اتفاق را ایجاد کنید؛ مثلاً فرم را پر کنید. بعد خروجی نود اول را نگاه کنید تا ببینید دقیقاً چه اطلاعاتی رسیده است.

برای شروع، وب‌هوک بهتر است یا زمان‌بندی؟

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

قدم بعدی

در فصل سوم دوره‌ی سفر هوش مصنوعی همین مفهوم را روی یک پروژه‌ی واقعی پیاده می‌کنیم؛ از ساختن آدرس تا امن کردنش و وصل کردن هوش مصنوعی به آن سرِ زنجیره.

اگر می‌خواهید ببینید ساختن با هوش مصنوعی در عمل چه شکلی دارد، ویدیوی کامل آموزش کلاد (Claude) را تماشا کنید؛ نزدیک یک ساعت، قدم‌به‌قدم.

نکته‌های کوتاه‌تر هم در کانال یوتیوب منتشر می‌شود.