این راهنما نحوه‌ی اتصال Zabbix به پیام‌رسان تلگرام را از طریق Bot API تلگرام و قابلیت Webhook در Zabbix توضیح می‌دهد.
امکانات پشتیبانی‌شده
ارسال اعلان به کاربران به‌صورت فردی یا گروهی
پشتیبانی از قالب‌بندی متن با Markdown یا HTML
پیش‌نیازها
نسخه‌ی Zabbix: ۷.۲ یا بالاتر
پارامترها
پس از وارد کردن وب‌هوک، می‌توانید تنظیمات آن را از طریق پارامترهای قابل پیکربندی انجام دهید.
پارامترهای قابل تنظیم
این پارامترها بسته به شرایط راه‌اندازی و ترجیحات کاربر قابل ویرایش هستند:
| نام پارامتر | مقدار | توضیح |
|---|---|---|
api_parse_mode | <PLACE PARSE MODE> | حالت قالب‌بندی پیام‌ها. مقادیر مجاز: markdown، html، markdownv2 |
api_token | <PLACE YOUR TOKEN> | توکن اختصاصی بات تلگرام برای دسترسی به API تلگرام |
پارامترهای داخلی (تغییر ندهید)
این پارامترها شامل مقادیر از پیش تعریف‌شده (ماکروها) هستند که در فرآیند ارسال پیام استفاده می‌شوند و نباید ویرایش شوند:
| نام پارامتر | مقدار | توضیح |
|---|---|---|
event_source | {EVENT.SOURCE} | نوع منبع رویداد (مثلاً Trigger یا Discovery). مقادیر ممکن: ۰ تا ۴ |
event_value | {EVENT.VALUE} | وضعیت رویداد (۱: مشکل، ۰: بهبودی) |
event_nseverity | {EVENT.NSEVERITY} | شدت رویداد به‌صورت عددی (۰: بی‌طبقه، ۵: فاجعه) |
event_severity | {EVENT.SEVERITY} | شدت رویداد به‌صورت متنی (مثلاً: High، Warning و …) |
event_update_nseverity | {EVENT.UPDATE.NSEVERITY} | شدت به‌روزرسانی رویداد (عددی) |
event_update_severity | {EVENT.UPDATE.SEVERITY} | شدت به‌روزرسانی رویداد (متنی) |
event_update_status | {EVENT.UPDATE.STATUS} | وضعیت به‌روزرسانی (۰: رویداد اصلی، ۱: به‌روزرسانی) |
alert_subject | {ALERT.SUBJECT} | موضوع پیش‌فرض از تنظیمات عملیات |
alert_message | {ALERT.MESSAGE} | پیام پیش‌فرض از تنظیمات عملیات |
event_tags | {EVENT.TAGSJSON} | برچسب‌های رویداد به‌صورت آرایه‌ی JSON |
api_chat_id | {ALERT.SENDTO} | شناسه‌ی چت گیرنده در تلگرام |
نکته مهم درباره پراکسی
اگر نیاز به استفاده از پراکسی HTTP دارید، یک پارامتر جدید به نوع رسانه (Media Type) با نام http_proxy اضافه کنید و مقدار آن را برابر با URL پراکسی قرار دهید.
مراحل ساخت بات تلگرام
۱. به @BotFather در تلگرام پیام دهید و دستور /newbot را ارسال کنید.
۲. طبق مراحل راهنما پیش بروید تا بات شما ساخته شود.
۳. در پایان، توکن اختصاصی بات نمایش داده می‌شود. این توکن برای تنظیم وب‌هوک در Zabbix مورد استفاده قرار می‌گیرد.
 از Zabbix به تلگرام){kind=link}
بدون نظر