راهنمای ساخت Webhook در واچ‌لاگ (Watchlog) + نمونه‌های کاربردی با تلگرام و SMS

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

🧩 Webhook چیست و چه کاربردی دارد؟

Webhook در واقع یک URL از پیش تعریف‌شده است که واچ‌لاگ در زمان وقوع یک هشدار (مثلاً افزایش مصرف CPU یا ثبت خطا در متریک دلخواه) به آن درخواست POST یا GET ارسال می‌کند.

شما می‌توانید این درخواست را به:

• سرویس‌های پیامک (مثل کاوه‌نگار)
• ربات تلگرام
• سیستم‌های داخلی یا CRM خودتان
• و هر ابزار تحت وب دیگر

ارسال کنید.

🛠️ مراحل ساخت Webhook در واچ‌لاگ

1. وارد داشبورد واچ‌لاگ شوید.
2. به بخش Webhook در قسمت تنظیمات هشدار بروید.
3. روی گزینه Create New Webhook کلیک کنید.
4. فرم ایجاد Webhook را مطابق تصویر زیر تکمیل کنید:

• Name: نام دلخواه برای وب‌هوک (مثلاً telegram-alert یا sms-kavenegar)
• URL: آدرس کامل سرویس گیرنده (مثال‌ها پایین‌تر)
• Payload: ساختار داده‌ای که به سیستم مقصد ارسال می‌شود. می‌توانید از متغیرهای زیر استفاده کنید:

متغیرتوضیح

$EVENT_MSG پیام اصلی هشدار

$EVENT_TITLE عنوان رویداد

$DATE زمان هشدار

$ID شناسه متریک

$ERROR_MSG توضیح خطا (در صورت وجود)

• Custom Header (اختیاری): اگر سرویس شما نیاز به header خاص مثل API Key دارد.

📱 نمونه اول: ارسال پیام هشدار از طریق کاوه‌نگار (SMS)

برای اینکه هنگام هشدار، یک SMS دریافت کنید، کافیست URL کاوه‌نگار را به این شکل وارد کنید:

https://api.kavenegar.com/v1/

🔹 به‌جای شماره تلفن می‌توانید هر شماره‌ای را جایگزین کنید.

🔹 می‌توانید چند وب‌هوک برای شماره‌های مختلف بسازید.

💬 نمونه دوم: ارسال پیام هشدار به ربات تلگرام

اگر کانال یا گروه تلگرام دارید، با ساخت یک Bot می‌توانید پیام هشدار را در لحظه دریافت کنید:

https://api.telegram.org/bot

🧪 نمونه سوم: اتصال به سرویس شخصی یا نرم‌افزار دیگر

فرض کنید یک سیستم ERP یا یک اپ پیام‌رسان داخلی دارید که درخواست POST با JSON دریافت می‌کند. مثلاً:

URL: https://yourproduct.com/webhook/alert

Payload:
{
  "title": "$EVENT_TITLE",
  "message": "$EVENT_MSG",
  "status": "triggered",
  "time": "$DATE"
}

در این حالت، واچ‌لاگ به‌محض وقوع هشدار، پیام را به سرویس شما ارسال می‌کند و سیستم شما می‌تواند واکنش خودکار نشان دهد.

✅ جمع‌بندی

Webhook یکی از قدرتمندترین ابزارهای اتوماسیون در واچ‌لاگ است.

چه بخواهید به هم‌تیمی‌تان پیام بدهید، چه به مدیر پروژه اطلاع‌رسانی کنید، چه یک سیستم هشدار داخلی بسازید — همه‌ی این‌ها را می‌توانید با چند کلیک انجام دهید.